1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2007, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 2, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING. If not, write --
19 -- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
20 -- Boston, MA 02110-1301, USA. --
22 -- As a special exception, if other files instantiate generics from this --
23 -- unit, or you link this unit with other files to produce an executable, --
24 -- this unit does not by itself cause the resulting executable to be --
25 -- covered by the GNU General Public License. This exception does not --
26 -- however invalidate any other reasons why the executable file might be --
27 -- covered by the GNU Public License. --
29 -- GNAT was originally developed by the GNAT team at New York University. --
30 -- Extensive contributions were provided by Ada Core Technologies Inc. --
32 ------------------------------------------------------------------------------
34 -- This package defines the structure of the abstract syntax tree. The Tree
35 -- package provides a basic tree structure. Sinfo describes how this structure
36 -- is used to represent the syntax of an Ada program.
38 -- The grammar in the RM is followed very closely in the tree
39 -- design, and is repeated as part of this source file.
41 -- The tree contains not only the full syntactic representation of the
42 -- program, but also the results of semantic analysis. In particular, the
43 -- nodes for defining identifiers, defining character literals and defining
44 -- operator symbols, collectively referred to as entities, represent what
45 -- would normally be regarded as the symbol table information. In addition a
46 -- number of the tree nodes contain semantic information.
48 -- WARNING: Several files are automatically generated from this package.
49 -- See below for details.
51 with Namet; use Namet;
52 with Types; use Types;
53 with Uintp; use Uintp;
54 with Urealp; use Urealp;
58 ---------------------------------
59 -- Making Changes to This File --
60 ---------------------------------
62 -- If changes are made to this file, a number of related steps must be
63 -- carried out to ensure consistency. First, if a field access function is
64 -- added, it appears in seven places:
66 -- The documentation associated with the node
67 -- The spec of the access function in sinfo.ads
68 -- The body of the access function in sinfo.adb
69 -- The pragma Inline at the end of sinfo.ads for the access function
70 -- The spec of the set procedure in sinfo.ads
71 -- The body of the set procedure in sinfo.adb
72 -- The pragma Inline at the end of sinfo.ads for the set procedure
74 -- The field chosen must be consistent in all places, and, for a node that
75 -- is a subexpression, must not overlap any of the standard expression
78 -- In addition, if any of the standard expression fields is changed, then
79 -- the utility program which creates the Treeprs spec (in file treeprs.ads)
80 -- must be updated appropriately, since it special cases expression fields.
82 -- If a new tree node is added, then the following changes are made
84 -- Add it to the documentation in the appropriate place
85 -- Add its fields to this documentation section
86 -- Define it in the appropriate classification in Node_Kind
87 -- In the body (sinfo), add entries to the access functions for all
88 -- its fields (except standard expression fields) to include the new
89 -- node in the checks.
90 -- Add an appropriate section to the case statement in sprint.adb
91 -- Add an appropriate section to the case statement in sem.adb
92 -- Add an appropriate section to the case statement in exp_util.adb
93 -- (Insert_Actions procedure)
94 -- For a subexpression, add an appropriate section to the case
95 -- statement in sem_eval.adb
96 -- For a subexpression, add an appropriate section to the case
97 -- statement in sem_res.adb
99 -- Finally, four utility programs must be run:
101 -- Run CSinfo to check that you have made the changes consistently. It
102 -- checks most of the rules given above, with clear error messages. This
103 -- utility reads sinfo.ads and sinfo.adb and generates a report to
106 -- Run XSinfo to create sinfo.h, the corresponding C header. This
107 -- utility reads sinfo.ads and generates sinfo.h. Note that it does
108 -- not need to read sinfo.adb, since the contents of the body are
109 -- algorithmically determinable from the spec.
111 -- Run XTreeprs to create treeprs.ads, an updated version of the module
112 -- that is used to drive the tree print routine. This utility reads (but
113 -- does not modify) treeprs.adt, the template that provides the basic
114 -- structure of the file, and then fills in the data from the comments
117 -- Run XNmake to create nmake.ads and nmake.adb, the package body and
118 -- spec of the Nmake package which contains functions for constructing
121 -- All of the above steps except CSinfo are done automatically by the
122 -- build scripts when you do a full bootstrap.
124 -- Note: sometime we could write a utility that actually generated the body
125 -- of sinfo from the spec instead of simply checking it, since, as noted
126 -- above, the contents of the body can be determined from the spec.
128 --------------------------------
129 -- Implicit Nodes in the Tree --
130 --------------------------------
132 -- Generally the structure of the tree very closely follows the grammar as
133 -- defined in the RM. However, certain nodes are omitted to save space and
134 -- simplify semantic processing. Two general classes of such omitted nodes
137 -- If the only possibilities for a non-terminal are one or more other
138 -- non-terminals (i.e. the rule is a "skinny" rule), then usually the
139 -- corresponding node is omitted from the tree, and the target construct
140 -- appears directly. For example, a real type definition is either
141 -- floating point definition or a fixed point definition. No explicit node
142 -- appears for real type definition. Instead either the floating point
143 -- definition or fixed point definition appears directly.
145 -- If a non-terminal corresponds to a list of some other non-terminal
146 -- (possibly with separating punctuation), then usually it is omitted from
147 -- the tree, and a list of components appears instead. For example,
148 -- sequence of statements does not appear explicitly in the tree. Instead
149 -- a list of statements appears directly.
151 -- Some additional cases of omitted nodes occur and are documented
152 -- individually. In particular, many nodes are omitted in the tree
153 -- generated for an expression.
155 -------------------------------------------
156 -- Handling of Defining Identifier Lists --
157 -------------------------------------------
159 -- In several declarative forms in the syntax, lists of defining
160 -- identifiers appear (object declarations, component declarations, number
161 -- declarations etc.)
163 -- The semantics of such statements are equivalent to a series of identical
164 -- declarations of single defining identifiers (except that conformance
165 -- checks require the same grouping of identifiers in the parameter case).
167 -- To simplify semantic processing, the parser breaks down such multiple
168 -- declaration cases into sequences of single declarations, duplicating
169 -- type and initialization information as required. The flags More_Ids and
170 -- Prev_Ids are used to record the original form of the source in the case
171 -- where the original source used a list of names, More_Ids being set on
172 -- all but the last name and Prev_Ids being set on all but the first name.
173 -- These flags are used to reconstruct the original source (e.g. in the
174 -- Sprint package), and also are included in the conformance checks, but
175 -- otherwise have no semantic significance.
177 -- Note: the reason that we use More_Ids and Prev_Ids rather than
178 -- First_Name and Last_Name flags is so that the flags are off in the
179 -- normal one identifier case, which minimizes tree print output.
181 -----------------------
182 -- Use of Node Lists --
183 -----------------------
185 -- With a few exceptions, if a construction of the form {non-terminal}
186 -- appears in the tree, lists are used in the corresponding tree node (see
187 -- package Nlists for handling of node lists). In this case a field of the
188 -- parent node points to a list of nodes for the non-terminal. The field
189 -- name for such fields has a plural name which always ends in "s". For
190 -- example, a case statement has a field Alternatives pointing to list of
191 -- case statement alternative nodes.
193 -- Only fields pointing to lists have names ending in "s", so generally the
194 -- structure is strongly typed, fields not ending in s point to single
195 -- nodes, and fields ending in s point to lists.
197 -- The following example shows how a traversal of a list is written. We
198 -- suppose here that Stmt points to a N_Case_Statement node which has a
199 -- list field called Alternatives:
201 -- Alt := First (Alternatives (Stmt));
202 -- while Present (Alt) loop
204 -- -- processing for case statement alternative Alt
206 -- Alt := Next (Alt);
209 -- The Present function tests for Empty, which in this case signals the end
210 -- of the list. First returns Empty immediately if the list is empty.
211 -- Present is defined in Atree, First and Next are defined in Nlists.
213 -- The exceptions to this rule occur with {DEFINING_IDENTIFIERS} in all
214 -- contexts, which is handled as described in the previous section, and
215 -- with {,library_unit_NAME} in the N_With_Clause mode, which is handled
216 -- using the First_Name and Last_Name flags, as further detailed in the
217 -- description of the N_With_Clause node.
223 -- Pragmas can appear in many different context, but are not included in
224 -- the grammar. Still they must appear in the tree, so they can be properly
227 -- Two approaches are used. In some cases, an extra field is defined in an
228 -- appropriate node that contains a list of pragmas appearing in the
229 -- expected context. For example pragmas can appear before an
230 -- Accept_Alternative in a Selective_Accept_Statement, and these pragmas
231 -- appear in the Pragmas_Before field of the N_Accept_Alternative node.
233 -- The other approach is to simply allow pragmas to appear in syntactic
234 -- lists where the grammar (of course) does not include the possibility.
235 -- For example, the Variants field of an N_Variant_Part node points to a
236 -- list that can contain both N_Pragma and N_Variant nodes.
238 -- To make processing easier in the latter case, the Nlists package
239 -- provides a set of routines (First_Non_Pragma, Last_Non_Pragma,
240 -- Next_Non_Pragma, Prev_Non_Pragma) that allow such lists to be handled
241 -- ignoring all pragmas.
243 -- In the case of the variants list, we can either write:
245 -- Variant := First (Variants (N));
246 -- while Present (Variant) loop
248 -- Variant := Next (Variant);
253 -- Variant := First_Non_Pragma (Variants (N));
254 -- while Present (Variant) loop
256 -- Variant := Next_Non_Pragma (Variant);
259 -- In the first form of the loop, Variant can either be an N_Pragma or an
260 -- N_Variant node. In the second form, Variant can only be N_Variant since
261 -- all pragmas are skipped.
263 ---------------------
264 -- Optional Fields --
265 ---------------------
267 -- Fields which correspond to a section of the syntax enclosed in square
268 -- brackets are generally omitted (and the corresponding field set to Empty
269 -- for a node, or No_List for a list). The documentation of such fields
270 -- notes these cases. One exception to this rule occurs in the case of
271 -- possibly empty statement sequences (such as the sequence of statements
272 -- in an entry call alternative). Such cases appear in the syntax rules as
273 -- [SEQUENCE_OF_STATEMENTS] and the fields corresponding to such optional
274 -- statement sequences always contain an empty list (not No_List) if no
275 -- statements are present.
277 -- Note: the utility program that constructs the body and spec of the Nmake
278 -- package relies on the format of the comments to determine if a field
279 -- should have a default value in the corresponding make routine. The rule
280 -- is that if the first line of the description of the field contains the
281 -- string "(set to xxx if", then a default value of xxx is provided for
282 -- this field in the corresponding Make_yyy routine.
284 -----------------------------------
285 -- Note on Body/Spec Terminology --
286 -----------------------------------
288 -- In informal discussions about Ada, it is customary to refer to package
289 -- and subprogram specs and bodies. However, this is not technically
290 -- correct, what is normally referred to as a spec or specification is in
291 -- fact a package declaration or subprogram declaration. We are careful in
292 -- GNAT to use the correct terminology and in particular, the full word
293 -- specification is never used as an incorrect substitute for declaration.
294 -- The structure and terminology used in the tree also reflects the grammar
295 -- and thus uses declaration and specification in the technically correct
298 -- However, there are contexts in which the informal terminology is useful.
299 -- We have the word "body" to refer to the Interp_Etype declared by the
300 -- declaration of a unit body, and in some contexts we need similar term to
301 -- refer to the entity declared by the package or subprogram declaration,
302 -- and simply using declaration can be confusing since the body also has a
305 -- An example of such a context is the link between the package body and
306 -- its declaration. With_Declaration is confusing, since the package body
307 -- itself is a declaration.
309 -- To deal with this problem, we reserve the informal term Spec, i.e. the
310 -- popular abbreviation used in this context, to refer to the entity
311 -- declared by the package or subprogram declaration. So in the above
312 -- example case, the field in the body is called With_Spec.
314 -- Another important context for the use of the word Spec is in error
315 -- messages, where a hyper-correct use of declaration would be confusing to
316 -- a typical Ada programmer, and even for an expert programmer can cause
317 -- confusion since the body has a declaration as well.
321 -- Declaration always refers to the syntactic entity that is called
322 -- a declaration. In particular, subprogram declaration
323 -- and package declaration are used to describe the
324 -- syntactic entity that includes the semicolon.
326 -- Specification always refers to the syntactic entity that is called
327 -- a specification. In particular, the terms procedure
328 -- specification, function specification, package
329 -- specification, subprogram specification always refer
330 -- to the syntactic entity that has no semicolon.
332 -- Spec is an informal term, used to refer to the entity
333 -- that is declared by a task declaration, protected
334 -- declaration, generic declaration, subprogram
335 -- declaration or package declaration.
337 -- This convention is followed throughout the GNAT documentation
338 -- both internal and external, and in all error message text.
340 ------------------------
341 -- Internal Use Nodes --
342 ------------------------
344 -- These are Node_Kind settings used in the internal implementation which
345 -- are not logically part of the specification.
348 -- Completely unused entry at the start of the enumeration type. This
349 -- is inserted so that no legitimate value is zero, which helps to get
350 -- better debugging behavior, since zero is a likely uninitialized value).
353 -- Completely unused entry at the end of the enumeration type. This is
354 -- handy so that arrays with Node_Kind as the index type have an extra
355 -- entry at the end (see for example the use of the Pchar_Pos_Array in
356 -- Treepr, where the extra entry provides the limit value when dealing with
357 -- the last used entry in the array).
359 -----------------------------------------
360 -- Note on the settings of Sloc fields --
361 -----------------------------------------
363 -- The Sloc field of nodes that come from the source is set by the parser.
364 -- For internal nodes, and nodes generated during expansion the Sloc is
365 -- usually set in the call to the constructor for the node. In general the
366 -- Sloc value chosen for an internal node is the Sloc of the source node
367 -- whose processing is responsible for the expansion. For example, the Sloc
368 -- of an inherited primitive operation is the Sloc of the corresponding
369 -- derived type declaration.
371 -- For the nodes of a generic instantiation, the Sloc value is encoded to
372 -- represent both the original Sloc in the generic unit, and the Sloc of
373 -- the instantiation itself. See Sinput.ads for details.
375 -- Subprogram instances create two callable entities: one is the visible
376 -- subprogram instance, and the other is an anonymous subprogram nested
377 -- within a wrapper package that contains the renamings for the actuals.
378 -- Both of these entities have the Sloc of the defining entity in the
379 -- instantiation node. This simplifies some ASIS queries.
381 -----------------------
382 -- Field Definitions --
383 -----------------------
385 -- In the following node definitions, all fields, both syntactic and
386 -- semantic, are documented. The one exception is in the case of entities
387 -- (defining indentifiers, character literals and operator symbols), where
388 -- the usage of the fields depends on the entity kind. Entity fields are
389 -- fully documented in the separate package Einfo.
391 -- In the node definitions, three common sets of fields are abbreviated to
392 -- save both space in the documentation, and also space in the string
393 -- (defined in Tree_Print_Strings) used to print trees. The following
394 -- abbreviations are used:
396 -- Note: the utility program that creates the Treeprs spec (in the file
397 -- xtreeprs.adb) knows about the special fields here, so it must be
398 -- modified if any change is made to these fields.
400 -- "plus fields for binary operator"
401 -- Chars (Name1) Name_Id for the operator
402 -- Left_Opnd (Node2) left operand expression
403 -- Right_Opnd (Node3) right operand expression
404 -- Entity (Node4-Sem) defining entity for operator
405 -- Associated_Node (Node4-Sem) for generic processing
406 -- Do_Overflow_Check (Flag17-Sem) set if overflow check needed
407 -- Has_Private_View (Flag11-Sem) set in generic units.
409 -- "plus fields for unary operator"
410 -- Chars (Name1) Name_Id for the operator
411 -- Right_Opnd (Node3) right operand expression
412 -- Entity (Node4-Sem) defining entity for operator
413 -- Associated_Node (Node4-Sem) for generic processing
414 -- Do_Overflow_Check (Flag17-Sem) set if overflow check needed
415 -- Has_Private_View (Flag11-Sem) set in generic units.
417 -- "plus fields for expression"
418 -- Paren_Count number of parentheses levels
419 -- Etype (Node5-Sem) type of the expression
420 -- Is_Overloaded (Flag5-Sem) >1 type interpretation exists
421 -- Is_Static_Expression (Flag6-Sem) set for static expression
422 -- Raises_Constraint_Error (Flag7-Sem) evaluation raises CE
423 -- Must_Not_Freeze (Flag8-Sem) set if must not freeze
424 -- Do_Range_Check (Flag9-Sem) set if a range check needed
425 -- Assignment_OK (Flag15-Sem) set if modification is OK
426 -- Is_Controlling_Actual (Flag16-Sem) set for controlling argument
428 -- Note: see under (EXPRESSION) for further details on the use of
429 -- the Paren_Count field to record the number of parentheses levels.
431 -- Node_Kind is the type used in the Nkind field to indicate the node kind.
432 -- The actual definition of this type is given later (the reason for this
433 -- is that we want the descriptions ordered by logical chapter in the RM,
434 -- but the type definition is reordered to facilitate the definition of
435 -- some subtype ranges. The individual descriptions of the nodes show how
436 -- the various fields are used in each node kind, as well as providing
437 -- logical names for the fields. Functions and procedures are provided for
438 -- accessing and setting these fields using these logical names.
440 -----------------------
441 -- Gigi Restrictions --
442 -----------------------
444 -- The tree passed to Gigi is more restricted than the general tree form.
445 -- For example, as a result of expansion, most of the tasking nodes can
446 -- never appear. For each node to which either a complete or partial
447 -- restriction applies, a note entitled "Gigi restriction" appears which
448 -- documents the restriction.
450 -- Note that most of these restrictions apply only to trees generated when
451 -- code is being generated, since they involved expander actions that
454 ------------------------
455 -- Common Flag Fields --
456 ------------------------
458 -- The following flag fields appear in all nodes
461 -- This flag is used to indicate that a node (and all its children have
462 -- been analyzed. It is used to avoid reanalysis of a node that has
463 -- already been analyzed, both for efficiency and functional correctness
466 -- Comes_From_Source (Flag2)
467 -- This flag is on for any nodes built by the scanner or parser from the
468 -- source program, and off for any nodes built by the analyzer or
469 -- expander. It indicates that a node comes from the original source.
470 -- This flag is defined in Atree.
472 -- Error_Posted (Flag3)
473 -- This flag is used to avoid multiple error messages being posted on or
474 -- referring to the same node. This flag is set if an error message
475 -- refers to a node or is posted on its source location, and has the
476 -- effect of inhibiting further messages involving this same node.
478 -- Has_Dynamic_Length_Check (Flag10-Sem)
479 -- This flag is present on all nodes. It is set to indicate that one of
480 -- the routines in unit Checks has generated a length check action which
481 -- has been inserted at the flagged node. This is used to avoid the
482 -- generation of duplicate checks.
484 -- Has_Dynamic_Range_Check (Flag12-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 range check action which
487 -- has been inserted at the flagged node. This is used to avoid the
488 -- generation of duplicate checks.
490 -- Has_Local_Raise (Flag8-Sem)
491 -- Present in exception handler nodes. Set if the handler can be entered
492 -- via a local raise that gets transformed to a goto statement. This will
493 -- always be set if Local_Raise_Statements is non-empty, but can also be
494 -- set as a result of generation of N_Raise_xxx nodes, or flags set in
495 -- nodes requiring generation of back end checks.
497 ------------------------------------
498 -- Description of Semantic Fields --
499 ------------------------------------
501 -- The meaning of the syntactic fields is generally clear from their names
502 -- without any further description, since the names are chosen to
503 -- correspond very closely to the syntax in the reference manual. This
504 -- section describes the usage of the semantic fields, which are used to
505 -- contain additional information determined during semantic analysis.
507 -- ABE_Is_Certain (Flag18-Sem)
508 -- This flag is set in an instantiation node or a call node is determined
509 -- to be sure to raise an ABE. This is used to trigger special handling
510 -- of such cases, particularly in the instantiation case where we avoid
511 -- instantiating the body if this flag is set. This flag is also present
512 -- in an N_Formal_Package_Declaration_Node since formal package
513 -- declarations are treated like instantiations, but it is always set to
514 -- False in this context.
516 -- Accept_Handler_Records (List5-Sem)
517 -- This field is present only in an N_Accept_Alternative node. It is used
518 -- to temporarily hold the exception handler records from an accept
519 -- statement in a selective accept. These exception handlers will
520 -- eventually be placed in the Handler_Records list of the procedure
521 -- built for this accept (see Expand_N_Selective_Accept procedure in
522 -- Exp_Ch9 for further details).
524 -- Access_Types_To_Process (Elist2-Sem)
525 -- Present in N_Freeze_Entity nodes for Incomplete or private types.
526 -- Contains the list of access types which may require specific treatment
527 -- when the nature of the type completion is completely known. An example
528 -- of such treatement is the generation of the associated_final_chain.
530 -- Actions (List1-Sem)
531 -- This field contains a sequence of actions that are associated with the
532 -- node holding the field. See the individual node types for details of
533 -- how this field is used, as well as the description of the specific use
534 -- for a particular node type.
536 -- Activation_Chain_Entity (Node3-Sem)
537 -- This is used in tree nodes representing task activators (blocks,
538 -- subprogram bodies, package declarations, and task bodies). It is
539 -- initially Empty, and then gets set to point to the entity for the
540 -- declared Activation_Chain variable when the first task is declared.
541 -- When tasks are declared in the corresponding declarative region this
542 -- entity is located by name (its name is always _Chain) and the declared
543 -- tasks are added to the chain. Note that N_Extended_Return_Statement
544 -- does not have this attribute, although it does have an activation
545 -- chain. This chain is used to store the tasks temporarily, and is not
546 -- used for activating them. On successful completion of the return
547 -- statement, the tasks are moved to the caller's chain, and the caller
550 -- Acts_As_Spec (Flag4-Sem)
551 -- A flag set in the N_Subprogram_Body node for a subprogram body which
552 -- is acting as its own spec. This flag also appears in the compilation
553 -- unit node at the library level for such a subprogram (see further
554 -- description in spec of Lib package).
556 -- Actual_Designated_Subtype (Node4-Sem)
557 -- Present in N_Free_Statement and N_Explicit_Dereference nodes. If gigi
558 -- needs to known the dynamic constrained subtype of the designated
559 -- object, this attribute is set to that type. This is done for
560 -- N_Free_Statements for access-to-classwide types and access to
561 -- unconstrained packed array types, and for N_Explicit_Dereference when
562 -- the designated type is an unconstrained packed array and the
563 -- dereference is the prefix of a 'Size attribute reference.
565 -- Address_Warning_Posted (Flag18-Sem)
566 -- Present in N_Attribute_Definition nodes. Set to indicate that we have
567 -- posted a warning for the address clause regarding size or alignment
568 -- issues. Used to inhibit multiple redundant messages.
570 -- Aggregate_Bounds (Node3-Sem)
571 -- Present in array N_Aggregate nodes. If the aggregate contains
572 -- component associations this field points to an N_Range node whose
573 -- bounds give the lowest and highest discrete choice values. If the
574 -- named aggregate contains a dynamic or null choice this field is empty.
575 -- If the aggregate contains positional elements this field points to an
576 -- N_Integer_Literal node giving the number of positional elements. Note
577 -- that if the aggregate contains positional elements and an other choice
578 -- the N_Integer_Literal only accounts for the number of positional
581 -- All_Others (Flag11-Sem)
582 -- Present in an N_Others_Choice node. This flag is set in the case of an
583 -- others exception where all exceptions are to be caught, even those
584 -- that are not normally handled (in particular the tasking abort
585 -- signal). This is used for translation of the at end handler into a
586 -- normal exception handler.
588 -- Assignment_OK (Flag15-Sem)
589 -- This flag is set in a subexpression node for an object, indicating
590 -- that the associated object can be modified, even if this would not
591 -- normally be permissible (either by direct assignment, or by being
592 -- passed as an out or in-out parameter). This is used by the expander
593 -- for a number of purposes, including initialzation of constants and
594 -- limited type objects (such as tasks), setting discriminant fields,
595 -- setting tag values, etc. N_Object_Declaration nodes also have this
596 -- flag defined. Here it is used to indicate that an initialization
597 -- expression is valid, even where it would normally not be allowed (e.g.
598 -- where the type involved is limited).
600 -- Associated_Node (Node4-Sem)
601 -- Present in nodes that can denote an entity: identifiers, character
602 -- literals, operator symbols, expanded names, operator nodes, and
603 -- attribute reference nodes (all these nodes have an Entity field). This
604 -- field is also present in N_Aggregate, N_Selected_Component, and
605 -- N_Extension_Aggregate nodes. This field is used in generic processing
606 -- to create links between the generic template and the generic copy. See
607 -- Sem_Ch12.Get_Associated_Node for full details. Note that this field
608 -- overlaps Entity, which is fine, since, as explained in Sem_Ch12, the
609 -- normal function of Entity is not required at the point where the
610 -- Associated_Node is set. Note also, that in generic templates, this
611 -- means that the Entity field does not necessarily point to an Entity.
612 -- Since the back end is expected to ignore generic templates, this is
615 -- At_End_Proc (Node1)
616 -- This field is present in an N_Handled_Sequence_Of_Statements node. It
617 -- contains an identifier reference for the cleanup procedure to be
618 -- called. See description of this node for further details.
620 -- Backwards_OK (Flag6-Sem)
621 -- A flag present in the N_Assignment_Statement node. It is used only if
622 -- the type being assigned is an array type, and is set if analysis
623 -- determines that it is definitely safe to do the copy backwards, i.e.
624 -- starting at the highest addressed element. Note that if neither of the
625 -- flags Forwards_OK or Backwards_OK is set, it means that the front end
626 -- could not determine that either direction is definitely safe, and a
627 -- runtime check may be required if the backend cannot figure it out.
629 -- Body_To_Inline (Node3-Sem)
630 -- present in subprogram declarations. Denotes analyzed but unexpanded
631 -- body of subprogram, to be used when inlining calls. Present when the
632 -- subprogram has an Inline pragma and inlining is enabled. If the
633 -- declaration is completed by a renaming_as_body, and the renamed en-
634 -- tity is a subprogram, the Body_To_Inline is the name of that entity,
635 -- which is used directly in later calls to the original subprogram.
637 -- Body_Required (Flag13-Sem)
638 -- A flag that appears in the N_Compilation_Unit node indicating that the
639 -- corresponding unit requires a body. For the package case, this
640 -- indicates that a completion is required. In Ada 95, if the flag is not
641 -- set for the package case, then a body may not be present. In Ada 83,
642 -- if the flag is not set for the package case, then body is optional.
643 -- For a subprogram declaration, the flag is set except in the case where
644 -- a pragma Import or Interface applies, in which case no body is
645 -- permitted (in Ada 83 or Ada 95).
647 -- By_Ref (Flag5-Sem)
648 -- A flag present in N_Simple_Return_Statement and
649 -- N_Extended_Return_Statement.
650 -- It is set when the returned expression is already allocated on the
651 -- secondary stack and thus the result is passed by reference rather
652 -- than copied another time.
654 -- Check_Address_Alignment (Flag11-Sem)
655 -- A flag present in N_Attribute_Definition clause for a 'Address
656 -- attribute definition. This flag is set if a dynamic check should be
657 -- generated at the freeze point for the entity to which this address
658 -- clause applies. The reason that we need this flag is that we want to
659 -- check for range checks being suppressed at the point where the
660 -- attribute definition clause is given, rather than testing this at the
663 -- Coextensions (Elist4-Sem)
664 -- Present in allocators nodes. Points to list of allocators for the
665 -- access discriminants of the allocated object.
667 -- Comes_From_Extended_Return_Statement (Flag18-Sem)
668 -- Present in N_Simple_Return_Statement nodes. True if this node was
669 -- constructed as part of the expansion of an
670 -- N_Extended_Return_Statement.
672 -- Compile_Time_Known_Aggregate (Flag18-Sem)
673 -- Present in N_Aggregate nodes. Set for aggregates which can be fully
674 -- evaluated at compile time without raising constraint error. Such
675 -- aggregates can be passed as is to Gigi without any expansion. See
676 -- Sem_Aggr for the specific conditions under which an aggregate has this
677 -- flag set. See also the flag Static_Processing_OK.
679 -- Condition_Actions (List3-Sem)
680 -- This field appears in else-if nodes and in the iteration scheme node
681 -- for while loops. This field is only used during semantic processing to
682 -- temporarily hold actions inserted into the tree. In the tree passed to
683 -- gigi, the condition actions field is always set to No_List. For
684 -- details on how this field is used, see the routine Insert_Actions in
685 -- package Exp_Util, and also the expansion routines for the relevant
688 -- Controlling_Argument (Node1-Sem)
689 -- This field is set in procedure and function call nodes if the call is
690 -- a dispatching call (it is Empty for a non-dispatching call). It
691 -- indicates the source of the call's controlling tag. For procedure
692 -- calls, the Controlling_Argument is one of the actuals. For function
693 -- that has a dispatching result, it is an entity in the context of the
694 -- call that can provide a tag, or else it is the tag of the root type of
695 -- the class. It can also specify a tag directly rather than being a
696 -- tagged object. The latter is needed by the implementations of AI-239
699 -- Conversion_OK (Flag14-Sem)
700 -- A flag set on type conversion nodes to indicate that the conversion is
701 -- to be considered as being valid, even though it is the case that the
702 -- conversion is not valid Ada. This is used for Enum_Rep, Fixed_Value
703 -- and Integer_Value attributes, for internal conversions done for
704 -- fixed-point operations, and for certain conversions for calls to
705 -- initialization procedures. If Conversion_OK is set, then Etype must be
706 -- set (the analyzer assumes that Etype has been set). For the case of
707 -- fixed-point operands, it also indicates that the conversion is to be
708 -- direct conversion of the underlying integer result, with no regard to
709 -- the small operand.
711 -- Corresponding_Body (Node5-Sem)
712 -- This field is set in subprogram declarations, package declarations,
713 -- entry declarations of protected types, and in generic units. It
714 -- points to the defining entity for the corresponding body (NOT the
715 -- node for the body itself).
717 -- Corresponding_Formal_Spec (Node3-Sem)
718 -- This field is set in subprogram renaming declarations, where it points
719 -- to the defining entity for a formal subprogram in the case where the
720 -- renaming corresponds to a generic formal subprogram association in an
721 -- instantiation. The field is Empty if the renaming does not correspond
722 -- to such a formal association.
724 -- Corresponding_Generic_Association (Node5-Sem)
725 -- This field is defined for object declarations and object renaming
726 -- declarations. It is set for the declarations within an instance that
727 -- map generic formals to their actuals. If set, the field points to
728 -- a generic_association which is the original parent of the expression
729 -- or name appearing in the declaration. This simplifies ASIS queries.
731 -- Corresponding_Integer_Value (Uint4-Sem)
732 -- This field is set in real literals of fixed-point types (it is not
733 -- used for floating-point types). It contains the integer value used
734 -- to represent the fixed-point value. It is also set on the universal
735 -- real literals used to represent bounds of fixed-point base types
736 -- and their first named subtypes.
738 -- Corresponding_Spec (Node5-Sem)
739 -- This field is set in subprogram, package, task, and protected body
740 -- nodes, where it points to the defining entity in the corresponding
741 -- spec. The attribute is also set in N_With_Clause nodes, where it
742 -- points to the defining entity for the with'ed spec, and in a
743 -- subprogram renaming declaration when it is a Renaming_As_Body. The
744 -- field is Empty if there is no corresponding spec, as in the case of a
745 -- subprogram body that serves as its own spec.
747 -- Corresponding_Stub (Node3-Sem)
748 -- This field is present in an N_Subunit node. It holds the node in
749 -- the parent unit that is the stub declaration for the subunit. it is
750 -- set when analysis of the stub forces loading of the proper body. If
751 -- expansion of the proper body creates new declarative nodes, they are
752 -- inserted at the point of the corresponding_stub.
754 -- Dcheck_Function (Node5-Sem)
755 -- This field is present in an N_Variant node, It references the entity
756 -- for the discriminant checking function for the variant.
758 -- Debug_Statement (Node3)
759 -- This field is present in an N_Pragma node. It is used only for a Debug
760 -- pragma. The parameter is of the form of an expression, as required by
761 -- the pragma syntax, but is actually a procedure call. To simplify
762 -- semantic processing, the parser creates a copy of the argument
763 -- rearranged into a procedure call statement and places it in the
764 -- Debug_Statement field. Note that this field is considered syntactic
765 -- field, since it is created by the parser.
767 -- Default_Expression (Node5-Sem)
768 -- This field is Empty if there is no default expression. If there is a
769 -- simple default expression (one with no side effects), then this field
770 -- simply contains a copy of the Expression field (both point to the tree
771 -- for the default expression). Default_Expression is used for
772 -- conformance checking.
774 -- Discr_Check_Funcs_Built (Flag11-Sem)
775 -- This flag is present in N_Full_Type_Declaration nodes. It is set when
776 -- discriminant checking functions are constructed. The purpose is to
777 -- avoid attempting to set these functions more than once.
779 -- Do_Accessibility_Check (Flag13-Sem)
780 -- This flag is set on N_Parameter_Specification nodes to indicate
781 -- that an accessibility check is required for the parameter. It is
782 -- not yet decided who takes care of this check (TBD ???).
784 -- Do_Discriminant_Check (Flag13-Sem)
785 -- This flag is set on N_Selected_Component nodes to indicate that a
786 -- discriminant check is required using the discriminant check routine
787 -- associated with the selector. The actual check is generated by the
788 -- expander when processing selected components.
790 -- Do_Division_Check (Flag13-Sem)
791 -- This flag is set on a division operator (/ mod rem) to indicate
792 -- that a zero divide check is required. The actual check is dealt
793 -- with by the backend (all the front end does is to set the flag).
795 -- Do_Length_Check (Flag4-Sem)
796 -- This flag is set in an N_Assignment_Statement, N_Op_And, N_Op_Or,
797 -- N_Op_Xor, or N_Type_Conversion node to indicate that a length check
798 -- is required. It is not determined who deals with this flag (???).
800 -- Do_Overflow_Check (Flag17-Sem)
801 -- This flag is set on an operator where an overflow check is required on
802 -- the operation. The actual check is dealt with by the backend (all the
803 -- front end does is to set the flag). The other cases where this flag is
804 -- used is on a Type_Conversion node and for attribute reference nodes.
805 -- For a type conversion, it means that the conversion is from one base
806 -- type to another, and the value may not fit in the target base type.
807 -- See also the description of Do_Range_Check for this case. The only
808 -- attribute references which use this flag are Pred and Succ, where it
809 -- means that the result should be checked for going outside the base
812 -- Do_Range_Check (Flag9-Sem)
813 -- This flag is set on an expression which appears in a context where
814 -- a range check is required. The target type is clear from the
815 -- context. The contexts in which this flag can appear are limited to
818 -- Right side of an assignment. In this case the target type is
819 -- taken from the left side of the assignment, which is referenced
820 -- by the Name of the N_Assignment_Statement node.
822 -- Subscript expressions in an indexed component. In this case the
823 -- target type is determined from the type of the array, which is
824 -- referenced by the Prefix of the N_Indexed_Component node.
826 -- Argument expression for a parameter, appearing either directly in
827 -- the Parameter_Associations list of a call or as the Expression of an
828 -- N_Parameter_Association node that appears in this list. In either
829 -- case, the check is against the type of the formal. Note that the
830 -- flag is relevant only in IN and IN OUT parameters, and will be
831 -- ignored for OUT parameters, where no check is required in the call,
832 -- and if a check is required on the return, it is generated explicitly
833 -- with a type conversion.
835 -- Initialization expression for the initial value in an object
836 -- declaration. In this case the Do_Range_Check flag is set on
837 -- the initialization expression, and the check is against the
838 -- range of the type of the object being declared.
840 -- The expression of a type conversion. In this case the range check is
841 -- against the target type of the conversion. See also the use of
842 -- Do_Overflow_Check on a type conversion. The distinction is that the
843 -- overflow check protects against a value that is outside the range of
844 -- the target base type, whereas a range check checks that the
845 -- resulting value (which is a value of the base type of the target
846 -- type), satisfies the range constraint of the target type.
848 -- Note: when a range check is required in contexts other than those
849 -- listed above (e.g. in a return statement), an additional type
850 -- conversion node is introduced to represent the required check.
852 -- Do_Storage_Check (Flag17-Sem)
853 -- This flag is set in an N_Allocator node to indicate that a storage
854 -- check is required for the allocation, or in an N_Subprogram_Body node
855 -- to indicate that a stack check is required in the subprogram prolog.
856 -- The N_Allocator case is handled by the routine that expands the call
857 -- to the runtime routine. The N_Subprogram_Body case is handled by the
858 -- backend, and all the semantics does is set the flag.
860 -- Do_Tag_Check (Flag13-Sem)
861 -- This flag is set on an N_Assignment_Statement, N_Function_Call,
862 -- N_Procedure_Call_Statement, N_Type_Conversion,
863 -- N_Simple_Return_Statement, or N_Extended_Return_Statement
864 -- node to indicate that the tag check can be suppressed. It is not
865 -- yet decided how this flag is used (TBD ???).
867 -- Elaborate_Present (Flag4-Sem)
868 -- This flag is set in the N_With_Clause node to indicate that pragma
869 -- Elaborate pragma appears for the with'ed units.
871 -- Elaborate_All_Desirable (Flag9-Sem)
872 -- This flag is set in the N_With_Clause mode to indicate that the static
873 -- elaboration processing has determined that an Elaborate_All pragma is
874 -- desirable for correct elaboration for this unit.
876 -- Elaborate_All_Present (Flag14-Sem)
877 -- This flag is set in the N_With_Clause node to indicate that a
878 -- pragma Elaborate_All pragma appears for the with'ed units.
880 -- Elaborate_Desirable (Flag11-Sem)
881 -- This flag is set in the N_With_Clause mode to indicate that the static
882 -- elaboration processing has determined that an Elaborate pragma is
883 -- desirable for correct elaboration for this unit.
885 -- Elaboration_Boolean (Node2-Sem)
886 -- This field is present in function and procedure specification
887 -- nodes. If set, it points to the entity for a Boolean flag that
888 -- must be tested for certain calls to check for access before
889 -- elaboration. See body of Sem_Elab for further details. This
890 -- field is Empty if no elaboration boolean is required.
892 -- Else_Actions (List3-Sem)
893 -- This field is present in conditional expression nodes. During code
894 -- expansion we use the Insert_Actions procedure (in Exp_Util) to insert
895 -- actions at an appropriate place in the tree to get elaborated at the
896 -- right time. For conditional expressions, we have to be sure that the
897 -- actions for the Else branch are only elaborated if the condition is
898 -- False. The Else_Actions field is used as a temporary parking place for
899 -- these actions. The final tree is always rewritten to eliminate the
900 -- need for this field, so in the tree passed to Gigi, this field is
901 -- always set to No_List.
903 -- Enclosing_Variant (Node2-Sem)
904 -- This field is present in the N_Variant node and identifies the
905 -- Node_Id corresponding to the immediately enclosing variant when
906 -- the variant is nested, and N_Empty otherwise. Set during semantic
907 -- processing of the variant part of a record type.
909 -- Entity (Node4-Sem)
910 -- Appears in all direct names (identifier, character literal, operator
911 -- symbol), as well as expanded names, and attributes that denote
912 -- entities, such as 'Class. Points to the entity for the corresponding
913 -- defining occurrence. Set after name resolution. In the case of
914 -- identifiers in a WITH list, the corresponding defining occurrence is
915 -- in a separately compiled file, and this pointer must be set using the
916 -- library Load procedure. Note that during name resolution, the value in
917 -- Entity may be temporarily incorrect (e.g. during overload resolution,
918 -- Entity is initially set to the first possible correct interpretation,
919 -- and then later modified if necessary to contain the correct value
920 -- after resolution). Note that this field overlaps Associated_Node,
921 -- which is used during generic processing (see Sem_Ch12 for details).
922 -- Note also that in generic templates, this means that the Entity field
923 -- does not always point to an Entity. Since the back end is expected to
924 -- ignore generic templates, this is harmless. Note that this field also
925 -- appears in N_Attribute_Definition_Clause nodes. It is used only for
926 -- stream attributes definition clauses. In this case, it denotes a
927 -- (possibly dummy) subprogram entity that is conceptually declared at
928 -- the point of the clause. Thus the visibility of the attribute
929 -- definition clause (in the sense of 8.3(23) as amended by AI-195) can
930 -- be checked by testing the visibility of that subprogram.
932 -- Entity_Or_Associated_Node (Node4-Sem)
933 -- A synonym for both Entity and Associated_Node. Used by convention in
934 -- the code when referencing this field in cases where it is not known
935 -- whether the field contains an Entity or an Associated_Node.
938 -- Appears in all expression nodes, all direct names, and all entities.
939 -- Points to the entity for the related type. Set after type resolution.
940 -- Normally this is the actual subtype of the expression. However, in
941 -- certain contexts such as the right side of an assignment, subscripts,
942 -- arguments to calls, returned value in a function, initial value etc.
943 -- it is the desired target type. In the event that this is different
944 -- from the actual type, the Do_Range_Check flag will be set if a range
945 -- check is required. Note: if the Is_Overloaded flag is set, then Etype
946 -- points to an essentially arbitrary choice from the possible set of
949 -- Exception_Junk (Flag8-Sem)
950 -- This flag is set in a various nodes appearing in a statement sequence
951 -- to indicate that the corresponding node is an artifact of the
952 -- generated code for exception handling, and should be ignored when
953 -- analyzing the control flow of the relevant sequence of statements
954 -- (e.g. to check that it does not end with a bad return statement).
956 -- Exception_Label (Node5-Sem)
957 -- Appears in N_Push_xxx_Label nodes. Points to the entity of the label
958 -- to be used for transforming the corresponding exception into a goto,
959 -- or contains Empty, if this exception is not to be transformed. Also
960 -- appears in N_Exception_Handler nodes, where, if set, it indicates
961 -- that there may be a local raise for the handler, so that expansion
962 -- to allow a goto is required (and this field contains the label for
963 -- this goto). See Exp_Ch11.Expand_Local_Exception_Handlers for details.
965 -- Expansion_Delayed (Flag11-Sem)
966 -- Set on aggregates and extension aggregates that need a top-down rather
967 -- than bottom up expansion. Typically aggregate expansion happens bottom
968 -- up. For nested aggregates the expansion is delayed until the enclosing
969 -- aggregate itself is expanded, e.g. in the context of a declaration. To
970 -- delay it we set this flag. This is done to avoid creating a temporary
971 -- for each level of a nested aggregates, and also to prevent the
972 -- premature generation of constraint checks. This is also a requirement
973 -- if we want to generate the proper attachment to the internal
974 -- finalization lists (for record with controlled components). Top down
975 -- expansion of aggregates is also used for in-place array aggregate
976 -- assignment or initialization. When the full context is known, the
977 -- target of the assignment or initialization is used to generate the
978 -- left-hand side of individual assignment to each sub-component.
980 -- First_Inlined_Subprogram (Node3-Sem)
981 -- Present in the N_Compilation_Unit node for the main program. Points to
982 -- a chain of entities for subprograms that are to be inlined. The
983 -- Next_Inlined_Subprogram field of these entities is used as a link
984 -- pointer with Empty marking the end of the list. This field is Empty if
985 -- there are no inlined subprograms or inlining is not active.
987 -- First_Named_Actual (Node4-Sem)
988 -- Present in procedure call statement and function call nodes, and also
989 -- in Intrinsic nodes. Set during semantic analysis to point to the first
990 -- named parameter where parameters are ordered by declaration order (as
991 -- opposed to the actual order in the call which may be different due to
992 -- named associations). Note: this field points to the explicit actual
993 -- parameter itself, not the N_Parameter_Association node (its parent).
995 -- First_Real_Statement (Node2-Sem)
996 -- Present in N_Handled_Sequence_Of_Statements node. Normally set to
997 -- Empty. Used only when declarations are moved into the statement part
998 -- of a construct as a result of wrapping an AT END handler that is
999 -- required to cover the declarations. In this case, this field is used
1000 -- to remember the location in the statements list of the first real
1001 -- statement, i.e. the statement that used to be first in the statement
1002 -- list before the declarations were prepended.
1004 -- First_Subtype_Link (Node5-Sem)
1005 -- Present in N_Freeze_Entity node for an anonymous base type that is
1006 -- implicitly created by the declaration of a first subtype. It points to
1007 -- the entity for the first subtype.
1009 -- Float_Truncate (Flag11-Sem)
1010 -- A flag present in type conversion nodes. This is used for float to
1011 -- integer conversions where truncation is required rather than rounding.
1012 -- Note that Gigi does not handle type conversions from real to integer
1013 -- with rounding (see Expand_N_Type_Conversion).
1015 -- Forwards_OK (Flag5-Sem)
1016 -- A flag present in the N_Assignment_Statement node. It is used only if
1017 -- the type being assigned is an array type, and is set if analysis
1018 -- determines that it is definitely safe to do the copy forwards, i.e.
1019 -- starting at the lowest addressed element. Note that if neither of the
1020 -- flags Forwards_OK or Backwards_OK is set, it means that the front end
1021 -- could not determine that either direction is definitely safe, and a
1022 -- runtime check is required.
1024 -- From_At_Mod (Flag4-Sem)
1025 -- This flag is set on the attribute definition clause node that is
1026 -- generated by a transformation of an at mod phrase in a record
1027 -- representation clause. This is used to give slightly different (Ada 83
1028 -- compatible) semantics to such a clause, namely it is used to specify a
1029 -- minimum acceptable alignment for the base type and all subtypes. In
1030 -- Ada 95 terms, the actual alignment of the base type and all subtypes
1031 -- must be a multiple of the given value, and the representation clause
1032 -- is considered to be type specific instead of subtype specific.
1034 -- From_Default (Flag6-Sem)
1035 -- This flag is set on the subprogram renaming declaration created in an
1036 -- instance for a formal subprogram, when the formal is declared with a
1037 -- box, and there is no explicit actual. If the flag is present, the
1038 -- declaration is treated as an implicit reference to the formal in the
1041 -- Generic_Parent (Node5-Sem)
1042 -- Generic_Parent is defined on declaration nodes that are instances. The
1043 -- value of Generic_Parent is the generic entity from which the instance
1044 -- is obtained. Generic_Parent is also defined for the renaming
1045 -- declarations and object declarations created for the actuals in an
1046 -- instantiation. The generic parent of such a declaration is the
1047 -- corresponding generic association in the Instantiation node.
1049 -- Generic_Parent_Type (Node4-Sem)
1050 -- Generic_Parent_Type is defined on Subtype_Declaration nodes for the
1051 -- actuals of formal private and derived types. Within the instance, the
1052 -- operations on the actual are those inherited from the parent. For a
1053 -- formal private type, the parent type is the generic type itself. The
1054 -- Generic_Parent_Type is also used in an instance to determine whether a
1055 -- private operation overrides an inherited one.
1057 -- Handler_List_Entry (Node2-Sem)
1058 -- This field is present in N_Object_Declaration nodes. It is set only
1059 -- for the Handler_Record entry generated for an exception in zero cost
1060 -- exception handling mode. It references the corresponding item in the
1061 -- handler list, and is used to delete this entry if the corresponding
1062 -- handler is deleted during optimization. For further details on why
1063 -- this is required, see Exp_Ch11.Remove_Handler_Entries.
1065 -- Has_No_Elaboration_Code (Flag17-Sem)
1066 -- A flag that appears in the N_Compilation_Unit node to indicate whether
1067 -- or not elaboration code is present for this unit. It is initially set
1068 -- true for subprogram specs and bodies and for all generic units and
1069 -- false for non-generic package specs and bodies. Gigi may set the flag
1070 -- in the non-generic package case if it determines that no elaboration
1071 -- code is generated. Note that this flag is not related to the
1072 -- Is_Preelaborated status, there can be preelaborated packages that
1073 -- generate elaboration code, and non- preelaborated packages which do
1074 -- not generate elaboration code.
1076 -- Has_Priority_Pragma (Flag6-Sem)
1077 -- A flag present in N_Subprogram_Body, N_Task_Definition and
1078 -- N_Protected_Definition nodes to flag the presence of either a Priority
1079 -- or Interrupt_Priority pragma in the declaration sequence (public or
1080 -- private in the task and protected cases)
1082 -- Has_Private_View (Flag11-Sem)
1083 -- A flag present in generic nodes that have an entity, to indicate that
1084 -- the node has a private type. Used to exchange private and full
1085 -- declarations if the visibility at instantiation is different from the
1086 -- visibility at generic definition.
1088 -- Has_Self_Reference (Flag13-Sem)
1089 -- Present in N_Aggregate and N_Extension_Aggregate. Indicates that one
1090 -- of the expressions contains an access attribute reference to the
1091 -- enclosing type. Such a self-reference can only appear in default-
1092 -- initialized aggregate for a record type.
1094 -- Has_Storage_Size_Pragma (Flag5-Sem)
1095 -- A flag present in an N_Task_Definition node to flag the presence of a
1096 -- Storage_Size pragma.
1098 -- Has_Task_Info_Pragma (Flag7-Sem)
1099 -- A flag present in an N_Task_Definition node to flag the presence of a
1100 -- Task_Info pragma. Used to detect duplicate pragmas.
1102 -- Has_Task_Name_Pragma (Flag8-Sem)
1103 -- A flag present in N_Task_Definition nodes to flag the presence of a
1104 -- Task_Name pragma in the declaration sequence for the task.
1106 -- Has_Wide_Character (Flag11-Sem)
1107 -- Present in string literals, set if any wide character (i.e. character
1108 -- code outside the Character range) appears in the string.
1110 -- Hidden_By_Use_Clause (Elist4-Sem)
1111 -- An entity list present in use clauses that appear within
1112 -- instantiations. For the resolution of local entities, entities
1113 -- introduced by these use clauses have priority over global ones, and
1114 -- outer entities must be explicitly hidden/restored on exit.
1116 -- Implicit_With (Flag16-Sem)
1117 -- This flag is set in the N_With_Clause node that is implicitly
1118 -- generated for runtime units that are loaded by the expander, and also
1119 -- for package System, if it is loaded implicitly by a use of the
1120 -- 'Address or 'Tag attribute.
1122 -- Includes_Infinities (Flag11-Sem)
1123 -- This flag is present in N_Range nodes. It is set for the range of
1124 -- unconstrained float types defined in Standard, which include not only
1125 -- the given range of values, but also legtitimately can include infinite
1126 -- values. This flag is false for any float type for which an explicit
1127 -- range is given by the programmer, even if that range is identical to
1128 -- the range for Float.
1130 -- Instance_Spec (Node5-Sem)
1131 -- This field is present in generic instantiation nodes, and also in
1132 -- formal package declaration nodes (formal package declarations are
1133 -- treated in a manner very similar to package instantiations). It points
1134 -- to the node for the spec of the instance, inserted as part of the
1135 -- semantic processing for instantiations in Sem_Ch12.
1137 -- Is_Asynchronous_Call_Block (Flag7-Sem)
1138 -- A flag set in a Block_Statement node to indicate that it is the
1139 -- expansion of an asynchronous entry call. Such a block needs cleanup
1140 -- handler to assure that the call is cancelled.
1142 -- Is_Component_Left_Opnd (Flag13-Sem)
1143 -- Is_Component_Right_Opnd (Flag14-Sem)
1144 -- Present in concatenation nodes, to indicate that the corresponding
1145 -- operand is of the component type of the result. Used in resolving
1146 -- concatenation nodes in instances.
1148 -- Is_Controlling_Actual (Flag16-Sem)
1149 -- This flag is set on in an expression that is a controlling argument in
1150 -- a dispatching call. It is off in all other cases. See Sem_Disp for
1151 -- details of its use.
1153 -- Is_Dynamic_Coextension (Flag18-Sem)
1154 -- Present in allocator nodes, to indicate that this is an allocator
1155 -- for an access discriminant of a dynamically allocated object. The
1156 -- coextension must be deallocated and finalized at the same time as
1157 -- the enclosing object.
1159 -- Is_Entry_Barrier_Function (Flag8-Sem)
1160 -- This flag is set in an N_Subprogram_Body node which is the expansion
1161 -- of an entry barrier from a protected entry body. It is used for the
1162 -- circuitry checking for incorrect use of Current_Task.
1164 -- Is_Expanded_Build_In_Place_Call (Flag11-Sem)
1165 -- This flag is set in an N_Function_Call node to indicate that the extra
1166 -- actuals to support a build-in-place style of call have been added to
1169 -- Is_In_Discriminant_Check (Flag11-Sem)
1170 -- This flag is present in a selected component, and is used to indicate
1171 -- that the reference occurs within a discriminant check. The
1172 -- significance is that optimizations based on assuming that the
1173 -- discriminant check has a correct value cannot be performed in this
1174 -- case (or the disriminant check may be optimized away!)
1176 -- Is_Machine_Number (Flag11-Sem)
1177 -- This flag is set in an N_Real_Literal node to indicate that the value
1178 -- is a machine number. This avoids some unnecessary cases of converting
1179 -- real literals to machine numbers.
1181 -- Is_Null_Loop (Flag16-Sem)
1182 -- This flag is set in an N_Loop_Statement node if the corresponding loop
1183 -- can be determined to be null at compile time. This is used to suppress
1184 -- any warnings that would otherwise be issued inside the loop since they
1185 -- are probably not useful.
1187 -- Is_Overloaded (Flag5-Sem)
1188 -- A flag present in all expression nodes. Used temporarily during
1189 -- overloading determination. The setting of this flag is not relevant
1190 -- once overloading analysis is complete.
1192 -- Is_Power_Of_2_For_Shift (Flag13-Sem)
1193 -- A flag present only in N_Op_Expon nodes. It is set when the
1194 -- exponentiation is of the forma 2 ** N, where the type of N is an
1195 -- unsigned integral subtype whose size does not exceed the size of
1196 -- Standard_Integer (i.e. a type that can be safely converted to
1197 -- Natural), and the exponentiation appears as the right operand of an
1198 -- integer multiplication or an integer division where the dividend is
1199 -- unsigned. It is also required that overflow checking is off for both
1200 -- the exponentiation and the multiply/divide node. If this set of
1201 -- conditions holds, and the flag is set, then the division or
1202 -- multiplication can be (and is) converted to a shift.
1204 -- Is_Protected_Subprogram_Body (Flag7-Sem)
1205 -- A flag set in a Subprogram_Body block to indicate that it is the
1206 -- implemenation of a protected subprogram. Such a body needs cleanup
1207 -- handler to make sure that the associated protected object is unlocked
1208 -- when the subprogram completes.
1210 -- Is_Static_Coextension (Flag14-Sem)
1211 -- Present in N_Allocator nodes. Set if the allocator is a coextension
1212 -- of an object allocated on the stack rather than the heap.
1214 -- Is_Static_Expression (Flag6-Sem)
1215 -- Indicates that an expression is a static expression (RM 4.9). See spec
1216 -- of package Sem_Eval for full details on the use of this flag.
1218 -- Is_Subprogram_Descriptor (Flag16-Sem)
1219 -- Present in N_Object_Declaration, and set only for the object
1220 -- declaration generated for a subprogram descriptor in fast exception
1221 -- mode. See Exp_Ch11 for details of use.
1223 -- Is_Task_Allocation_Block (Flag6-Sem)
1224 -- A flag set in a Block_Statement node to indicate that it is the
1225 -- expansion of a task allocator, or the allocator of an object
1226 -- containing tasks. Such a block requires a cleanup handler to call
1227 -- Expunge_Unactivted_Tasks to complete any tasks that have been
1228 -- allocated but not activated when the allocator completes abnormally.
1230 -- Is_Task_Master (Flag5-Sem)
1231 -- A flag set in a Subprogram_Body, Block_Statement or Task_Body node to
1232 -- indicate that the construct is a task master (i.e. has declared tasks
1233 -- or declares an access to a task type).
1235 -- Itype (Node1-Sem)
1236 -- Used in N_Itype_Reference node to reference an itype for which it is
1237 -- important to ensure that it is defined. See description of this node
1238 -- for further details.
1240 -- Kill_Range_Check (Flag11-Sem)
1241 -- Used in an N_Unchecked_Type_Conversion node to indicate that the
1242 -- result should not be subjected to range checks. This is used for the
1243 -- implementation of Normalize_Scalars.
1245 -- Label_Construct (Node2-Sem)
1246 -- Used in an N_Implicit_Label_Declaration node. Refers to an N_Label,
1247 -- N_Block_Statement or N_Loop_Statement node to which the label
1248 -- declaration applies. This is not currently used in the compiler
1249 -- itself, but it is useful in the implementation of ASIS queries.
1250 -- This field is left empty for the special labels generated as part
1251 -- of expanding raise statements with a local exception handler.
1253 -- Library_Unit (Node4-Sem)
1254 -- In a stub node, Library_Unit points to the compilation unit node of
1255 -- the corresponding subunit.
1257 -- In a with clause node, Library_Unit points to the spec of the with'ed
1260 -- In a compilation unit node, the usage depends on the unit type:
1262 -- For a subprogram body, Library_Unit points to the compilation unit
1263 -- node of the corresponding spec, unless Acts_As_Spec is set, in which
1264 -- case it points to itself.
1266 -- For a package body, Library_Unit points to the compilation unit of
1267 -- the corresponding package spec.
1269 -- For a subprogram spec to which pragma Inline applies, Library_Unit
1270 -- points to the compilation unit node of the corresponding body, if
1271 -- inlining is active.
1273 -- For a generic declaration, Library_Unit points to the compilation
1274 -- unit node of the corresponding generic body.
1276 -- For a subunit, Library_Unit points to the compilation unit node of
1279 -- Note that this field is not used to hold the parent pointer for child
1280 -- unit (which might in any case need to use it for some other purpose as
1281 -- described above). Instead for a child unit, implicit with's are
1282 -- generated for all parents.
1284 -- Local_Raise_Statements (Elist1)
1285 -- This field is present in exception handler nodes. It is set to
1286 -- No_Elist in the normal case. If there is at least one raise statement
1287 -- which can potentially be handled as a local raise, then this field
1288 -- points to a list of raise nodes, which are calls to a routine to raise
1289 -- an exception. These are raise nodes which can be optimized into gotos
1290 -- if the handler turns out to meet the conditions which permit this
1291 -- transformation. Note that this does NOT include instances of the
1292 -- N_Raise_xxx_Error nodes since the transformation of these nodes is
1293 -- handled by the back end (using the N_Push/N_Pop mechanism).
1295 -- Loop_Actions (List2-Sem)
1296 -- A list present in Component_Association nodes in array aggregates.
1297 -- Used to collect actions that must be executed within the loop because
1298 -- they may need to be evaluated anew each time through.
1300 -- Limited_View_Installed (Flag18-Sem)
1301 -- Present in With_Clauses and in package specifications. If set on
1302 -- with_clause, it indicates that this clause has created the current
1303 -- limited view of the designated package. On a package specification, it
1304 -- indicates that the limited view has already been created because the
1305 -- package is mentioned in a limited_with_clause in the closure of the
1306 -- unit being compiled.
1308 -- Local_Raise_Not_OK (Flag7-Sem)
1309 -- Present in N_Exception_Handler nodes. Set if the handler contains
1310 -- a construct (reraise statement, or call to subprogram in package
1311 -- GNAT.Current_Exception) that makes the handler unsuitable as a target
1312 -- for a local raise (one that could otherwise be converted to a goto).
1314 -- Must_Be_Byte_Aligned (Flag14-Sem)
1315 -- This flag is present in N_Attribute_Reference nodes. It can be set
1316 -- only for the Address and Unrestricted_Access attributes. If set it
1317 -- means that the object for which the address/access is given must be on
1318 -- a byte (more accurately a storage unit) boundary. If necessary, a copy
1319 -- of the object is to be made before taking the address (this copy is in
1320 -- the current scope on the stack frame). This is used for certain cases
1321 -- of code generated by the expander that passes parameters by address.
1323 -- The reason the copy is not made by the front end is that the back end
1324 -- has more information about type layout and may be able to (but is not
1325 -- guaranteed to) prevent making unnecessary copies.
1327 -- Must_Not_Freeze (Flag8-Sem)
1328 -- A flag present in all expression nodes. Normally expressions cause
1329 -- freezing as described in the RM. If this flag is set, then this is
1330 -- inhibited. This is used by the analyzer and expander to label nodes
1331 -- that are created by semantic analysis or expansion and which must not
1332 -- cause freezing even though they normally would. This flag is also
1333 -- present in an N_Subtype_Indication node, since we also use these in
1334 -- calls to Freeze_Expression.
1336 -- Next_Entity (Node2-Sem)
1337 -- Present in defining identifiers, defining character literals and
1338 -- defining operator symbols (i.e. in all entities). The entities of a
1339 -- scope are chained, and this field is used as the forward pointer for
1340 -- this list. See Einfo for further details.
1342 -- Next_Named_Actual (Node4-Sem)
1343 -- Present in parameter association node. Set during semantic analysis to
1344 -- point to the next named parameter, where parameters are ordered by
1345 -- declaration order (as opposed to the actual order in the call, which
1346 -- may be different due to named associations). Not that this field
1347 -- points to the explicit actual parameter itself, not to the
1348 -- N_Parameter_Association node (its parent).
1350 -- Next_Rep_Item (Node5-Sem)
1351 -- Present in pragma nodes and attribute definition nodes. Used to link
1352 -- representation items that apply to an entity. See description of
1353 -- First_Rep_Item field in Einfo for full details.
1355 -- Next_Use_Clause (Node3-Sem)
1356 -- While use clauses are active during semantic processing, they are
1357 -- chained from the scope stack entry, using Next_Use_Clause as a link
1358 -- pointer, with Empty marking the end of the list. The head pointer is
1359 -- in the scope stack entry (First_Use_Clause). At the end of semantic
1360 -- processing (i.e. when Gigi sees the tree, the contents of this field
1361 -- is undefined and should not be read).
1363 -- No_Ctrl_Actions (Flag7-Sem)
1364 -- Present in N_Assignment_Statement to indicate that no finalize nor nor
1365 -- adjust should take place on this assignment eventhough the rhs is
1366 -- controlled. This is used in init procs and aggregate expansions where
1367 -- the generated assignments are more initialisations than real
1370 -- No_Elaboration_Check (Flag14-Sem)
1371 -- Present in N_Function_Call and N_Procedure_Call_Statement. Indicates
1372 -- that no elaboration check is needed on the call, because it appears in
1373 -- the context of a local Suppress pragma. This is used on calls within
1374 -- task bodies, where the actual elaboration checks are applied after
1375 -- analysis, when the local scope stack is not present.
1377 -- No_Entities_Ref_In_Spec (Flag8-Sem)
1378 -- Present in N_With_Clause nodes. Set if the with clause is on the
1379 -- package or subprogram spec where the main unit is the corresponding
1380 -- body, and no entities of the with'ed unit are referenced by the spec
1381 -- (an entity may still be referenced in the body, so this flag is used
1382 -- to generate the proper message (see Sem_Util.Check_Unused_Withs for
1385 -- No_Initialization (Flag13-Sem)
1386 -- Present in N_Object_Declaration & N_Allocator to indicate that the
1387 -- object must not be initialized (by Initialize or call to an init
1388 -- proc). This is needed for controlled aggregates. When the Object
1389 -- declaration has an expression, this flag means that this expression
1390 -- should not be taken into account (needed for in place initialization
1393 -- No_Truncation (Flag17-Sem)
1394 -- Present in N_Unchecked_Type_Conversion node. This flag has an effect
1395 -- only if the RM_Size of the source is greater than the RM_Size of the
1396 -- target for scalar operands. Normally in such a case we truncate some
1397 -- higher order bits of the source, and then sign/zero extend the result
1398 -- to form the output value. But if this flag is set, then we do not do
1399 -- any truncation, so for example, if an 8 bit input is converted to 5
1400 -- bit result which is in fact stored in 8 bits, then the high order
1401 -- three bits of the target result will be copied from the source. This
1402 -- is used for properly setting out of range values for use by pragmas
1403 -- Initialize_Scalars and Normalize_Scalars.
1405 -- Original_Discriminant (Node2-Sem)
1406 -- Present in identifiers. Used in references to discriminants that
1407 -- appear in generic units. Because the names of the discriminants may be
1408 -- different in an instance, we use this field to recover the position of
1409 -- the discriminant in the original type, and replace it with the
1410 -- discriminant at the same position in the instantiated type.
1412 -- Original_Entity (Node2-Sem)
1413 -- Present in numeric literals. Used to denote the named number that has
1414 -- been constant-folded into the given literal. If literal is from
1415 -- source, or the result of some other constant-folding operation, then
1416 -- Original_Entity is empty. This field is needed to handle properly
1417 -- named numbers in generic units, where the Associated_Node field
1418 -- interferes with the Entity field, making it impossible to preserve the
1419 -- original entity at the point of instantiation (ASIS problem).
1421 -- Others_Discrete_Choices (List1-Sem)
1422 -- When a case statement or variant is analyzed, the semantic checks
1423 -- determine the actual list of choices that correspond to an others
1424 -- choice. This list is materialized for later use by the expander and
1425 -- the Others_Discrete_Choices field of an N_Others_Choice node points to
1426 -- this materialized list of choices, which is in standard format for a
1427 -- list of discrete choices, except that of course it cannot contain an
1428 -- N_Others_Choice entry.
1430 -- Parameter_List_Truncated (Flag17-Sem)
1431 -- Present in N_Function_Call and N_Procedure_Call_Statement nodes. Set
1432 -- (for OpenVMS ports of GNAT only) if the parameter list is truncated as
1433 -- a result of a First_Optional_Parameter specification in an
1434 -- Import_Function, Import_Procedure, or Import_Valued_Procedure pragma.
1435 -- The truncation is done by the expander by removing trailing parameters
1436 -- from the argument list, in accordance with the set of rules allowing
1437 -- such parameter removal. In particular, parameters can be removed
1438 -- working from the end of the parameter list backwards up to and
1439 -- including the entry designated by First_Optional_Parameter in the
1440 -- Import pragma. Parameters can be removed if they are implicit and the
1441 -- default value is a known-at-compile-time value, including the use of
1442 -- the Null_Parameter attribute, or if explicit parameter values are
1443 -- present that match the corresponding defaults.
1445 -- Parent_Spec (Node4-Sem)
1446 -- For a library unit that is a child unit spec (package or subprogram
1447 -- declaration, generic declaration or instantiation, or library level
1448 -- rename, this field points to the compilation unit node for the parent
1449 -- package specification. This field is Empty for library bodies (the
1450 -- parent spec in this case can be found from the corresponding spec).
1452 -- Present_Expr (Uint3-Sem)
1453 -- Present in an N_Variant node. This has a meaningful value only after
1454 -- Gigi has back annotated the tree with representation information. At
1455 -- this point, it contains a reference to a gcc expression that depends
1456 -- on the values of one or more discriminants. Give a set of discriminant
1457 -- values, this expression evaluates to False (zero) if variant is not
1458 -- present, and True (non-zero) if it is present. See unit Repinfo for
1459 -- further details on gigi back annotation. This field is used during
1460 -- ASIS processing (data decomposition annex) to determine if a field is
1463 -- Print_In_Hex (Flag13-Sem)
1464 -- Set on an N_Integer_Literal node to indicate that the value should be
1465 -- printed in hexadecimal in the sprint listing. Has no effect on
1466 -- legality or semantics of program, only on the displayed output. This
1467 -- is used to clarify output from the packed array cases.
1469 -- Procedure_To_Call (Node2-Sem)
1470 -- Present in N_Allocator, N_Free_Statement, N_Simple_Return_Statement,
1471 -- and N_Extended_Return_Statement nodes. References the entity for the
1472 -- declaration of the procedure to be called to accomplish the required
1473 -- operation (i.e. for the Allocate procedure in the case of N_Allocator
1474 -- and N_Simple_Return_Statement and N_Extended_Return_Statement (for
1475 -- allocating the return value), and for the Deallocate procedure in the
1476 -- case of N_Free_Statement.
1478 -- Raises_Constraint_Error (Flag7-Sem)
1479 -- Set on an expression whose evaluation will definitely fail constraint
1480 -- error check. In the case of static expressions, this flag must be set
1481 -- accurately (and if it is set, the expression is typically illegal
1482 -- unless it appears as a non-elaborated branch of a short-circuit form).
1483 -- For a non-static expression, this flag may be set whenever an
1484 -- expression (e.g. an aggregate) is known to raise constraint error. If
1485 -- set, the expression definitely will raise CE if elaborated at runtime.
1486 -- If not set, the expression may or may not raise CE. In other words, on
1487 -- static expressions, the flag is set accurately, on non-static
1488 -- expressions it is set conservatively.
1490 -- Redundant_Use (Flag13-Sem)
1491 -- Present in nodes that can appear as an operand in a use clause or use
1492 -- type clause (identifiers, expanded names, attribute references). Set
1493 -- to indicate that a use is redundant (and therefore need not be undone
1496 -- Renaming_Exception (Node2-Sem)
1497 -- Present in N_Exception_Declaration node. Used to point back to the
1498 -- exception renaming for an exception declared within a subprogram.
1499 -- What happens is that an exception declared in a subprogram is moved
1500 -- to the library level with a unique name, and the original exception
1501 -- becomes a renaming. This link from the library level exception to the
1502 -- renaming declaration allows registering of the proper exception name.
1504 -- Return_Statement_Entity (Node5-Sem)
1505 -- Present in N_Simple_Return_Statement and N_Extended_Return_Statement.
1506 -- Points to an E_Return_Statement representing the return statement.
1508 -- Return_Object_Declarations (List3)
1509 -- Present in N_Extended_Return_Statement.
1510 -- Points to a list initially containing a single
1511 -- N_Object_Declaration representing the return object.
1512 -- We use a list (instead of just a pointer to the object decl)
1513 -- because Analyze wants to insert extra actions on this list.
1515 -- Rounded_Result (Flag18-Sem)
1516 -- Present in N_Type_Conversion, N_Op_Divide and N_Op_Multiply nodes.
1517 -- Used in the fixed-point cases to indicate that the result must be
1518 -- rounded as a result of the use of the 'Round attribute. Also used for
1519 -- integer N_Op_Divide nodes to indicate that the result should be
1520 -- rounded to the nearest integer (breaking ties away from zero), rather
1521 -- than truncated towards zero as usual. These rounded integer operations
1522 -- are the result of expansion of rounded fixed-point divide, conversion
1523 -- and multiplication operations.
1525 -- Scope (Node3-Sem)
1526 -- Present in defining identifiers, defining character literals and
1527 -- defining operator symbols (i.e. in all entities). The entities of a
1528 -- scope all use this field to reference the corresponding scope entity.
1529 -- See Einfo for further details.
1531 -- Shift_Count_OK (Flag4-Sem)
1532 -- A flag present in shift nodes to indicate that the shift count is
1533 -- known to be in range, i.e. is in the range from zero to word length
1534 -- minus one. If this flag is not set, then the shift count may be
1535 -- outside this range, i.e. larger than the word length, and the code
1536 -- must ensure that such shift counts give the appropriate result.
1538 -- Source_Type (Node1-Sem)
1539 -- Used in an N_Validate_Unchecked_Conversion node to point to the
1540 -- source type entity for the unchecked conversion instantiation
1541 -- which gigi must do size validation for.
1543 -- Static_Processing_OK (Flag4-Sem)
1544 -- Present in N_Aggregate nodes. When the Compile_Time_Known_Aggregate
1545 -- flag is set, the full value of the aggregate can be determined at
1546 -- compile time and the aggregate can be passed as is to the back-end.
1547 -- In this event it is irrelevant whether this flag is set or not.
1548 -- However, if the flag Compile_Time_Known_Aggregate is not set but
1549 -- Static_Processing_OK is set, the aggregate can (but need not) be
1550 -- converted into a compile time known aggregate by the expander. See
1551 -- Sem_Aggr for the specific conditions under which an aggregate has its
1552 -- Static_Processing_OK flag set.
1554 -- Storage_Pool (Node1-Sem)
1555 -- Present in N_Allocator, N_Free_Statement, N_Simple_Return_Statement,
1556 -- and N_Extended_Return_Statement nodes. References the entity for the
1557 -- storage pool to be used for the allocate or free call or for the
1558 -- allocation of the returned value from function. Empty indicates that
1559 -- the global default default pool is to be used. Note that in the case
1560 -- of a return statement, this field is set only if the function returns
1561 -- value of a type whose size is not known at compile time on the
1564 -- Target_Type (Node2-Sem)
1565 -- Used in an N_Validate_Unchecked_Conversion node to point to the target
1566 -- type entity for the unchecked conversion instantiation which gigi must
1567 -- do size validation for.
1569 -- Then_Actions (List3-Sem)
1570 -- This field is present in conditional expression nodes. During code
1571 -- expansion we use the Insert_Actions procedure (in Exp_Util) to insert
1572 -- actions at an appropriate place in the tree to get elaborated at the
1573 -- right time. For conditional expressions, we have to be sure that the
1574 -- actions for the Then branch are only elaborated if the condition is
1575 -- True. The Then_Actions field is used as a temporary parking place for
1576 -- these actions. The final tree is always rewritten to eliminate the
1577 -- need for this field, so in the tree passed to Gigi, this field is
1578 -- always set to No_List.
1580 -- Treat_Fixed_As_Integer (Flag14-Sem)
1581 -- This flag appears in operator nodes for divide, multiply, mod and rem
1582 -- on fixed-point operands. It indicates that the operands are to be
1583 -- treated as integer values, ignoring small values. This flag is only
1584 -- set as a result of expansion of fixed-point operations. Typically a
1585 -- fixed-point multplication in the source generates subsidiary
1586 -- multiplication and division operations that work with the underlying
1587 -- integer values and have this flag set. Note that this flag is not
1588 -- needed on other arithmetic operations (add, neg, subtract etc) since
1589 -- in these cases it is always the case that fixed is treated as integer.
1590 -- The Etype field MUST be set if this flag is set. The analyzer knows to
1591 -- leave such nodes alone, and whoever makes them must set the correct
1594 -- TSS_Elist (Elist3-Sem)
1595 -- Present in N_Freeze_Entity nodes. Holds an element list containing
1596 -- entries for each TSS (type support subprogram) associated with the
1597 -- frozen type. The elements of the list are the entities for the
1598 -- subprograms (see package Exp_TSS for further details). Set to No_Elist
1599 -- if there are no type support subprograms for the type or if the freeze
1600 -- node is not for a type.
1602 -- Unreferenced_In_Spec (Flag7-Sem)
1603 -- Present in N_With_Clause nodes. Set if the with clause is on the
1604 -- package or subprogram spec where the main unit is the corresponding
1605 -- body, and is not referenced by the spec (it may still be referenced by
1606 -- the body, so this flag is used to generate the proper message (see
1607 -- Sem_Util.Check_Unused_Withs for details)
1609 -- Was_Originally_Stub (Flag13-Sem)
1610 -- This flag is set in the node for a proper body that replaces stub.
1611 -- During the analysis procedure, stubs in some situations get rewritten
1612 -- by the corresponding bodies, and we set this flag to remember that
1613 -- this happened. Note that it is not good enough to rely on the use of
1614 -- Original_Node here because of the case of nested instantiations where
1615 -- the substituted node can be copied.
1617 -- Zero_Cost_Handling (Flag5-Sem)
1618 -- This flag is set in all handled sequence of statement and exception
1619 -- handler nodes if eceptions are to be handled using the zero-cost
1620 -- mechanism (see Ada.Exceptions and System.Exceptions in files
1621 -- a-except.ads/adb and s-except.ads for full details). What gigi needs
1622 -- to do for such a handler is simply to put the code in the handler
1623 -- somewhere. The front end has generated all necessary labels.
1625 --------------------------------------------------
1626 -- Note on Use of End_Label and End_Span Fields --
1627 --------------------------------------------------
1629 -- Several constructs have end lines:
1631 -- Loop Statement end loop [loop_IDENTIFIER];
1632 -- Package Specification end [[PARENT_UNIT_NAME .] IDENTIFIER]
1633 -- Task Definition end [task_IDENTIFIER]
1634 -- Protected Definition end [protected_IDENTIFIER]
1635 -- Protected Body end [protected_IDENTIFIER]
1637 -- Block Statement end [block_IDENTIFIER];
1638 -- Subprogram Body end [DESIGNATOR];
1639 -- Package Body end [[PARENT_UNIT_NAME .] IDENTIFIER];
1640 -- Task Body end [task_IDENTIFIER];
1641 -- Accept Statement end [entry_IDENTIFIER]];
1642 -- Entry Body end [entry_IDENTIFIER];
1644 -- If Statement end if;
1645 -- Case Statement end case;
1647 -- Record Definition end record;
1648 -- Enumeration Definition );
1650 -- The End_Label and End_Span fields are used to mark the locations of
1651 -- these lines, and also keep track of the label in the case where a label
1654 -- For the first group above, the End_Label field of the corresponding node
1655 -- is used to point to the label identifier. In the case where there is no
1656 -- label in the source, the parser supplies a dummy identifier (with
1657 -- Comes_From_Source set to False), and the Sloc of this dummy identifier
1658 -- marks the location of the token following the END token.
1660 -- For the second group, the use of End_Label is similar, but the End_Label
1661 -- is found in the N_Handled_Sequence_Of_Statements node. This is done
1662 -- simply because in some cases there is no room in the parent node.
1664 -- For the third group, there is never any label, and instead of using
1665 -- End_Label, we use the End_Span field which gives the location of the
1666 -- token following END, relative to the starting Sloc of the construct,
1667 -- i.e. add Sloc (Node) + End_Span (Node) to get the Sloc of the IF or CASE
1668 -- following the End_Label.
1670 -- The record definition case is handled specially, we treat it as though
1671 -- it required an optional label which is never present, and so the parser
1672 -- always builds a dummy identifier with Comes From Source set False. The
1673 -- reason we do this, rather than using End_Span in this case, is that we
1674 -- want to generate a cross-ref entry for the end of a record, since it
1675 -- represents a scope for name declaration purposes.
1677 -- The enumeration definition case is handled in an exactly similar manner,
1678 -- building a dummy identifier to get a cross-reference.
1680 -- Note: the reason we store the difference as a Uint, instead of storing
1681 -- the Source_Ptr value directly, is that Source_Ptr values cannot be
1682 -- distinguished from other types of values, and we count on all general
1683 -- use fields being self describing. To make things easier for clients,
1684 -- note that we provide function End_Location, and procedure
1685 -- Set_End_Location to allow access to the logical value (which is the
1686 -- Source_Ptr value for the end token).
1688 ---------------------
1689 -- Syntactic Nodes --
1690 ---------------------
1692 ---------------------
1693 -- 2.3 Identifier --
1694 ---------------------
1696 -- IDENTIFIER ::= IDENTIFIER_LETTER {[UNDERLINE] LETTER_OR_DIGIT}
1697 -- LETTER_OR_DIGIT ::= IDENTIFIER_LETTER | DIGIT
1699 -- An IDENTIFIER shall not be a reserved word
1701 -- In the Ada grammar identifiers are the bottom level tokens which have
1702 -- very few semantics. Actual program identifiers are direct names. If
1703 -- we were being 100% honest with the grammar, then we would have a node
1704 -- called N_Direct_Name which would point to an identifier. However,
1705 -- that's too many extra nodes, so we just use the N_Identifier node
1706 -- directly as a direct name, and it contains the expression fields and
1707 -- Entity field that correspond to its use as a direct name. In those
1708 -- few cases where identifiers appear in contexts where they are not
1709 -- direct names (pragmas, pragma argument associations, attribute
1710 -- references and attribute definition clauses), the Chars field of the
1711 -- node contains the Name_Id for the identifier name.
1713 -- Note: in GNAT, a reserved word can be treated as an identifier in two
1714 -- cases. First, an incorrect use of a reserved word as an identifier is
1715 -- diagnosed and then treated as a normal identifier. Second, an
1716 -- attribute designator of the form of a reserved word (access, delta,
1717 -- digits, range) is treated as an identifier.
1719 -- Note: The set of letters that is permitted in an identifier depends
1720 -- on the character set in use. See package Csets for full details.
1723 -- Sloc points to identifier
1724 -- Chars (Name1) contains the Name_Id for the identifier
1725 -- Entity (Node4-Sem)
1726 -- Associated_Node (Node4-Sem)
1727 -- Original_Discriminant (Node2-Sem)
1728 -- Redundant_Use (Flag13-Sem)
1729 -- Has_Private_View (Flag11-Sem) (set in generic units)
1730 -- plus fields for expression
1732 --------------------------
1733 -- 2.4 Numeric Literal --
1734 --------------------------
1736 -- NUMERIC_LITERAL ::= DECIMAL_LITERAL | BASED_LITERAL
1738 ----------------------------
1739 -- 2.4.1 Decimal Literal --
1740 ----------------------------
1742 -- DECIMAL_LITERAL ::= NUMERAL [.NUMERAL] [EXPONENT]
1744 -- NUMERAL ::= DIGIT {[UNDERLINE] DIGIT}
1746 -- EXPONENT ::= E [+] NUMERAL | E - NUMERAL
1748 -- Decimal literals appear in the tree as either integer literal nodes
1749 -- or real literal nodes, depending on whether a period is present.
1751 -- Note: literal nodes appear as a result of direct use of literals
1752 -- in the source program, and also as the result of evaluating
1753 -- expressions at compile time. In the latter case, it is possible
1754 -- to construct real literals that have no syntactic representation
1755 -- using the standard literal format. Such literals are listed by
1756 -- Sprint using the notation [numerator / denominator].
1758 -- Note: the value of an integer literal node created by the front end
1759 -- is never outside the range of values of the base type. However, it
1760 -- can be the case that the value is outside the range of the
1761 -- particular subtype. This happens in the case of integer overflows
1762 -- with checks suppressed.
1764 -- N_Integer_Literal
1765 -- Sloc points to literal
1766 -- Original_Entity (Node2-Sem) If not Empty, holds Named_Number that
1767 -- has been constant-folded into its literal value.
1768 -- Intval (Uint3) contains integer value of literal
1769 -- plus fields for expression
1770 -- Print_In_Hex (Flag13-Sem)
1773 -- Sloc points to literal
1774 -- Original_Entity (Node2-Sem) If not Empty, holds Named_Number that
1775 -- has been constant-folded into its literal value.
1776 -- Realval (Ureal3) contains real value of literal
1777 -- Corresponding_Integer_Value (Uint4-Sem)
1778 -- Is_Machine_Number (Flag11-Sem)
1779 -- plus fields for expression
1781 --------------------------
1782 -- 2.4.2 Based Literal --
1783 --------------------------
1785 -- BASED_LITERAL ::=
1786 -- BASE # BASED_NUMERAL [.BASED_NUMERAL] # [EXPONENT]
1790 -- BASED_NUMERAL ::=
1791 -- EXTENDED_DIGIT {[UNDERLINE] EXTENDED_DIGIT}
1793 -- EXTENDED_DIGIT ::= DIGIT | A | B | C | D | E | F
1795 -- Based literals appear in the tree as either integer literal nodes
1796 -- or real literal nodes, depending on whether a period is present.
1798 ----------------------------
1799 -- 2.5 Character Literal --
1800 ----------------------------
1802 -- CHARACTER_LITERAL ::= ' GRAPHIC_CHARACTER '
1804 -- N_Character_Literal
1805 -- Sloc points to literal
1806 -- Chars (Name1) contains the Name_Id for the identifier
1807 -- Char_Literal_Value (Uint2) contains the literal value
1808 -- Entity (Node4-Sem)
1809 -- Associated_Node (Node4-Sem)
1810 -- Has_Private_View (Flag11-Sem) set in generic units.
1811 -- plus fields for expression
1813 -- Note: the Entity field will be missing (set to Empty) for character
1814 -- literals whose type is Standard.Wide_Character or Standard.Character
1815 -- or a type derived from one of these two. In this case the character
1816 -- literal stands for its own coding. The reason we take this irregular
1817 -- short cut is to avoid the need to build lots of junk defining
1818 -- character literal nodes.
1820 -------------------------
1821 -- 2.6 String Literal --
1822 -------------------------
1824 -- STRING LITERAL ::= "{STRING_ELEMENT}"
1826 -- A STRING_ELEMENT is either a pair of quotation marks ("), or a
1827 -- single GRAPHIC_CHARACTER other than a quotation mark.
1829 -- Is_Folded_In_Parser is True if the parser created this literal by
1830 -- folding a sequence of "&" operators. For example, if the source code
1831 -- says "aaa" & "bbb" & "ccc", and this produces "aaabbbccc", the flag
1832 -- is set. This flag is needed because the parser doesn't know about
1833 -- visibility, so the folded result might be wrong, and semantic
1834 -- analysis needs to check for that.
1837 -- Sloc points to literal
1838 -- Strval (Str3) contains Id of string value
1839 -- Has_Wide_Character (Flag11-Sem)
1840 -- Is_Folded_In_Parser (Flag4)
1841 -- plus fields for expression
1847 -- A COMMENT starts with two adjacent hyphens and extends up to the
1848 -- end of the line. A COMMENT may appear on any line of a program.
1850 -- Comments are skipped by the scanner and do not appear in the tree.
1851 -- It is possible to reconstruct the position of comments with respect
1852 -- to the elements of the tree by using the source position (Sloc)
1853 -- pointers that appear in every tree node.
1859 -- PRAGMA ::= pragma IDENTIFIER
1860 -- [(PRAGMA_ARGUMENT_ASSOCIATION {, PRAGMA_ARGUMENT_ASSOCIATION})];
1862 -- Note that a pragma may appear in the tree anywhere a declaration
1863 -- or a statement may appear, as well as in some other situations
1864 -- which are explicitly documented.
1867 -- Sloc points to PRAGMA
1868 -- Chars (Name1) identifier name from pragma identifier
1869 -- Pragma_Argument_Associations (List2) (set to No_List if none)
1870 -- Debug_Statement (Node3) (set to Empty if not Debug, Assert)
1871 -- Next_Rep_Item (Node5-Sem)
1873 -- Note: we should have a section on what pragmas are passed on to
1874 -- the back end to be processed. This section should note that pragma
1875 -- Psect_Object is always converted to Common_Object, but there are
1876 -- undoubtedly many other similar notes required ???
1878 --------------------------------------
1879 -- 2.8 Pragma Argument Association --
1880 --------------------------------------
1882 -- PRAGMA_ARGUMENT_ASSOCIATION ::=
1883 -- [pragma_argument_IDENTIFIER =>] NAME
1884 -- | [pragma_argument_IDENTIFIER =>] EXPRESSION
1886 -- N_Pragma_Argument_Association
1887 -- Sloc points to first token in association
1888 -- Chars (Name1) (set to No_Name if no pragma argument identifier)
1889 -- Expression (Node3)
1891 ------------------------
1892 -- 2.9 Reserved Word --
1893 ------------------------
1895 -- Reserved words are parsed by the scanner, and returned as the
1896 -- corresponding token types (e.g. PACKAGE is returned as Tok_Package)
1898 ----------------------------
1899 -- 3.1 Basic Declaration --
1900 ----------------------------
1902 -- BASIC_DECLARATION ::=
1903 -- TYPE_DECLARATION | SUBTYPE_DECLARATION
1904 -- | OBJECT_DECLARATION | NUMBER_DECLARATION
1905 -- | SUBPROGRAM_DECLARATION | ABSTRACT_SUBPROGRAM_DECLARATION
1906 -- | PACKAGE_DECLARATION | RENAMING_DECLARATION
1907 -- | EXCEPTION_DECLARATION | GENERIC_DECLARATION
1908 -- | GENERIC_INSTANTIATION
1910 -- Basic declaration also includes IMPLICIT_LABEL_DECLARATION
1911 -- see further description in section on semantic nodes.
1913 -- Also, in the tree that is constructed, a pragma may appear
1914 -- anywhere that a declaration may appear.
1916 ------------------------------
1917 -- 3.1 Defining Identifier --
1918 ------------------------------
1920 -- DEFINING_IDENTIFIER ::= IDENTIFIER
1922 -- A defining identifier is an entity, which has additional fields
1923 -- depending on the setting of the Ekind field. These additional
1924 -- fields are defined (and access subprograms declared) in package
1927 -- Note: N_Defining_Identifier is an extended node whose fields are
1928 -- deliberate layed out to match the layout of fields in an ordinary
1929 -- N_Identifier node allowing for easy alteration of an identifier
1930 -- node into a defining identifier node. For details, see procedure
1931 -- Sinfo.CN.Change_Identifier_To_Defining_Identifier.
1933 -- N_Defining_Identifier
1934 -- Sloc points to identifier
1935 -- Chars (Name1) contains the Name_Id for the identifier
1936 -- Next_Entity (Node2-Sem)
1937 -- Scope (Node3-Sem)
1938 -- Etype (Node5-Sem)
1940 -----------------------------
1941 -- 3.2.1 Type Declaration --
1942 -----------------------------
1944 -- TYPE_DECLARATION ::=
1945 -- FULL_TYPE_DECLARATION
1946 -- | INCOMPLETE_TYPE_DECLARATION
1947 -- | PRIVATE_TYPE_DECLARATION
1948 -- | PRIVATE_EXTENSION_DECLARATION
1950 ----------------------------------
1951 -- 3.2.1 Full Type Declaration --
1952 ----------------------------------
1954 -- FULL_TYPE_DECLARATION ::=
1955 -- type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
1956 -- is TYPE_DEFINITION;
1957 -- | TASK_TYPE_DECLARATION
1958 -- | PROTECTED_TYPE_DECLARATION
1960 -- The full type declaration node is used only for the first case. The
1961 -- second case (concurrent type declaration), is represented directly
1962 -- by a task type declaration or a protected type declaration.
1964 -- N_Full_Type_Declaration
1965 -- Sloc points to TYPE
1966 -- Defining_Identifier (Node1)
1967 -- Discriminant_Specifications (List4) (set to No_List if none)
1968 -- Type_Definition (Node3)
1969 -- Discr_Check_Funcs_Built (Flag11-Sem)
1971 ----------------------------
1972 -- 3.2.1 Type Definition --
1973 ----------------------------
1975 -- TYPE_DEFINITION ::=
1976 -- ENUMERATION_TYPE_DEFINITION | INTEGER_TYPE_DEFINITION
1977 -- | REAL_TYPE_DEFINITION | ARRAY_TYPE_DEFINITION
1978 -- | RECORD_TYPE_DEFINITION | ACCESS_TYPE_DEFINITION
1979 -- | DERIVED_TYPE_DEFINITION | INTERFACE_TYPE_DEFINITION
1981 --------------------------------
1982 -- 3.2.2 Subtype Declaration --
1983 --------------------------------
1985 -- SUBTYPE_DECLARATION ::=
1986 -- subtype DEFINING_IDENTIFIER is [NULL_EXCLUSION] SUBTYPE_INDICATION;
1988 -- The subtype indication field is set to Empty for subtypes
1989 -- declared in package Standard (Positive, Natural).
1991 -- N_Subtype_Declaration
1992 -- Sloc points to SUBTYPE
1993 -- Defining_Identifier (Node1)
1994 -- Null_Exclusion_Present (Flag11)
1995 -- Subtype_Indication (Node5)
1996 -- Generic_Parent_Type (Node4-Sem) (set for an actual derived type).
1997 -- Exception_Junk (Flag8-Sem)
1999 -------------------------------
2000 -- 3.2.2 Subtype Indication --
2001 -------------------------------
2003 -- SUBTYPE_INDICATION ::= SUBTYPE_MARK [CONSTRAINT]
2005 -- Note: if no constraint is present, the subtype indication appears
2006 -- directly in the tree as a subtype mark. The N_Subtype_Indication
2007 -- node is used only if a constraint is present.
2009 -- Note: [For Ada 2005 (AI-231)]: Because Ada 2005 extends this rule
2010 -- with the null-exclusion part (see AI-231), we had to introduce a new
2011 -- attribute in all the parents of subtype_indication nodes to indicate
2012 -- if the null-exclusion is present.
2014 -- Note: the reason that this node has expression fields is that a
2015 -- subtype indication can appear as an operand of a membership test.
2017 -- N_Subtype_Indication
2018 -- Sloc points to first token of subtype mark
2019 -- Subtype_Mark (Node4)
2020 -- Constraint (Node3)
2021 -- Etype (Node5-Sem)
2022 -- Must_Not_Freeze (Flag8-Sem)
2024 -- Note: Etype is a copy of the Etype field of the Subtype_Mark. The
2025 -- reason for this redundancy is so that in a list of array index types,
2026 -- the Etype can be uniformly accessed to determine the subscript type.
2027 -- This means that no Itype is constructed for the actual subtype that
2028 -- is created by the subtype indication. If such an Itype is required,
2029 -- it is constructed in the context in which the indication appears.
2031 -------------------------
2032 -- 3.2.2 Subtype Mark --
2033 -------------------------
2035 -- SUBTYPE_MARK ::= subtype_NAME
2037 -----------------------
2038 -- 3.2.2 Constraint --
2039 -----------------------
2041 -- CONSTRAINT ::= SCALAR_CONSTRAINT | COMPOSITE_CONSTRAINT
2043 ------------------------------
2044 -- 3.2.2 Scalar Constraint --
2045 ------------------------------
2047 -- SCALAR_CONSTRAINT ::=
2048 -- RANGE_CONSTRAINT | DIGITS_CONSTRAINT | DELTA_CONSTRAINT
2050 ---------------------------------
2051 -- 3.2.2 Composite Constraint --
2052 ---------------------------------
2054 -- COMPOSITE_CONSTRAINT ::=
2055 -- INDEX_CONSTRAINT | DISCRIMINANT_CONSTRAINT
2057 -------------------------------
2058 -- 3.3.1 Object Declaration --
2059 -------------------------------
2061 -- OBJECT_DECLARATION ::=
2062 -- DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2063 -- [NULL_EXCLUSION] SUBTYPE_INDICATION [:= EXPRESSION];
2064 -- | DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2065 -- ACCESS_DEFINITION [:= EXPRESSION];
2066 -- | DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2067 -- ARRAY_TYPE_DEFINITION [:= EXPRESSION];
2068 -- | SINGLE_TASK_DECLARATION
2069 -- | SINGLE_PROTECTED_DECLARATION
2071 -- Note: aliased is not permitted in Ada 83 mode
2073 -- The N_Object_Declaration node is only for the first two cases.
2074 -- Single task declaration is handled by P_Task (9.1)
2075 -- Single protected declaration is handled by P_protected (9.5)
2077 -- Although the syntax allows multiple identifiers in the list, the
2078 -- semantics is as though successive declarations were given with
2079 -- identical type definition and expression components. To simplify
2080 -- semantic processing, the parser represents a multiple declaration
2081 -- case as a sequence of single declarations, using the More_Ids and
2082 -- Prev_Ids flags to preserve the original source form as described
2083 -- in the section on "Handling of Defining Identifier Lists".
2085 -- The flag Has_Init_Expression is set if an initializing expression
2086 -- is present. Normally it is set if and only if Expression contains
2087 -- a non-empty value, but there is an exception to this. When the
2088 -- initializing expression is an aggregate which requires explicit
2089 -- assignments, the Expression field gets set to Empty, but this flag
2090 -- is still set, so we don't forget we had an initializing expression.
2092 -- Note: if a range check is required for the initialization
2093 -- expression then the Do_Range_Check flag is set in the Expression,
2094 -- with the check being done against the type given by the object
2095 -- definition, which is also the Etype of the defining identifier.
2097 -- Note: the contents of the Expression field must be ignored (i.e.
2098 -- treated as though it were Empty) if No_Initialization is set True.
2100 -- Note: the back end places some restrictions on the form of the
2101 -- Expression field. If the object being declared is Atomic, then
2102 -- the Expression may not have the form of an aggregate (since this
2103 -- might cause the back end to generate separate assignments). It
2104 -- also cannot be a reference to an object marked as a true constant
2105 -- (Is_True_Constant flag set), where the object is itself initalized
2106 -- with an aggregate. If necessary the front end must generate an
2107 -- extra temporary (with Is_True_Constant set False), and initialize
2108 -- this temporary as required (the temporary itself is not atomic).
2110 -- Note: there is not node kind for object definition. Instead, the
2111 -- corresponding field holds a subtype indication, an array type
2112 -- definition, or (Ada 2005, AI-406) an access definition.
2114 -- N_Object_Declaration
2115 -- Sloc points to first identifier
2116 -- Defining_Identifier (Node1)
2117 -- Aliased_Present (Flag4) set if ALIASED appears
2118 -- Constant_Present (Flag17) set if CONSTANT appears
2119 -- Null_Exclusion_Present (Flag11)
2120 -- Object_Definition (Node4) subtype indic./array type def./ access def.
2121 -- Expression (Node3) (set to Empty if not present)
2122 -- Handler_List_Entry (Node2-Sem)
2123 -- Corresponding_Generic_Association (Node5-Sem)
2124 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2125 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2126 -- No_Initialization (Flag13-Sem)
2127 -- Assignment_OK (Flag15-Sem)
2128 -- Exception_Junk (Flag8-Sem)
2129 -- Is_Subprogram_Descriptor (Flag16-Sem)
2130 -- Has_Init_Expression (Flag14)
2132 -------------------------------------
2133 -- 3.3.1 Defining Identifier List --
2134 -------------------------------------
2136 -- DEFINING_IDENTIFIER_LIST ::=
2137 -- DEFINING_IDENTIFIER {, DEFINING_IDENTIFIER}
2139 -------------------------------
2140 -- 3.3.2 Number Declaration --
2141 -------------------------------
2143 -- NUMBER_DECLARATION ::=
2144 -- DEFINING_IDENTIFIER_LIST : constant := static_EXPRESSION;
2146 -- Although the syntax allows multiple identifiers in the list, the
2147 -- semantics is as though successive declarations were given with
2148 -- identical expressions. To simplify semantic processing, the parser
2149 -- represents a multiple declaration case as a sequence of single
2150 -- declarations, using the More_Ids and Prev_Ids flags to preserve
2151 -- the original source form as described in the section on "Handling
2152 -- of Defining Identifier Lists".
2154 -- N_Number_Declaration
2155 -- Sloc points to first identifier
2156 -- Defining_Identifier (Node1)
2157 -- Expression (Node3)
2158 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2159 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2161 ----------------------------------
2162 -- 3.4 Derived Type Definition --
2163 ----------------------------------
2165 -- DERIVED_TYPE_DEFINITION ::=
2166 -- [abstract] [limited] new [NULL_EXCLUSION] parent_SUBTYPE_INDICATION
2167 -- [[and INTERFACE_LIST] RECORD_EXTENSION_PART]
2169 -- Note: ABSTRACT, LIMITED and record extension part are not permitted
2172 -- Note: a record extension part is required if ABSTRACT is present
2174 -- N_Derived_Type_Definition
2175 -- Sloc points to NEW
2176 -- Abstract_Present (Flag4)
2177 -- Null_Exclusion_Present (Flag11) (set to False if not present)
2178 -- Subtype_Indication (Node5)
2179 -- Record_Extension_Part (Node3) (set to Empty if not present)
2180 -- Limited_Present (Flag17)
2181 -- Task_Present (Flag5) set in task interfaces
2182 -- Protected_Present (Flag6) set in protected interfaces
2183 -- Synchronized_Present (Flag7) set in interfaces
2184 -- Interface_List (List2) (set to No_List if none)
2185 -- Interface_Present (Flag16) set in abstract interfaces
2187 -- Note: Task_Present, Protected_Present, Synchronized_Present,
2188 -- Interface_List, and Interface_Present are used for abstract
2189 -- interfaces (see comments for INTERFACE_TYPE_DEFINITION).
2191 ---------------------------
2192 -- 3.5 Range Constraint --
2193 ---------------------------
2195 -- RANGE_CONSTRAINT ::= range RANGE
2197 -- N_Range_Constraint
2198 -- Sloc points to RANGE
2199 -- Range_Expression (Node4)
2206 -- RANGE_ATTRIBUTE_REFERENCE
2207 -- | SIMPLE_EXPRESSION .. SIMPLE_EXPRESSION
2209 -- Note: the case of a range given as a range attribute reference
2210 -- appears directly in the tree as an attribute reference.
2212 -- Note: the field name for a reference to a range is Range_Expression
2213 -- rather than Range, because range is a reserved keyword in Ada!
2215 -- Note: the reason that this node has expression fields is that a
2216 -- range can appear as an operand of a membership test. The Etype
2217 -- field is the type of the range (we do NOT construct an implicit
2218 -- subtype to represent the range exactly).
2221 -- Sloc points to ..
2222 -- Low_Bound (Node1)
2223 -- High_Bound (Node2)
2224 -- Includes_Infinities (Flag11)
2225 -- plus fields for expression
2227 -- Note: if the range appears in a context, such as a subtype
2228 -- declaration, where range checks are required on one or both of
2229 -- the expression fields, then type conversion nodes are inserted
2230 -- to represent the required checks.
2232 ----------------------------------------
2233 -- 3.5.1 Enumeration Type Definition --
2234 ----------------------------------------
2236 -- ENUMERATION_TYPE_DEFINITION ::=
2237 -- (ENUMERATION_LITERAL_SPECIFICATION
2238 -- {, ENUMERATION_LITERAL_SPECIFICATION})
2240 -- Note: the Literals field in the node described below is null for
2241 -- the case of the standard types CHARACTER and WIDE_CHARACTER, for
2242 -- which special processing handles these types as special cases.
2244 -- N_Enumeration_Type_Definition
2245 -- Sloc points to left parenthesis
2246 -- Literals (List1) (Empty for CHARACTER or WIDE_CHARACTER)
2247 -- End_Label (Node4) (set to Empty if internally generated record)
2249 ----------------------------------------------
2250 -- 3.5.1 Enumeration Literal Specification --
2251 ----------------------------------------------
2253 -- ENUMERATION_LITERAL_SPECIFICATION ::=
2254 -- DEFINING_IDENTIFIER | DEFINING_CHARACTER_LITERAL
2256 ---------------------------------------
2257 -- 3.5.1 Defining Character Literal --
2258 ---------------------------------------
2260 -- DEFINING_CHARACTER_LITERAL ::= CHARACTER_LITERAL
2262 -- A defining character literal is an entity, which has additional
2263 -- fields depending on the setting of the Ekind field. These
2264 -- additional fields are defined (and access subprograms declared)
2265 -- in package Einfo.
2267 -- Note: N_Defining_Character_Literal is an extended node whose fields
2268 -- are deliberate layed out to match the layout of fields in an ordinary
2269 -- N_Character_Literal node allowing for easy alteration of a character
2270 -- literal node into a defining character literal node. For details, see
2271 -- Sinfo.CN.Change_Character_Literal_To_Defining_Character_Literal.
2273 -- N_Defining_Character_Literal
2274 -- Sloc points to literal
2275 -- Chars (Name1) contains the Name_Id for the identifier
2276 -- Next_Entity (Node2-Sem)
2277 -- Scope (Node3-Sem)
2278 -- Etype (Node5-Sem)
2280 ------------------------------------
2281 -- 3.5.4 Integer Type Definition --
2282 ------------------------------------
2284 -- Note: there is an error in this rule in the latest version of the
2285 -- grammar, so we have retained the old rule pending clarification.
2287 -- INTEGER_TYPE_DEFINITION ::=
2288 -- SIGNED_INTEGER_TYPE_DEFINITION
2289 -- | MODULAR_TYPE_DEFINITION
2291 -------------------------------------------
2292 -- 3.5.4 Signed Integer Type Definition --
2293 -------------------------------------------
2295 -- SIGNED_INTEGER_TYPE_DEFINITION ::=
2296 -- range static_SIMPLE_EXPRESSION .. static_SIMPLE_EXPRESSION
2298 -- Note: the Low_Bound and High_Bound fields are set to Empty
2299 -- for integer types defined in package Standard.
2301 -- N_Signed_Integer_Type_Definition
2302 -- Sloc points to RANGE
2303 -- Low_Bound (Node1)
2304 -- High_Bound (Node2)
2306 ------------------------------------
2307 -- 3.5.4 Modular Type Definition --
2308 ------------------------------------
2310 -- MODULAR_TYPE_DEFINITION ::= mod static_EXPRESSION
2312 -- N_Modular_Type_Definition
2313 -- Sloc points to MOD
2314 -- Expression (Node3)
2316 ---------------------------------
2317 -- 3.5.6 Real Type Definition --
2318 ---------------------------------
2320 -- REAL_TYPE_DEFINITION ::=
2321 -- FLOATING_POINT_DEFINITION | FIXED_POINT_DEFINITION
2323 --------------------------------------
2324 -- 3.5.7 Floating Point Definition --
2325 --------------------------------------
2327 -- FLOATING_POINT_DEFINITION ::=
2328 -- digits static_SIMPLE_EXPRESSION [REAL_RANGE_SPECIFICATION]
2330 -- Note: The Digits_Expression and Real_Range_Specifications fields
2331 -- are set to Empty for floating-point types declared in Standard.
2333 -- N_Floating_Point_Definition
2334 -- Sloc points to DIGITS
2335 -- Digits_Expression (Node2)
2336 -- Real_Range_Specification (Node4) (set to Empty if not present)
2338 -------------------------------------
2339 -- 3.5.7 Real Range Specification --
2340 -------------------------------------
2342 -- REAL_RANGE_SPECIFICATION ::=
2343 -- range static_SIMPLE_EXPRESSION .. static_SIMPLE_EXPRESSION
2345 -- N_Real_Range_Specification
2346 -- Sloc points to RANGE
2347 -- Low_Bound (Node1)
2348 -- High_Bound (Node2)
2350 -----------------------------------
2351 -- 3.5.9 Fixed Point Definition --
2352 -----------------------------------
2354 -- FIXED_POINT_DEFINITION ::=
2355 -- ORDINARY_FIXED_POINT_DEFINITION | DECIMAL_FIXED_POINT_DEFINITION
2357 --------------------------------------------
2358 -- 3.5.9 Ordinary Fixed Point Definition --
2359 --------------------------------------------
2361 -- ORDINARY_FIXED_POINT_DEFINITION ::=
2362 -- delta static_EXPRESSION REAL_RANGE_SPECIFICATION
2364 -- Note: In Ada 83, the EXPRESSION must be a SIMPLE_EXPRESSION
2366 -- N_Ordinary_Fixed_Point_Definition
2367 -- Sloc points to DELTA
2368 -- Delta_Expression (Node3)
2369 -- Real_Range_Specification (Node4)
2371 -------------------------------------------
2372 -- 3.5.9 Decimal Fixed Point Definition --
2373 -------------------------------------------
2375 -- DECIMAL_FIXED_POINT_DEFINITION ::=
2376 -- delta static_EXPRESSION
2377 -- digits static_EXPRESSION [REAL_RANGE_SPECIFICATION]
2379 -- Note: decimal types are not permitted in Ada 83 mode
2381 -- N_Decimal_Fixed_Point_Definition
2382 -- Sloc points to DELTA
2383 -- Delta_Expression (Node3)
2384 -- Digits_Expression (Node2)
2385 -- Real_Range_Specification (Node4) (set to Empty if not present)
2387 ------------------------------
2388 -- 3.5.9 Digits Constraint --
2389 ------------------------------
2391 -- DIGITS_CONSTRAINT ::=
2392 -- digits static_EXPRESSION [RANGE_CONSTRAINT]
2394 -- Note: in Ada 83, the EXPRESSION must be a SIMPLE_EXPRESSION
2395 -- Note: in Ada 95, reduced accuracy subtypes are obsolescent
2397 -- N_Digits_Constraint
2398 -- Sloc points to DIGITS
2399 -- Digits_Expression (Node2)
2400 -- Range_Constraint (Node4) (set to Empty if not present)
2402 --------------------------------
2403 -- 3.6 Array Type Definition --
2404 --------------------------------
2406 -- ARRAY_TYPE_DEFINITION ::=
2407 -- UNCONSTRAINED_ARRAY_DEFINITION | CONSTRAINED_ARRAY_DEFINITION
2409 -----------------------------------------
2410 -- 3.6 Unconstrained Array Definition --
2411 -----------------------------------------
2413 -- UNCONSTRAINED_ARRAY_DEFINITION ::=
2414 -- array (INDEX_SUBTYPE_DEFINITION {, INDEX_SUBTYPE_DEFINITION}) of
2415 -- COMPONENT_DEFINITION
2417 -- Note: dimensionality of array is indicated by number of entries in
2418 -- the Subtype_Marks list, which has one entry for each dimension.
2420 -- N_Unconstrained_Array_Definition
2421 -- Sloc points to ARRAY
2422 -- Subtype_Marks (List2)
2423 -- Component_Definition (Node4)
2425 -----------------------------------
2426 -- 3.6 Index Subtype Definition --
2427 -----------------------------------
2429 -- INDEX_SUBTYPE_DEFINITION ::= SUBTYPE_MARK range <>
2431 -- There is no explicit node in the tree for an index subtype
2432 -- definition since the N_Unconstrained_Array_Definition node
2433 -- incorporates the type marks which appear in this context.
2435 ---------------------------------------
2436 -- 3.6 Constrained Array Definition --
2437 ---------------------------------------
2439 -- CONSTRAINED_ARRAY_DEFINITION ::=
2440 -- array (DISCRETE_SUBTYPE_DEFINITION
2441 -- {, DISCRETE_SUBTYPE_DEFINITION})
2442 -- of COMPONENT_DEFINITION
2444 -- Note: dimensionality of array is indicated by number of entries
2445 -- in the Discrete_Subtype_Definitions list, which has one entry
2446 -- for each dimension.
2448 -- N_Constrained_Array_Definition
2449 -- Sloc points to ARRAY
2450 -- Discrete_Subtype_Definitions (List2)
2451 -- Component_Definition (Node4)
2453 --------------------------------------
2454 -- 3.6 Discrete Subtype Definition --
2455 --------------------------------------
2457 -- DISCRETE_SUBTYPE_DEFINITION ::=
2458 -- discrete_SUBTYPE_INDICATION | RANGE
2460 -------------------------------
2461 -- 3.6 Component Definition --
2462 -------------------------------
2464 -- COMPONENT_DEFINITION ::=
2465 -- [aliased] [NULL_EXCLUSION] SUBTYPE_INDICATION | ACCESS_DEFINITION
2467 -- Note: although the syntax does not permit a component definition to
2468 -- be an anonymous array (and the parser will diagnose such an attempt
2469 -- with an appropriate message), it is possible for anonymous arrays
2470 -- to appear as component definitions. The semantics and back end handle
2471 -- this case properly, and the expander in fact generates such cases.
2472 -- Access_Definition is an optional field that gives support to
2473 -- Ada 2005 (AI-230). The parser generates nodes that have either the
2474 -- Subtype_Indication field or else the Access_Definition field.
2476 -- N_Component_Definition
2477 -- Sloc points to ALIASED, ACCESS or to first token of subtype mark
2478 -- Aliased_Present (Flag4)
2479 -- Null_Exclusion_Present (Flag11)
2480 -- Subtype_Indication (Node5) (set to Empty if not present)
2481 -- Access_Definition (Node3) (set to Empty if not present)
2483 -----------------------------
2484 -- 3.6.1 Index Constraint --
2485 -----------------------------
2487 -- INDEX_CONSTRAINT ::= (DISCRETE_RANGE {, DISCRETE_RANGE})
2489 -- It is not in general possible to distinguish between discriminant
2490 -- constraints and index constraints at parse time, since a simple
2491 -- name could be either the subtype mark of a discrete range, or an
2492 -- expression in a discriminant association with no name. Either
2493 -- entry appears simply as the name, and the semantic parse must
2494 -- distinguish between the two cases. Thus we use a common tree
2495 -- node format for both of these constraint types.
2497 -- See Discriminant_Constraint for format of node
2499 ---------------------------
2500 -- 3.6.1 Discrete Range --
2501 ---------------------------
2503 -- DISCRETE_RANGE ::= discrete_SUBTYPE_INDICATION | RANGE
2505 ----------------------------
2506 -- 3.7 Discriminant Part --
2507 ----------------------------
2509 -- DISCRIMINANT_PART ::=
2510 -- UNKNOWN_DISCRIMINANT_PART | KNOWN_DISCRIMINANT_PART
2512 ------------------------------------
2513 -- 3.7 Unknown Discriminant Part --
2514 ------------------------------------
2516 -- UNKNOWN_DISCRIMINANT_PART ::= (<>)
2518 -- Note: unknown discriminant parts are not permitted in Ada 83 mode
2520 -- There is no explicit node in the tree for an unknown discriminant
2521 -- part. Instead the Unknown_Discriminants_Present flag is set in the
2524 ----------------------------------
2525 -- 3.7 Known Discriminant Part --
2526 ----------------------------------
2528 -- KNOWN_DISCRIMINANT_PART ::=
2529 -- (DISCRIMINANT_SPECIFICATION {; DISCRIMINANT_SPECIFICATION})
2531 -------------------------------------
2532 -- 3.7 Discriminant Specification --
2533 -------------------------------------
2535 -- DISCRIMINANT_SPECIFICATION ::=
2536 -- DEFINING_IDENTIFIER_LIST : [NULL_EXCLUSION] SUBTYPE_MARK
2537 -- [:= DEFAULT_EXPRESSION]
2538 -- | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
2539 -- [:= DEFAULT_EXPRESSION]
2541 -- Although the syntax allows multiple identifiers in the list, the
2542 -- semantics is as though successive specifications were given with
2543 -- identical type definition and expression components. To simplify
2544 -- semantic processing, the parser represents a multiple declaration
2545 -- case as a sequence of single specifications, using the More_Ids and
2546 -- Prev_Ids flags to preserve the original source form as described
2547 -- in the section on "Handling of Defining Identifier Lists".
2549 -- N_Discriminant_Specification
2550 -- Sloc points to first identifier
2551 -- Defining_Identifier (Node1)
2552 -- Null_Exclusion_Present (Flag11)
2553 -- Discriminant_Type (Node5) subtype mark or access parameter definition
2554 -- Expression (Node3) (set to Empty if no default expression)
2555 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2556 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2558 -----------------------------
2559 -- 3.7 Default Expression --
2560 -----------------------------
2562 -- DEFAULT_EXPRESSION ::= EXPRESSION
2564 ------------------------------------
2565 -- 3.7.1 Discriminant Constraint --
2566 ------------------------------------
2568 -- DISCRIMINANT_CONSTRAINT ::=
2569 -- (DISCRIMINANT_ASSOCIATION {, DISCRIMINANT_ASSOCIATION})
2571 -- It is not in general possible to distinguish between discriminant
2572 -- constraints and index constraints at parse time, since a simple
2573 -- name could be either the subtype mark of a discrete range, or an
2574 -- expression in a discriminant association with no name. Either
2575 -- entry appears simply as the name, and the semantic parse must
2576 -- distinguish between the two cases. Thus we use a common tree
2577 -- node format for both of these constraint types.
2579 -- N_Index_Or_Discriminant_Constraint
2580 -- Sloc points to left paren
2581 -- Constraints (List1) points to list of discrete ranges or
2582 -- discriminant associations
2584 -------------------------------------
2585 -- 3.7.1 Discriminant Association --
2586 -------------------------------------
2588 -- DISCRIMINANT_ASSOCIATION ::=
2589 -- [discriminant_SELECTOR_NAME
2590 -- {| discriminant_SELECTOR_NAME} =>] EXPRESSION
2592 -- Note: a discriminant association that has no selector name list
2593 -- appears directly as an expression in the tree.
2595 -- N_Discriminant_Association
2596 -- Sloc points to first token of discriminant association
2597 -- Selector_Names (List1) (always non-empty, since if no selector
2598 -- names are present, this node is not used, see comment above)
2599 -- Expression (Node3)
2601 ---------------------------------
2602 -- 3.8 Record Type Definition --
2603 ---------------------------------
2605 -- RECORD_TYPE_DEFINITION ::=
2606 -- [[abstract] tagged] [limited] RECORD_DEFINITION
2608 -- Note: ABSTRACT, TAGGED, LIMITED are not permitted in Ada 83 mode
2610 -- There is no explicit node in the tree for a record type definition.
2611 -- Instead the flags for Tagged_Present and Limited_Present appear in
2612 -- the N_Record_Definition node for a record definition appearing in
2613 -- the context of a record type definition.
2615 ----------------------------
2616 -- 3.8 Record Definition --
2617 ----------------------------
2619 -- RECORD_DEFINITION ::=
2625 -- Note: the Abstract_Present, Tagged_Present and Limited_Present
2626 -- flags appear only for a record definition appearing in a record
2629 -- Note: the NULL RECORD case is not permitted in Ada 83
2631 -- N_Record_Definition
2632 -- Sloc points to RECORD or NULL
2633 -- End_Label (Node4) (set to Empty if internally generated record)
2634 -- Abstract_Present (Flag4)
2635 -- Tagged_Present (Flag15)
2636 -- Limited_Present (Flag17)
2637 -- Component_List (Node1) empty in null record case
2638 -- Null_Present (Flag13) set in null record case
2639 -- Task_Present (Flag5) set in task interfaces
2640 -- Protected_Present (Flag6) set in protected interfaces
2641 -- Synchronized_Present (Flag7) set in interfaces
2642 -- Interface_Present (Flag16) set in abstract interfaces
2643 -- Interface_List (List2) (set to No_List if none)
2645 -- Note: Task_Present, Protected_Present, Synchronized _Present,
2646 -- Interface_List and Interface_Present are used for abstract
2647 -- interfaces (see comments for INTERFACE_TYPE_DEFINITION).
2649 -------------------------
2650 -- 3.8 Component List --
2651 -------------------------
2653 -- COMPONENT_LIST ::=
2654 -- COMPONENT_ITEM {COMPONENT_ITEM}
2655 -- | {COMPONENT_ITEM} VARIANT_PART
2659 -- Sloc points to first token of component list
2660 -- Component_Items (List3)
2661 -- Variant_Part (Node4) (set to Empty if no variant part)
2662 -- Null_Present (Flag13)
2664 -------------------------
2665 -- 3.8 Component Item --
2666 -------------------------
2668 -- COMPONENT_ITEM ::= COMPONENT_DECLARATION | REPRESENTATION_CLAUSE
2670 -- Note: A component item can also be a pragma, and in the tree
2671 -- that is obtained after semantic processing, a component item
2672 -- can be an N_Null node resulting from a non-recognized pragma.
2674 --------------------------------
2675 -- 3.8 Component Declaration --
2676 --------------------------------
2678 -- COMPONENT_DECLARATION ::=
2679 -- DEFINING_IDENTIFIER_LIST : COMPONENT_DEFINITION
2680 -- [:= DEFAULT_EXPRESSION]
2682 -- Note: although the syntax does not permit a component definition to
2683 -- be an anonymous array (and the parser will diagnose such an attempt
2684 -- with an appropriate message), it is possible for anonymous arrays
2685 -- to appear as component definitions. The semantics and back end handle
2686 -- this case properly, and the expander in fact generates such cases.
2688 -- Although the syntax allows multiple identifiers in the list, the
2689 -- semantics is as though successive declarations were given with the
2690 -- same component definition and expression components. To simplify
2691 -- semantic processing, the parser represents a multiple declaration
2692 -- case as a sequence of single declarations, using the More_Ids and
2693 -- Prev_Ids flags to preserve the original source form as described
2694 -- in the section on "Handling of Defining Identifier Lists".
2696 -- N_Component_Declaration
2697 -- Sloc points to first identifier
2698 -- Defining_Identifier (Node1)
2699 -- Component_Definition (Node4)
2700 -- Expression (Node3) (set to Empty if no default expression)
2701 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2702 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2704 -------------------------
2705 -- 3.8.1 Variant Part --
2706 -------------------------
2709 -- case discriminant_DIRECT_NAME is
2714 -- Note: the variants list can contain pragmas as well as variants.
2715 -- In a properly formed program there is at least one variant.
2718 -- Sloc points to CASE
2722 --------------------
2724 --------------------
2727 -- when DISCRETE_CHOICE_LIST =>
2731 -- Sloc points to WHEN
2732 -- Discrete_Choices (List4)
2733 -- Component_List (Node1)
2734 -- Enclosing_Variant (Node2-Sem)
2735 -- Present_Expr (Uint3-Sem)
2736 -- Dcheck_Function (Node5-Sem)
2738 ---------------------------------
2739 -- 3.8.1 Discrete Choice List --
2740 ---------------------------------
2742 -- DISCRETE_CHOICE_LIST ::= DISCRETE_CHOICE {| DISCRETE_CHOICE}
2744 ----------------------------
2745 -- 3.8.1 Discrete Choice --
2746 ----------------------------
2748 -- DISCRETE_CHOICE ::= EXPRESSION | DISCRETE_RANGE | others
2750 -- Note: in Ada 83 mode, the expression must be a simple expression
2752 -- The only choice that appears explicitly is the OTHERS choice, as
2753 -- defined here. Other cases of discrete choice (expression and
2754 -- discrete range) appear directly. This production is also used
2755 -- for the OTHERS possibility of an exception choice.
2757 -- Note: in accordance with the syntax, the parser does not check that
2758 -- OTHERS appears at the end on its own in a choice list context. This
2759 -- is a semantic check.
2762 -- Sloc points to OTHERS
2763 -- Others_Discrete_Choices (List1-Sem)
2764 -- All_Others (Flag11-Sem)
2766 ----------------------------------
2767 -- 3.9.1 Record Extension Part --
2768 ----------------------------------
2770 -- RECORD_EXTENSION_PART ::= with RECORD_DEFINITION
2772 -- Note: record extension parts are not permitted in Ada 83 mode
2774 --------------------------------------
2775 -- 3.9.4 Interface Type Definition --
2776 --------------------------------------
2778 -- INTERFACE_TYPE_DEFINITION ::=
2779 -- [limited | task | protected | synchronized]
2780 -- interface [interface_list]
2782 -- Note: Interfaces are implemented with N_Record_Definition and
2783 -- N_Derived_Type_Definition nodes because most of the support
2784 -- for the analysis of abstract types has been reused to
2785 -- analyze abstract interfaces.
2787 ----------------------------------
2788 -- 3.10 Access Type Definition --
2789 ----------------------------------
2791 -- ACCESS_TYPE_DEFINITION ::=
2792 -- ACCESS_TO_OBJECT_DEFINITION
2793 -- | ACCESS_TO_SUBPROGRAM_DEFINITION
2795 --------------------------
2796 -- 3.10 Null Exclusion --
2797 --------------------------
2799 -- NULL_EXCLUSION ::= not null
2801 ---------------------------------------
2802 -- 3.10 Access To Object Definition --
2803 ---------------------------------------
2805 -- ACCESS_TO_OBJECT_DEFINITION ::=
2806 -- [NULL_EXCLUSION] access [GENERAL_ACCESS_MODIFIER]
2807 -- SUBTYPE_INDICATION
2809 -- N_Access_To_Object_Definition
2810 -- Sloc points to ACCESS
2811 -- All_Present (Flag15)
2812 -- Null_Exclusion_Present (Flag11)
2813 -- Subtype_Indication (Node5)
2814 -- Constant_Present (Flag17)
2816 -----------------------------------
2817 -- 3.10 General Access Modifier --
2818 -----------------------------------
2820 -- GENERAL_ACCESS_MODIFIER ::= all | constant
2822 -- Note: general access modifiers are not permitted in Ada 83 mode
2824 -- There is no explicit node in the tree for general access modifier.
2825 -- Instead the All_Present or Constant_Present flags are set in the
2828 -------------------------------------------
2829 -- 3.10 Access To Subprogram Definition --
2830 -------------------------------------------
2832 -- ACCESS_TO_SUBPROGRAM_DEFINITION
2833 -- [NULL_EXCLUSION] access [protected] procedure PARAMETER_PROFILE
2834 -- | [NULL_EXCLUSION] access [protected] function
2835 -- PARAMETER_AND_RESULT_PROFILE
2837 -- Note: access to subprograms are not permitted in Ada 83 mode
2839 -- N_Access_Function_Definition
2840 -- Sloc points to ACCESS
2841 -- Null_Exclusion_Present (Flag11)
2842 -- Protected_Present (Flag6)
2843 -- Parameter_Specifications (List3) (set to No_List if no formal part)
2844 -- Result_Definition (Node4) result subtype (subtype mark or access def)
2846 -- N_Access_Procedure_Definition
2847 -- Sloc points to ACCESS
2848 -- Null_Exclusion_Present (Flag11)
2849 -- Protected_Present (Flag6)
2850 -- Parameter_Specifications (List3) (set to No_List if no formal part)
2852 -----------------------------
2853 -- 3.10 Access Definition --
2854 -----------------------------
2856 -- ACCESS_DEFINITION ::=
2857 -- [NULL_EXCLUSION] access [GENERAL_ACCESS_MODIFIER] SUBTYPE_MARK
2858 -- | ACCESS_TO_SUBPROGRAM_DEFINITION
2860 -- Note: access to subprograms are an Ada 2005 (AI-254) extension
2862 -- N_Access_Definition
2863 -- Sloc points to ACCESS
2864 -- Null_Exclusion_Present (Flag11)
2865 -- All_Present (Flag15)
2866 -- Constant_Present (Flag17)
2867 -- Subtype_Mark (Node4)
2868 -- Access_To_Subprogram_Definition (Node3) (set to Empty if not present)
2870 -----------------------------------------
2871 -- 3.10.1 Incomplete Type Declaration --
2872 -----------------------------------------
2874 -- INCOMPLETE_TYPE_DECLARATION ::=
2875 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART] [IS TAGGED];
2877 -- N_Incomplete_Type_Declaration
2878 -- Sloc points to TYPE
2879 -- Defining_Identifier (Node1)
2880 -- Discriminant_Specifications (List4) (set to No_List if no
2881 -- discriminant part, or if the discriminant part is an
2882 -- unknown discriminant part)
2883 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
2884 -- Tagged_Present (Flag15)
2886 ----------------------------
2887 -- 3.11 Declarative Part --
2888 ----------------------------
2890 -- DECLARATIVE_PART ::= {DECLARATIVE_ITEM}
2892 -- Note: although the parser enforces the syntactic requirement that
2893 -- a declarative part can contain only declarations, the semantic
2894 -- processing may add statements to the list of actions in a
2895 -- declarative part, so the code generator should be prepared
2896 -- to accept a statement in this position.
2898 ----------------------------
2899 -- 3.11 Declarative Item --
2900 ----------------------------
2902 -- DECLARATIVE_ITEM ::= BASIC_DECLARATIVE_ITEM | BODY
2904 ----------------------------------
2905 -- 3.11 Basic Declarative Item --
2906 ----------------------------------
2908 -- BASIC_DECLARATIVE_ITEM ::=
2909 -- BASIC_DECLARATION | REPRESENTATION_CLAUSE | USE_CLAUSE
2915 -- BODY ::= PROPER_BODY | BODY_STUB
2917 -----------------------
2918 -- 3.11 Proper Body --
2919 -----------------------
2922 -- SUBPROGRAM_BODY | PACKAGE_BODY | TASK_BODY | PROTECTED_BODY
2929 -- DIRECT_NAME | EXPLICIT_DEREFERENCE
2930 -- | INDEXED_COMPONENT | SLICE
2931 -- | SELECTED_COMPONENT | ATTRIBUTE_REFERENCE
2932 -- | TYPE_CONVERSION | FUNCTION_CALL
2933 -- | CHARACTER_LITERAL
2935 ----------------------
2936 -- 4.1 Direct Name --
2937 ----------------------
2939 -- DIRECT_NAME ::= IDENTIFIER | OPERATOR_SYMBOL
2945 -- PREFIX ::= NAME | IMPLICIT_DEREFERENCE
2947 -------------------------------
2948 -- 4.1 Explicit Dereference --
2949 -------------------------------
2951 -- EXPLICIT_DEREFERENCE ::= NAME . all
2953 -- N_Explicit_Dereference
2954 -- Sloc points to ALL
2956 -- Actual_Designated_Subtype (Node4-Sem)
2957 -- plus fields for expression
2959 -------------------------------
2960 -- 4.1 Implicit Dereference --
2961 -------------------------------
2963 -- IMPLICIT_DEREFERENCE ::= NAME
2965 ------------------------------
2966 -- 4.1.1 Indexed Component --
2967 ------------------------------
2969 -- INDEXED_COMPONENT ::= PREFIX (EXPRESSION {, EXPRESSION})
2971 -- Note: the parser may generate this node in some situations where it
2972 -- should be a function call. The semantic pass must correct this
2973 -- misidentification (which is inevitable at the parser level).
2975 -- N_Indexed_Component
2976 -- Sloc contains a copy of the Sloc value of the Prefix
2978 -- Expressions (List1)
2979 -- plus fields for expression
2981 -- Note: if any of the subscripts requires a range check, then the
2982 -- Do_Range_Check flag is set on the corresponding expression, with
2983 -- the index type being determined from the type of the Prefix, which
2984 -- references the array being indexed.
2986 -- Note: in a fully analyzed and expanded indexed component node, and
2987 -- hence in any such node that gigi sees, if the prefix is an access
2988 -- type, then an explicit dereference operation has been inserted.
2994 -- SLICE ::= PREFIX (DISCRETE_RANGE)
2996 -- Note: an implicit subtype is created to describe the resulting
2997 -- type, so that the bounds of this type are the bounds of the slice.
3000 -- Sloc points to first token of prefix
3002 -- Discrete_Range (Node4)
3003 -- plus fields for expression
3005 -------------------------------
3006 -- 4.1.3 Selected Component --
3007 -------------------------------
3009 -- SELECTED_COMPONENT ::= PREFIX . SELECTOR_NAME
3011 -- Note: selected components that are semantically expanded names get
3012 -- changed during semantic processing into the separate N_Expanded_Name
3013 -- node. See description of this node in the section on semantic nodes.
3015 -- N_Selected_Component
3016 -- Sloc points to period
3018 -- Selector_Name (Node2)
3019 -- Associated_Node (Node4-Sem)
3020 -- Do_Discriminant_Check (Flag13-Sem)
3021 -- Is_In_Discriminant_Check (Flag11-Sem)
3022 -- plus fields for expression
3024 --------------------------
3025 -- 4.1.3 Selector Name --
3026 --------------------------
3028 -- SELECTOR_NAME ::= IDENTIFIER | CHARACTER_LITERAL | OPERATOR_SYMBOL
3030 --------------------------------
3031 -- 4.1.4 Attribute Reference --
3032 --------------------------------
3034 -- ATTRIBUTE_REFERENCE ::= PREFIX ' ATTRIBUTE_DESIGNATOR
3036 -- Note: the syntax is quite ambiguous at this point. Consider:
3038 -- A'Length (X) X is part of the attribute designator
3039 -- A'Pos (X) X is an explicit actual parameter of function A'Pos
3040 -- A'Class (X) X is the expression of a type conversion
3042 -- It would be possible for the parser to distinguish these cases
3043 -- by looking at the attribute identifier. However, that would mean
3044 -- more work in introducing new implementation defined attributes,
3045 -- and also it would mean that special processing for attributes
3046 -- would be scattered around, instead of being centralized in the
3047 -- semantic routine that handles an N_Attribute_Reference node.
3048 -- Consequently, the parser in all the above cases stores the
3049 -- expression (X in these examples) as a single element list in
3050 -- in the Expressions field of the N_Attribute_Reference node.
3052 -- Similarly, for attributes like Max which take two arguments,
3053 -- we store the two arguments as a two element list in the
3054 -- Expressions field. Of course it is clear at parse time that
3055 -- this case is really a function call with an attribute as the
3056 -- prefix, but it turns out to be convenient to handle the two
3057 -- argument case in a similar manner to the one argument case,
3058 -- and indeed in general the parser will accept any number of
3059 -- expressions in this position and store them as a list in the
3060 -- attribute reference node. This allows for future addition of
3061 -- attributes that take more than two arguments.
3063 -- Note: named associates are not permitted in function calls where
3064 -- the function is an attribute (see RM 6.4(3)) so it is legitimate
3065 -- to skip the normal subprogram argument processing.
3067 -- Note: for the attributes whose designators are technically keywords,
3068 -- i.e. digits, access, delta, range, the Attribute_Name field contains
3069 -- the corresponding name, even though no identifier is involved.
3071 -- Note: the generated code may contain stream attributes applied to
3072 -- limited types for which no stream routines exist officially. In such
3073 -- case, the result is to use the stream attribute for the underlying
3074 -- full type, or in the case of a protected type, the components
3075 -- (including any disriminants) are merely streamed in order.
3077 -- See Exp_Attr for a complete description of which attributes are
3078 -- passed onto Gigi, and which are handled entirely by the front end.
3080 -- Gigi restriction: For the Pos attribute, the prefix cannot be
3081 -- a non-standard enumeration type or a nonzero/zero semantics
3082 -- boolean type, so the value is simply the stored representation.
3084 -- Gigi requirement: For the Mechanism_Code attribute, if the prefix
3085 -- references a subprogram that is a renaming, then the front end must
3086 -- rewrite the attribute to refer directly to the renamed entity.
3088 -- Note: In generated code, the Address and Unrestricted_Access
3089 -- attributes can be applied to any expression, and the meaning is
3090 -- to create an object containing the value (the object is in the
3091 -- current stack frame), and pass the address of this value. If the
3092 -- Must_Be_Byte_Aligned flag is set, then the object whose address
3093 -- is taken must be on a byte (storage unit) boundary, and if it is
3094 -- not (or may not be), then the generated code must create a copy
3095 -- that is byte aligned, and pass the address of this copy.
3097 -- N_Attribute_Reference
3098 -- Sloc points to apostrophe
3100 -- Attribute_Name (Name2) identifier name from attribute designator
3101 -- Expressions (List1) (set to No_List if no associated expressions)
3102 -- Entity (Node4-Sem) used if the attribute yields a type
3103 -- Associated_Node (Node4-Sem)
3104 -- Do_Overflow_Check (Flag17-Sem)
3105 -- Redundant_Use (Flag13-Sem)
3106 -- Must_Be_Byte_Aligned (Flag14)
3107 -- plus fields for expression
3109 ---------------------------------
3110 -- 4.1.4 Attribute Designator --
3111 ---------------------------------
3113 -- ATTRIBUTE_DESIGNATOR ::=
3114 -- IDENTIFIER [(static_EXPRESSION)]
3115 -- | access | delta | digits
3117 -- There is no explicit node in the tree for an attribute designator.
3118 -- Instead the Attribute_Name and Expressions fields of the parent
3119 -- node (N_Attribute_Reference node) hold the information.
3121 -- Note: if ACCESS, DELTA or DIGITS appears in an attribute
3122 -- designator, then they are treated as identifiers internally
3123 -- rather than the keywords of the same name.
3125 --------------------------------------
3126 -- 4.1.4 Range Attribute Reference --
3127 --------------------------------------
3129 -- RANGE_ATTRIBUTE_REFERENCE ::= PREFIX ' RANGE_ATTRIBUTE_DESIGNATOR
3131 -- A range attribute reference is represented in the tree using the
3132 -- normal N_Attribute_Reference node.
3134 ---------------------------------------
3135 -- 4.1.4 Range Attribute Designator --
3136 ---------------------------------------
3138 -- RANGE_ATTRIBUTE_DESIGNATOR ::= Range [(static_EXPRESSION)]
3140 -- A range attribute designator is represented in the tree using the
3141 -- normal N_Attribute_Reference node.
3143 --------------------
3145 --------------------
3148 -- RECORD_AGGREGATE | EXTENSION_AGGREGATE | ARRAY_AGGREGATE
3150 -----------------------------
3151 -- 4.3.1 Record Aggregate --
3152 -----------------------------
3154 -- RECORD_AGGREGATE ::= (RECORD_COMPONENT_ASSOCIATION_LIST)
3157 -- Sloc points to left parenthesis
3158 -- Expressions (List1) (set to No_List if none or null record case)
3159 -- Component_Associations (List2) (set to No_List if none)
3160 -- Null_Record_Present (Flag17)
3161 -- Aggregate_Bounds (Node3-Sem)
3162 -- Associated_Node (Node4-Sem)
3163 -- Static_Processing_OK (Flag4-Sem)
3164 -- Compile_Time_Known_Aggregate (Flag18-Sem)
3165 -- Expansion_Delayed (Flag11-Sem)
3166 -- Has_Self_Reference (Flag13-Sem)
3167 -- plus fields for expression
3169 -- Note: this structure is used for both record and array aggregates
3170 -- since the two cases are not separable by the parser. The parser
3171 -- makes no attempt to enforce consistency here, so it is up to the
3172 -- semantic phase to make sure that the aggregate is consistent (i.e.
3173 -- that it is not a "half-and-half" case that mixes record and array
3174 -- syntax. In particular, for a record aggregate, the expressions
3175 -- field will be set if there are positional associations.
3177 -- Note: N_Aggregate is not used for all aggregates; in particular,
3178 -- there is a separate node kind for extension aggregates.
3180 -- Note: gigi/gcc can handle array aggregates correctly providing that
3181 -- they are entirely positional, and the array subtype involved has a
3182 -- known at compile time length and is not bit packed, or a convention
3183 -- Fortran array with more than one dimension. If these conditions
3184 -- are not met, then the front end must translate the aggregate into
3185 -- an appropriate set of assignments into a temporary.
3187 -- Note: for the record aggregate case, gigi/gcc can handle all cases
3188 -- of record aggregates, including those for packed, and rep-claused
3189 -- records, and also variant records, providing that there are no
3190 -- variable length fields whose size is not known at runtime, and
3191 -- providing that the aggregate is presented in fully named form.
3193 ----------------------------------------------
3194 -- 4.3.1 Record Component Association List --
3195 ----------------------------------------------
3197 -- RECORD_COMPONENT_ASSOCIATION_LIST ::=
3198 -- RECORD_COMPONENT_ASSOCIATION {, RECORD_COMPONENT_ASSOCIATION}
3201 -- There is no explicit node in the tree for a record component
3202 -- association list. Instead the Null_Record_Present flag is set in
3203 -- the parent node for the NULL RECORD case.
3205 ------------------------------------------------------
3206 -- 4.3.1 Record Component Association (also 4.3.3) --
3207 ------------------------------------------------------
3209 -- RECORD_COMPONENT_ASSOCIATION ::=
3210 -- [COMPONENT_CHOICE_LIST =>] EXPRESSION
3212 -- N_Component_Association
3213 -- Sloc points to first selector name
3215 -- Loop_Actions (List2-Sem)
3216 -- Expression (Node3)
3217 -- Box_Present (Flag15)
3219 -- Note: this structure is used for both record component associations
3220 -- and array component associations, since the two cases aren't always
3221 -- separable by the parser. The choices list may represent either a
3222 -- list of selector names in the record aggregate case, or a list of
3223 -- discrete choices in the array aggregate case or an N_Others_Choice
3224 -- node (which appears as a singleton list). Box_Present gives support
3225 -- to Ada 2005 (AI-287).
3227 -----------------------------------
3228 -- 4.3.1 Commponent Choice List --
3229 -----------------------------------
3231 -- COMPONENT_CHOICE_LIST ::=
3232 -- component_SELECTOR_NAME {| component_SELECTOR_NAME}
3235 -- The entries of a component choice list appear in the Choices list
3236 -- of the associated N_Component_Association, as either selector
3237 -- names, or as an N_Others_Choice node.
3239 --------------------------------
3240 -- 4.3.2 Extension Aggregate --
3241 --------------------------------
3243 -- EXTENSION_AGGREGATE ::=
3244 -- (ANCESTOR_PART with RECORD_COMPONENT_ASSOCIATION_LIST)
3246 -- Note: extension aggregates are not permitted in Ada 83 mode
3248 -- N_Extension_Aggregate
3249 -- Sloc points to left parenthesis
3250 -- Ancestor_Part (Node3)
3251 -- Associated_Node (Node4-Sem)
3252 -- Expressions (List1) (set to No_List if none or null record case)
3253 -- Component_Associations (List2) (set to No_List if none)
3254 -- Null_Record_Present (Flag17)
3255 -- Expansion_Delayed (Flag11-Sem)
3256 -- Has_Self_Reference (Flag13-Sem)
3257 -- plus fields for expression
3259 --------------------------
3260 -- 4.3.2 Ancestor Part --
3261 --------------------------
3263 -- ANCESTOR_PART ::= EXPRESSION | SUBTYPE_MARK
3265 ----------------------------
3266 -- 4.3.3 Array Aggregate --
3267 ----------------------------
3269 -- ARRAY_AGGREGATE ::=
3270 -- POSITIONAL_ARRAY_AGGREGATE | NAMED_ARRAY_AGGREGATE
3272 ---------------------------------------
3273 -- 4.3.3 Positional Array Aggregate --
3274 ---------------------------------------
3276 -- POSITIONAL_ARRAY_AGGREGATE ::=
3277 -- (EXPRESSION, EXPRESSION {, EXPRESSION})
3278 -- | (EXPRESSION {, EXPRESSION}, others => EXPRESSION)
3280 -- See Record_Aggregate (4.3.1) for node structure
3282 ----------------------------------
3283 -- 4.3.3 Named Array Aggregate --
3284 ----------------------------------
3286 -- NAMED_ARRAY_AGGREGATE ::=
3287 -- | (ARRAY_COMPONENT_ASSOCIATION {, ARRAY_COMPONENT_ASSOCIATION})
3289 -- See Record_Aggregate (4.3.1) for node structure
3291 ----------------------------------------
3292 -- 4.3.3 Array Component Association --
3293 ----------------------------------------
3295 -- ARRAY_COMPONENT_ASSOCIATION ::=
3296 -- DISCRETE_CHOICE_LIST => EXPRESSION
3298 -- See Record_Component_Association (4.3.1) for node structure
3300 --------------------------------------------------
3301 -- 4.4 Expression/Relation/Term/Factor/Primary --
3302 --------------------------------------------------
3305 -- RELATION {and RELATION} | RELATION {and then RELATION}
3306 -- | RELATION {or RELATION} | RELATION {or else RELATION}
3307 -- | RELATION {xor RELATION}
3310 -- SIMPLE_EXPRESSION [RELATIONAL_OPERATOR SIMPLE_EXPRESSION]
3311 -- | SIMPLE_EXPRESSION [not] in RANGE
3312 -- | SIMPLE_EXPRESSION [not] in SUBTYPE_MARK
3314 -- SIMPLE_EXPRESSION ::=
3315 -- [UNARY_ADDING_OPERATOR] TERM {BINARY_ADDING_OPERATOR TERM}
3317 -- TERM ::= FACTOR {MULTIPLYING_OPERATOR FACTOR}
3319 -- FACTOR ::= PRIMARY [** PRIMARY] | abs PRIMARY | not PRIMARY
3321 -- No nodes are generated for any of these constructs. Instead, the
3322 -- node for the operator appears directly. When we refer to an
3323 -- expression in this description, we mean any of the possible
3324 -- consistuent components of an expression (e.g. identifier is
3325 -- an example of an expression).
3332 -- NUMERIC_LITERAL | null
3333 -- | STRING_LITERAL | AGGREGATE
3334 -- | NAME | QUALIFIED_EXPRESSION
3335 -- | ALLOCATOR | (EXPRESSION)
3337 -- Usually there is no explicit node in the tree for primary. Instead
3338 -- the constituent (e.g. AGGREGATE) appears directly. There are two
3339 -- exceptions. First, there is an explicit node for a null primary.
3342 -- Sloc points to NULL
3343 -- plus fields for expression
3345 -- Second, the case of (EXPRESSION) is handled specially. Ada requires
3346 -- that the parser keep track of which subexpressions are enclosed
3347 -- in parentheses, and how many levels of parentheses are used. This
3348 -- information is required for optimization purposes, and also for
3349 -- some semantic checks (e.g. (((1))) in a procedure spec does not
3350 -- conform with ((((1)))) in the body).
3352 -- The parentheses are recorded by keeping a Paren_Count field in every
3353 -- subexpression node (it is actually present in all nodes, but only
3354 -- used in subexpression nodes). This count records the number of
3355 -- levels of parentheses. If the number of levels in the source exceeds
3356 -- the maximum accomodated by this count, then the count is simply left
3357 -- at the maximum value. This means that there are some pathalogical
3358 -- cases of failure to detect conformance failures (e.g. an expression
3359 -- with 500 levels of parens will conform with one with 501 levels),
3360 -- but we do not need to lose sleep over this.
3362 -- Historical note: in versions of GNAT prior to 1.75, there was a node
3363 -- type N_Parenthesized_Expression used to accurately record unlimited
3364 -- numbers of levels of parentheses. However, it turned out to be a
3365 -- real nuisance to have to take into account the possible presence of
3366 -- this node during semantic analysis, since basically parentheses have
3367 -- zero relevance to semantic analysis.
3369 -- Note: the level of parentheses always present in things like
3370 -- aggregates does not count, only the parentheses in the primary
3371 -- (EXPRESSION) affect the setting of the Paren_Count field.
3373 -- 2nd Note: the contents of the Expression field must be ignored (i.e.
3374 -- treated as though it were Empty) if No_Initialization is set True.
3376 --------------------------------------
3377 -- 4.5 Short Circuit Control Forms --
3378 --------------------------------------
3381 -- RELATION {and then RELATION} | RELATION {or else RELATION}
3383 -- Gigi restriction: For both these control forms, the operand and
3384 -- result types are always Standard.Boolean. The expander inserts the
3385 -- required conversion operations where needed to ensure this is the
3389 -- Sloc points to AND of AND THEN
3390 -- Left_Opnd (Node2)
3391 -- Right_Opnd (Node3)
3392 -- Actions (List1-Sem)
3393 -- plus fields for expression
3396 -- Sloc points to OR of OR ELSE
3397 -- Left_Opnd (Node2)
3398 -- Right_Opnd (Node3)
3399 -- Actions (List1-Sem)
3400 -- plus fields for expression
3402 -- Note: The Actions field is used to hold actions associated with
3403 -- the right hand operand. These have to be treated specially since
3404 -- they are not unconditionally executed. See Insert_Actions for a
3405 -- more detailed description of how these actions are handled.
3407 ---------------------------
3408 -- 4.5 Membership Tests --
3409 ---------------------------
3412 -- SIMPLE_EXPRESSION [not] in RANGE
3413 -- | SIMPLE_EXPRESSION [not] in SUBTYPE_MARK
3415 -- Note: although the grammar above allows only a range or a
3416 -- subtype mark, the parser in fact will accept any simple
3417 -- expression in place of a subtype mark. This means that the
3418 -- semantic analyzer must be prepared to deal with, and diagnose
3419 -- a simple expression other than a name for the right operand.
3420 -- This simplifies error recovery in the parser.
3423 -- Sloc points to IN
3424 -- Left_Opnd (Node2)
3425 -- Right_Opnd (Node3)
3426 -- plus fields for expression
3429 -- Sloc points to NOT of NOT IN
3430 -- Left_Opnd (Node2)
3431 -- Right_Opnd (Node3)
3432 -- plus fields for expression
3434 --------------------
3436 --------------------
3438 -- LOGICAL_OPERATOR ::= and | or | xor
3440 -- RELATIONAL_OPERATOR ::= = | /= | < | <= | > | >=
3442 -- BINARY_ADDING_OPERATOR ::= + | - | &
3444 -- UNARY_ADDING_OPERATOR ::= + | -
3446 -- MULTIPLYING_OPERATOR ::= * | / | mod | rem
3448 -- HIGHEST_PRECEDENCE_OPERATOR ::= ** | abs | not
3450 -- Sprint syntax if Treat_Fixed_As_Integer is set:
3457 -- Gigi restriction: For * / mod rem with fixed-point operands, Gigi
3458 -- will only be given nodes with the Treat_Fixed_As_Integer flag set.
3459 -- All handling of smalls for multiplication and division is handled
3460 -- by the front end (mod and rem result only from expansion). Gigi
3461 -- thus never needs to worry about small values (for other operators
3462 -- operating on fixed-point, e.g. addition, the small value does not
3463 -- have any semantic effect anyway, these are always integer operations.
3465 -- Gigi restriction: For all operators taking Boolean operands, the
3466 -- type is always Standard.Boolean. The expander inserts the required
3467 -- conversion operations where needed to ensure this is the case.
3470 -- Sloc points to AND
3471 -- Do_Length_Check (Flag4-Sem)
3472 -- plus fields for binary operator
3473 -- plus fields for expression
3476 -- Sloc points to OR
3477 -- Do_Length_Check (Flag4-Sem)
3478 -- plus fields for binary operator
3479 -- plus fields for expression
3482 -- Sloc points to XOR
3483 -- Do_Length_Check (Flag4-Sem)
3484 -- plus fields for binary operator
3485 -- plus fields for expression
3489 -- plus fields for binary operator
3490 -- plus fields for expression
3493 -- Sloc points to /=
3494 -- plus fields for binary operator
3495 -- plus fields for expression
3499 -- plus fields for binary operator
3500 -- plus fields for expression
3503 -- Sloc points to <=
3504 -- plus fields for binary operator
3505 -- plus fields for expression
3509 -- plus fields for binary operator
3510 -- plus fields for expression
3513 -- Sloc points to >=
3514 -- plus fields for binary operator
3515 -- plus fields for expression
3518 -- Sloc points to + (binary)
3519 -- plus fields for binary operator
3520 -- plus fields for expression
3523 -- Sloc points to - (binary)
3524 -- plus fields for binary operator
3525 -- plus fields for expression
3529 -- Is_Component_Left_Opnd (Flag13-Sem)
3530 -- Is_Component_Right_Opnd (Flag14-Sem)
3531 -- plus fields for binary operator
3532 -- plus fields for expression
3536 -- Treat_Fixed_As_Integer (Flag14-Sem)
3537 -- Rounded_Result (Flag18-Sem)
3538 -- plus fields for binary operator
3539 -- plus fields for expression
3543 -- Treat_Fixed_As_Integer (Flag14-Sem)
3544 -- Do_Division_Check (Flag13-Sem)
3545 -- Rounded_Result (Flag18-Sem)
3546 -- plus fields for binary operator
3547 -- plus fields for expression
3550 -- Sloc points to MOD
3551 -- Treat_Fixed_As_Integer (Flag14-Sem)
3552 -- Do_Division_Check (Flag13-Sem)
3553 -- plus fields for binary operator
3554 -- plus fields for expression
3557 -- Sloc points to REM
3558 -- Treat_Fixed_As_Integer (Flag14-Sem)
3559 -- Do_Division_Check (Flag13-Sem)
3560 -- plus fields for binary operator
3561 -- plus fields for expression
3564 -- Is_Power_Of_2_For_Shift (Flag13-Sem)
3565 -- Sloc points to **
3566 -- plus fields for binary operator
3567 -- plus fields for expression
3570 -- Sloc points to + (unary)
3571 -- plus fields for unary operator
3572 -- plus fields for expression
3575 -- Sloc points to - (unary)
3576 -- plus fields for unary operator
3577 -- plus fields for expression
3580 -- Sloc points to ABS
3581 -- plus fields for unary operator
3582 -- plus fields for expression
3585 -- Sloc points to NOT
3586 -- plus fields for unary operator
3587 -- plus fields for expression
3589 -- See also shift operators in section B.2
3591 -- Note on fixed-point operations passed to Gigi: For adding operators,
3592 -- the semantics is to treat these simply as integer operations, with
3593 -- the small values being ignored (the bounds are already stored in
3594 -- units of small, so that constraint checking works as usual). For the
3595 -- case of multiply/divide/rem/mod operations, Gigi will only see fixed
3596 -- point operands if the Treat_Fixed_As_Integer flag is set and will
3597 -- thus treat these nodes in identical manner, ignoring small values.
3599 --------------------------
3600 -- 4.6 Type Conversion --
3601 --------------------------
3603 -- TYPE_CONVERSION ::=
3604 -- SUBTYPE_MARK (EXPRESSION) | SUBTYPE_MARK (NAME)
3606 -- In the (NAME) case, the name is stored as the expression
3608 -- Note: the parser never generates a type conversion node, since it
3609 -- looks like an indexed component which is generated by preference.
3610 -- The semantic pass must correct this misidentification.
3612 -- Gigi handles conversions that involve no change in the root type,
3613 -- and also all conversions from integer to floating-point types.
3614 -- Conversions from floating-point to integer are only handled in
3615 -- the case where Float_Truncate flag set. Other conversions from
3616 -- floating-point to integer (involving rounding) and all conversions
3617 -- involving fixed-point types are handled by the expander.
3619 -- Sprint syntax if Float_Truncate set: X^(Y)
3620 -- Sprint syntax if Conversion_OK set X?(Y)
3621 -- Sprint syntax if both flags set X?^(Y)
3623 -- Note: If either the operand or result type is fixed-point, Gigi will
3624 -- only see a type conversion node with Conversion_OK set. The front end
3625 -- takes care of all handling of small's for fixed-point conversions.
3627 -- N_Type_Conversion
3628 -- Sloc points to first token of subtype mark
3629 -- Subtype_Mark (Node4)
3630 -- Expression (Node3)
3631 -- Do_Tag_Check (Flag13-Sem)
3632 -- Do_Length_Check (Flag4-Sem)
3633 -- Do_Overflow_Check (Flag17-Sem)
3634 -- Float_Truncate (Flag11-Sem)
3635 -- Rounded_Result (Flag18-Sem)
3636 -- Conversion_OK (Flag14-Sem)
3637 -- plus fields for expression
3639 -- Note: if a range check is required, then the Do_Range_Check flag
3640 -- is set in the Expression with the check being done against the
3641 -- target type range (after the base type conversion, if any).
3643 -------------------------------
3644 -- 4.7 Qualified Expression --
3645 -------------------------------
3647 -- QUALIFIED_EXPRESSION ::=
3648 -- SUBTYPE_MARK ' (EXPRESSION) | SUBTYPE_MARK ' AGGREGATE
3650 -- Note: the parentheses in the (EXPRESSION) case are deemed to enclose
3651 -- the expression, so the Expression field of this node always points
3652 -- to a parenthesized expression in this case (i.e. Paren_Count will
3653 -- always be non-zero for the referenced expression if it is not an
3656 -- N_Qualified_Expression
3657 -- Sloc points to apostrophe
3658 -- Subtype_Mark (Node4)
3659 -- Expression (Node3) expression or aggregate
3660 -- plus fields for expression
3662 --------------------
3664 --------------------
3667 -- new [NULL_EXCLUSION] SUBTYPE_INDICATION | new QUALIFIED_EXPRESSION
3669 -- Sprint syntax (when storage pool present)
3670 -- new xxx (storage_pool = pool)
3673 -- Sloc points to NEW
3674 -- Expression (Node3) subtype indication or qualified expression
3675 -- Null_Exclusion_Present (Flag11)
3676 -- Storage_Pool (Node1-Sem)
3677 -- Procedure_To_Call (Node2-Sem)
3678 -- Coextensions (Elist4-Sem)
3679 -- No_Initialization (Flag13-Sem)
3680 -- Is_Static_Coextension (Flag14-Sem)
3681 -- Do_Storage_Check (Flag17-Sem)
3682 -- Is_Dynamic_Coextension (Flag18-Sem)
3683 -- plus fields for expression
3685 ---------------------------------
3686 -- 5.1 Sequence Of Statements --
3687 ---------------------------------
3689 -- SEQUENCE_OF_STATEMENTS ::= STATEMENT {STATEMENT}
3691 -- Note: Although the parser will not accept a declaration as a
3692 -- statement, the semantic analyzer may insert declarations (e.g.
3693 -- declarations of implicit types needed for execution of other
3694 -- statements) into a sequence of statements, so the code genmerator
3695 -- should be prepared to accept a declaration where a statement is
3696 -- expected. Note also that pragmas can appear as statements.
3698 --------------------
3700 --------------------
3703 -- {LABEL} SIMPLE_STATEMENT | {LABEL} COMPOUND_STATEMENT
3705 -- There is no explicit node in the tree for a statement. Instead, the
3706 -- individual statement appears directly. Labels are treated as a
3707 -- kind of statement, i.e. they are linked into a statement list at
3708 -- the point they appear, so the labeled statement appears following
3709 -- the label or labels in the statement list.
3711 ---------------------------
3712 -- 5.1 Simple Statement --
3713 ---------------------------
3715 -- SIMPLE_STATEMENT ::= NULL_STATEMENT
3716 -- | ASSIGNMENT_STATEMENT | EXIT_STATEMENT
3717 -- | GOTO_STATEMENT | PROCEDURE_CALL_STATEMENT
3718 -- | SIMPLE_RETURN_STATEMENT | ENTRY_CALL_STATEMENT
3719 -- | REQUEUE_STATEMENT | DELAY_STATEMENT
3720 -- | ABORT_STATEMENT | RAISE_STATEMENT
3723 -----------------------------
3724 -- 5.1 Compound Statement --
3725 -----------------------------
3727 -- COMPOUND_STATEMENT ::=
3728 -- IF_STATEMENT | CASE_STATEMENT
3729 -- | LOOP_STATEMENT | BLOCK_STATEMENT
3730 -- | EXTENDED_RETURN_STATEMENT
3731 -- | ACCEPT_STATEMENT | SELECT_STATEMENT
3733 -------------------------
3734 -- 5.1 Null Statement --
3735 -------------------------
3737 -- NULL_STATEMENT ::= null;
3740 -- Sloc points to NULL
3746 -- LABEL ::= <<label_STATEMENT_IDENTIFIER>>
3748 -- Note that the occurrence of a label is not a defining identifier,
3749 -- but rather a referencing occurrence. The defining occurrence is
3750 -- in the implicit label declaration which occurs in the innermost
3754 -- Sloc points to <<
3755 -- Identifier (Node1) direct name of statement identifier
3756 -- Exception_Junk (Flag8-Sem)
3758 -------------------------------
3759 -- 5.1 Statement Identifier --
3760 -------------------------------
3762 -- STATEMENT_INDENTIFIER ::= DIRECT_NAME
3764 -- The IDENTIFIER of a STATEMENT_IDENTIFIER shall be an identifier
3765 -- (not an OPERATOR_SYMBOL)
3767 -------------------------------
3768 -- 5.2 Assignment Statement --
3769 -------------------------------
3771 -- ASSIGNMENT_STATEMENT ::=
3772 -- variable_NAME := EXPRESSION;
3774 -- N_Assignment_Statement
3775 -- Sloc points to :=
3777 -- Expression (Node3)
3778 -- Do_Tag_Check (Flag13-Sem)
3779 -- Do_Length_Check (Flag4-Sem)
3780 -- Forwards_OK (Flag5-Sem)
3781 -- Backwards_OK (Flag6-Sem)
3782 -- No_Ctrl_Actions (Flag7-Sem)
3784 -- Note: if a range check is required, then the Do_Range_Check flag
3785 -- is set in the Expression (right hand side), with the check being
3786 -- done against the type of the Name (left hand side).
3788 -- Note: the back end places some restrictions on the form of the
3789 -- Expression field. If the object being assigned to is Atomic, then
3790 -- the Expression may not have the form of an aggregate (since this
3791 -- might cause the back end to generate separate assignments). It
3792 -- also cannot be a reference to an object marked as a true constant
3793 -- (Is_True_Constant flag set), where the object is itself initalized
3794 -- with an aggregate. If necessary the front end must generate an
3795 -- extra temporary (with Is_True_Constant set False), and initialize
3796 -- this temporary as required (the temporary itself is not atomic).
3798 -----------------------
3799 -- 5.3 If Statement --
3800 -----------------------
3803 -- if CONDITION then
3804 -- SEQUENCE_OF_STATEMENTS
3805 -- {elsif CONDITION then
3806 -- SEQUENCE_OF_STATEMENTS}
3808 -- SEQUENCE_OF_STATEMENTS]
3811 -- Gigi restriction: This expander ensures that the type of the
3812 -- Condition fields is always Standard.Boolean, even if the type
3813 -- in the source is some non-standard boolean type.
3816 -- Sloc points to IF
3817 -- Condition (Node1)
3818 -- Then_Statements (List2)
3819 -- Elsif_Parts (List3) (set to No_List if none present)
3820 -- Else_Statements (List4) (set to No_List if no else part present)
3821 -- End_Span (Uint5) (set to No_Uint if expander generated)
3824 -- Sloc points to ELSIF
3825 -- Condition (Node1)
3826 -- Then_Statements (List2)
3827 -- Condition_Actions (List3-Sem)
3829 --------------------
3831 --------------------
3833 -- CONDITION ::= boolean_EXPRESSION
3835 -------------------------
3836 -- 5.4 Case Statement --
3837 -------------------------
3839 -- CASE_STATEMENT ::=
3840 -- case EXPRESSION is
3841 -- CASE_STATEMENT_ALTERNATIVE
3842 -- {CASE_STATEMENT_ALTERNATIVE}
3845 -- Note: the Alternatives can contain pragmas. These only occur at
3846 -- the start of the list, since any pragmas occurring after the first
3847 -- alternative are absorbed into the corresponding statement sequence.
3850 -- Sloc points to CASE
3851 -- Expression (Node3)
3852 -- Alternatives (List4)
3853 -- End_Span (Uint5) (set to No_Uint if expander generated)
3855 -------------------------------------
3856 -- 5.4 Case Statement Alternative --
3857 -------------------------------------
3859 -- CASE_STATEMENT_ALTERNATIVE ::=
3860 -- when DISCRETE_CHOICE_LIST =>
3861 -- SEQUENCE_OF_STATEMENTS
3863 -- N_Case_Statement_Alternative
3864 -- Sloc points to WHEN
3865 -- Discrete_Choices (List4)
3866 -- Statements (List3)
3868 -------------------------
3869 -- 5.5 Loop Statement --
3870 -------------------------
3872 -- LOOP_STATEMENT ::=
3873 -- [loop_STATEMENT_IDENTIFIER :]
3874 -- [ITERATION_SCHEME] loop
3875 -- SEQUENCE_OF_STATEMENTS
3876 -- end loop [loop_IDENTIFIER];
3878 -- Note: The occurrence of a loop label is not a defining identifier
3879 -- but rather a referencing occurrence. The defining occurrence is in
3880 -- the implicit label declaration which occurs in the innermost
3883 -- Note: there is always a loop statement identifier present in
3884 -- the tree, even if none was given in the source. In the case where
3885 -- no loop identifier is given in the source, the parser creates
3886 -- a name of the form _Loop_n, where n is a decimal integer (the
3887 -- two underlines ensure that the loop names created in this manner
3888 -- do not conflict with any user defined identifiers), and the flag
3889 -- Has_Created_Identifier is set to True. The only exception to the
3890 -- rule that all loop statement nodes have identifiers occurs for
3891 -- loops constructed by the expander, and the semantic analyzer will
3892 -- create and supply dummy loop identifiers in these cases.
3895 -- Sloc points to LOOP
3896 -- Identifier (Node1) loop identifier (set to Empty if no identifier)
3897 -- Iteration_Scheme (Node2) (set to Empty if no iteration scheme)
3898 -- Statements (List3)
3899 -- End_Label (Node4)
3900 -- Has_Created_Identifier (Flag15)
3901 -- Is_Null_Loop (Flag16)
3903 --------------------------
3904 -- 5.5 Iteration Scheme --
3905 --------------------------
3907 -- ITERATION_SCHEME ::=
3908 -- while CONDITION | for LOOP_PARAMETER_SPECIFICATION
3910 -- Gigi restriction: This expander ensures that the type of the
3911 -- Condition field is always Standard.Boolean, even if the type
3912 -- in the source is some non-standard boolean type.
3914 -- N_Iteration_Scheme
3915 -- Sloc points to WHILE or FOR
3916 -- Condition (Node1) (set to Empty if FOR case)
3917 -- Condition_Actions (List3-Sem)
3918 -- Loop_Parameter_Specification (Node4) (set to Empty if WHILE case)
3920 ---------------------------------------
3921 -- 5.5 Loop parameter specification --
3922 ---------------------------------------
3924 -- LOOP_PARAMETER_SPECIFICATION ::=
3925 -- DEFINING_IDENTIFIER in [reverse] DISCRETE_SUBTYPE_DEFINITION
3927 -- N_Loop_Parameter_Specification
3928 -- Sloc points to first identifier
3929 -- Defining_Identifier (Node1)
3930 -- Reverse_Present (Flag15)
3931 -- Discrete_Subtype_Definition (Node4)
3933 --------------------------
3934 -- 5.6 Block Statement --
3935 --------------------------
3937 -- BLOCK_STATEMENT ::=
3938 -- [block_STATEMENT_IDENTIFIER:]
3940 -- DECLARATIVE_PART]
3942 -- HANDLED_SEQUENCE_OF_STATEMENTS
3943 -- end [block_IDENTIFIER];
3945 -- Note that the occurrence of a block identifier is not a defining
3946 -- identifier, but rather a referencing occurrence. The defining
3947 -- occurrence is an E_Block entity declared by the implicit label
3948 -- declaration which occurs in the innermost enclosing block statement
3949 -- or body; the block identifier denotes that E_Block.
3951 -- For block statements that come from source code, there is always a
3952 -- block statement identifier present in the tree, denoting an
3953 -- E_Block. In the case where no block identifier is given in the
3954 -- source, the parser creates a name of the form B_n, where n is a
3955 -- decimal integer, and the flag Has_Created_Identifier is set to
3956 -- True. Blocks constructed by the expander usually have no identifier,
3957 -- and no corresponding entity.
3959 -- Note: the block statement created for an extended return statement
3960 -- has an entity, and this entity is an E_Return_Statement, rather than
3961 -- the usual E_Block.
3963 -- Note: Exception_Junk is set for the wrapping blocks created during
3964 -- local raise optimization (Exp_Ch11.Expand_Local_Exception_Handlers).
3966 -- N_Block_Statement
3967 -- Sloc points to DECLARE or BEGIN
3968 -- Identifier (Node1) block direct name (set to Empty if not present)
3969 -- Declarations (List2) (set to No_List if no DECLARE part)
3970 -- Handled_Statement_Sequence (Node4)
3971 -- Is_Task_Master (Flag5-Sem)
3972 -- Activation_Chain_Entity (Node3-Sem)
3973 -- Has_Created_Identifier (Flag15)
3974 -- Is_Task_Allocation_Block (Flag6)
3975 -- Is_Asynchronous_Call_Block (Flag7)
3976 -- Exception_Junk (Flag8-Sem)
3978 -------------------------
3979 -- 5.7 Exit Statement --
3980 -------------------------
3982 -- EXIT_STATEMENT ::= exit [loop_NAME] [when CONDITION];
3984 -- Gigi restriction: This expander ensures that the type of the
3985 -- Condition field is always Standard.Boolean, even if the type
3986 -- in the source is some non-standard boolean type.
3989 -- Sloc points to EXIT
3990 -- Name (Node2) (set to Empty if no loop name present)
3991 -- Condition (Node1) (set to Empty if no when part present)
3993 -------------------------
3994 -- 5.9 Goto Statement --
3995 -------------------------
3997 -- GOTO_STATEMENT ::= goto label_NAME;
4000 -- Sloc points to GOTO
4002 -- Exception_Junk (Flag8-Sem)
4004 ---------------------------------
4005 -- 6.1 Subprogram Declaration --
4006 ---------------------------------
4008 -- SUBPROGRAM_DECLARATION ::= SUBPROGRAM_SPECIFICATION;
4010 -- N_Subprogram_Declaration
4011 -- Sloc points to FUNCTION or PROCEDURE
4012 -- Specification (Node1)
4013 -- Body_To_Inline (Node3-Sem)
4014 -- Corresponding_Body (Node5-Sem)
4015 -- Parent_Spec (Node4-Sem)
4017 ------------------------------------------
4018 -- 6.1 Abstract Subprogram Declaration --
4019 ------------------------------------------
4021 -- ABSTRACT_SUBPROGRAM_DECLARATION ::=
4022 -- SUBPROGRAM_SPECIFICATION is abstract;
4024 -- N_Abstract_Subprogram_Declaration
4025 -- Sloc points to ABSTRACT
4026 -- Specification (Node1)
4028 -----------------------------------
4029 -- 6.1 Subprogram Specification --
4030 -----------------------------------
4032 -- SUBPROGRAM_SPECIFICATION ::=
4033 -- [[not] overriding]
4034 -- procedure DEFINING_PROGRAM_UNIT_NAME PARAMETER_PROFILE
4035 -- | [[not] overriding]
4036 -- function DEFINING_DESIGNATOR PARAMETER_AND_RESULT_PROFILE
4038 -- Note: there are no separate nodes for the profiles, instead the
4039 -- information appears directly in the following nodes.
4041 -- N_Function_Specification
4042 -- Sloc points to FUNCTION
4043 -- Defining_Unit_Name (Node1) (the designator)
4044 -- Elaboration_Boolean (Node2-Sem)
4045 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4046 -- Null_Exclusion_Present (Flag11)
4047 -- Result_Definition (Node4) for result subtype
4048 -- Generic_Parent (Node5-Sem)
4049 -- Must_Override (Flag14) set if overriding indicator present
4050 -- Must_Not_Override (Flag15) set if not_overriding indicator present
4052 -- N_Procedure_Specification
4053 -- Sloc points to PROCEDURE
4054 -- Defining_Unit_Name (Node1)
4055 -- Elaboration_Boolean (Node2-Sem)
4056 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4057 -- Generic_Parent (Node5-Sem)
4058 -- Null_Present (Flag13) set for null procedure case (Ada 2005 feature)
4059 -- Must_Override (Flag14) set if overriding indicator present
4060 -- Must_Not_Override (Flag15) set if not_overriding indicator present
4062 -- Note: overriding indicator is an Ada 2005 feature
4064 ---------------------
4065 -- 6.1 Designator --
4066 ---------------------
4069 -- [PARENT_UNIT_NAME .] IDENTIFIER | OPERATOR_SYMBOL
4071 -- Designators that are simply identifiers or operator symbols appear
4072 -- directly in the tree in this form. The following node is used only
4073 -- in the case where the designator has a parent unit name component.
4076 -- Sloc points to period
4077 -- Name (Node2) holds the parent unit name. Note that this is always
4078 -- non-Empty, since this node is only used for the case where a
4079 -- parent library unit package name is present.
4080 -- Identifier (Node1)
4082 -- Note that the identifier can also be an operator symbol here
4084 ------------------------------
4085 -- 6.1 Defining Designator --
4086 ------------------------------
4088 -- DEFINING_DESIGNATOR ::=
4089 -- DEFINING_PROGRAM_UNIT_NAME | DEFINING_OPERATOR_SYMBOL
4091 -------------------------------------
4092 -- 6.1 Defining Program Unit Name --
4093 -------------------------------------
4095 -- DEFINING_PROGRAM_UNIT_NAME ::=
4096 -- [PARENT_UNIT_NAME .] DEFINING_IDENTIFIER
4098 -- The parent unit name is present only in the case of a child unit
4099 -- name (permissible only for Ada 95 for a library level unit, i.e.
4100 -- a unit at scope level one). If no such name is present, the defining
4101 -- program unit name is represented simply as the defining identifier.
4102 -- In the child unit case, the following node is used to represent the
4105 -- N_Defining_Program_Unit_Name
4106 -- Sloc points to period
4107 -- Name (Node2) holds the parent unit name. Note that this is always
4108 -- non-Empty, since this node is only used for the case where a
4109 -- parent unit name is present.
4110 -- Defining_Identifier (Node1)
4112 --------------------------
4113 -- 6.1 Operator Symbol --
4114 --------------------------
4116 -- OPERATOR_SYMBOL ::= STRING_LITERAL
4118 -- Note: the fields of the N_Operator_Symbol node are laid out to
4119 -- match the corresponding fields of an N_Character_Literal node. This
4120 -- allows easy conversion of the operator symbol node into a character
4121 -- literal node in the case where a string constant of the form of an
4122 -- operator symbol is scanned out as such, but turns out semantically
4123 -- to be a string literal that is not an operator. For details see
4124 -- Sinfo.CN.Change_Operator_Symbol_To_String_Literal.
4126 -- N_Operator_Symbol
4127 -- Sloc points to literal
4128 -- Chars (Name1) contains the Name_Id for the operator symbol
4129 -- Strval (Str3) Id of string value. This is used if the operator
4130 -- symbol turns out to be a normal string after all.
4131 -- Entity (Node4-Sem)
4132 -- Associated_Node (Node4-Sem)
4133 -- Has_Private_View (Flag11-Sem) set in generic units.
4134 -- Etype (Node5-Sem)
4136 -- Note: the Strval field may be set to No_String for generated
4137 -- operator symbols that are known not to be string literals
4140 -----------------------------------
4141 -- 6.1 Defining Operator Symbol --
4142 -----------------------------------
4144 -- DEFINING_OPERATOR_SYMBOL ::= OPERATOR_SYMBOL
4146 -- A defining operator symbol is an entity, which has additional
4147 -- fields depending on the setting of the Ekind field. These
4148 -- additional fields are defined (and access subprograms declared)
4149 -- in package Einfo.
4151 -- Note: N_Defining_Operator_Symbol is an extended node whose fields
4152 -- are deliberately layed out to match the layout of fields in an
4153 -- ordinary N_Operator_Symbol node allowing for easy alteration of
4154 -- an operator symbol node into a defining operator symbol node.
4155 -- See Sinfo.CN.Change_Operator_Symbol_To_Defining_Operator_Symbol
4156 -- for further details.
4158 -- N_Defining_Operator_Symbol
4159 -- Sloc points to literal
4160 -- Chars (Name1) contains the Name_Id for the operator symbol
4161 -- Next_Entity (Node2-Sem)
4162 -- Scope (Node3-Sem)
4163 -- Etype (Node5-Sem)
4165 ----------------------------
4166 -- 6.1 Parameter Profile --
4167 ----------------------------
4169 -- PARAMETER_PROFILE ::= [FORMAL_PART]
4171 ---------------------------------------
4172 -- 6.1 Parameter and Result Profile --
4173 ---------------------------------------
4175 -- PARAMETER_AND_RESULT_PROFILE ::=
4176 -- [FORMAL_PART] return [NULL_EXCLUSION] SUBTYPE_MARK
4177 -- | [FORMAL_PART] return ACCESS_DEFINITION
4179 -- There is no explicit node in the tree for a parameter and result
4180 -- profile. Instead the information appears directly in the parent.
4182 ----------------------
4183 -- 6.1 Formal part --
4184 ----------------------
4187 -- (PARAMETER_SPECIFICATION {; PARAMETER_SPECIFICATION})
4189 ----------------------------------
4190 -- 6.1 Parameter specification --
4191 ----------------------------------
4193 -- PARAMETER_SPECIFICATION ::=
4194 -- DEFINING_IDENTIFIER_LIST : MODE [NULL_EXCLUSION] SUBTYPE_MARK
4195 -- [:= DEFAULT_EXPRESSION]
4196 -- | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
4197 -- [:= DEFAULT_EXPRESSION]
4199 -- Although the syntax allows multiple identifiers in the list, the
4200 -- semantics is as though successive specifications were given with
4201 -- identical type definition and expression components. To simplify
4202 -- semantic processing, the parser represents a multiple declaration
4203 -- case as a sequence of single Specifications, using the More_Ids and
4204 -- Prev_Ids flags to preserve the original source form as described
4205 -- in the section on "Handling of Defining Identifier Lists".
4207 -- N_Parameter_Specification
4208 -- Sloc points to first identifier
4209 -- Defining_Identifier (Node1)
4210 -- In_Present (Flag15)
4211 -- Out_Present (Flag17)
4212 -- Null_Exclusion_Present (Flag11)
4213 -- Parameter_Type (Node2) subtype mark or access definition
4214 -- Expression (Node3) (set to Empty if no default expression present)
4215 -- Do_Accessibility_Check (Flag13-Sem)
4216 -- More_Ids (Flag5) (set to False if no more identifiers in list)
4217 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
4218 -- Default_Expression (Node5-Sem)
4224 -- MODE ::= [in] | in out | out
4226 -- There is no explicit node in the tree for the Mode. Instead the
4227 -- In_Present and Out_Present flags are set in the parent node to
4228 -- record the presence of keywords specifying the mode.
4230 --------------------------
4231 -- 6.3 Subprogram Body --
4232 --------------------------
4234 -- SUBPROGRAM_BODY ::=
4235 -- SUBPROGRAM_SPECIFICATION is
4238 -- HANDLED_SEQUENCE_OF_STATEMENTS
4239 -- end [DESIGNATOR];
4241 -- N_Subprogram_Body
4242 -- Sloc points to FUNCTION or PROCEDURE
4243 -- Specification (Node1)
4244 -- Declarations (List2)
4245 -- Handled_Statement_Sequence (Node4)
4246 -- Activation_Chain_Entity (Node3-Sem)
4247 -- Corresponding_Spec (Node5-Sem)
4248 -- Acts_As_Spec (Flag4-Sem)
4249 -- Bad_Is_Detected (Flag15) used only by parser
4250 -- Do_Storage_Check (Flag17-Sem)
4251 -- Has_Priority_Pragma (Flag6-Sem)
4252 -- Is_Protected_Subprogram_Body (Flag7-Sem)
4253 -- Is_Entry_Barrier_Function (Flag8-Sem)
4254 -- Is_Task_Master (Flag5-Sem)
4255 -- Was_Originally_Stub (Flag13-Sem)
4257 -----------------------------------
4258 -- 6.4 Procedure Call Statement --
4259 -----------------------------------
4261 -- PROCEDURE_CALL_STATEMENT ::=
4262 -- procedure_NAME; | procedure_PREFIX ACTUAL_PARAMETER_PART;
4264 -- Note: the reason that a procedure call has expression fields is
4265 -- that it semantically resembles an expression, e.g. overloading is
4266 -- allowed and a type is concocted for semantic processing purposes.
4267 -- Certain of these fields, such as Parens are not relevant, but it
4268 -- is easier to just supply all of them together!
4270 -- N_Procedure_Call_Statement
4271 -- Sloc points to first token of name or prefix
4272 -- Name (Node2) stores name or prefix
4273 -- Parameter_Associations (List3) (set to No_List if no
4274 -- actual parameter part)
4275 -- First_Named_Actual (Node4-Sem)
4276 -- Controlling_Argument (Node1-Sem) (set to Empty if not dispatching)
4277 -- Do_Tag_Check (Flag13-Sem)
4278 -- No_Elaboration_Check (Flag14-Sem)
4279 -- Parameter_List_Truncated (Flag17-Sem)
4280 -- ABE_Is_Certain (Flag18-Sem)
4281 -- plus fields for expression
4283 -- If any IN parameter requires a range check, then the corresponding
4284 -- argument expression has the Do_Range_Check flag set, and the range
4285 -- check is done against the formal type. Note that this argument
4286 -- expression may appear directly in the Parameter_Associations list,
4287 -- or may be a descendent of an N_Parameter_Association node that
4288 -- appears in this list.
4290 ------------------------
4291 -- 6.4 Function Call --
4292 ------------------------
4294 -- FUNCTION_CALL ::=
4295 -- function_NAME | function_PREFIX ACTUAL_PARAMETER_PART
4297 -- Note: the parser may generate an indexed component node or simply
4298 -- a name node instead of a function call node. The semantic pass must
4299 -- correct this misidentification.
4302 -- Sloc points to first token of name or prefix
4303 -- Name (Node2) stores name or prefix
4304 -- Parameter_Associations (List3) (set to No_List if no
4305 -- actual parameter part)
4306 -- First_Named_Actual (Node4-Sem)
4307 -- Controlling_Argument (Node1-Sem) (set to Empty if not dispatching)
4308 -- Is_Expanded_Build_In_Place_Call (Flag11-Sem)
4309 -- Do_Tag_Check (Flag13-Sem)
4310 -- No_Elaboration_Check (Flag14-Sem)
4311 -- Parameter_List_Truncated (Flag17-Sem)
4312 -- ABE_Is_Certain (Flag18-Sem)
4313 -- plus fields for expression
4315 --------------------------------
4316 -- 6.4 Actual Parameter Part --
4317 --------------------------------
4319 -- ACTUAL_PARAMETER_PART ::=
4320 -- (PARAMETER_ASSOCIATION {,PARAMETER_ASSOCIATION})
4322 --------------------------------
4323 -- 6.4 Parameter Association --
4324 --------------------------------
4326 -- PARAMETER_ASSOCIATION ::=
4327 -- [formal_parameter_SELECTOR_NAME =>] EXPLICIT_ACTUAL_PARAMETER
4329 -- Note: the N_Parameter_Association node is built only if a formal
4330 -- parameter selector name is present, otherwise the parameter
4331 -- association appears in the tree simply as the node for the
4332 -- explicit actual parameter.
4334 -- N_Parameter_Association
4335 -- Sloc points to formal parameter
4336 -- Selector_Name (Node2) (always non-Empty)
4337 -- Explicit_Actual_Parameter (Node3)
4338 -- Next_Named_Actual (Node4-Sem)
4340 ---------------------------
4341 -- 6.4 Actual Parameter --
4342 ---------------------------
4344 -- EXPLICIT_ACTUAL_PARAMETER ::= EXPRESSION | variable_NAME
4346 ---------------------------
4347 -- 6.5 Return Statement --
4348 ---------------------------
4350 -- RETURN_STATEMENT ::= return [EXPRESSION]; -- Ada 95
4352 -- In Ada 2005, we have:
4354 -- SIMPLE_RETURN_STATEMENT ::= return [EXPRESSION];
4356 -- EXTENDED_RETURN_STATEMENT ::=
4357 -- return DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
4358 -- [:= EXPRESSION] [do
4359 -- HANDLED_SEQUENCE_OF_STATEMENTS
4362 -- RETURN_SUBTYPE_INDICATION ::= SUBTYPE_INDICATION | ACCESS_DEFINITION
4364 -- So in Ada 2005, RETURN_STATEMENT is no longer a nonterminal, but
4365 -- "return statement" is defined in 6.5 to mean a
4366 -- SIMPLE_RETURN_STATEMENT or an EXTENDED_RETURN_STATEMENT.
4368 -- N_Return_Statement
4369 -- Sloc points to RETURN
4370 -- Return_Statement_Entity (Node5-Sem)
4371 -- Expression (Node3) (set to Empty if no expression present)
4372 -- Storage_Pool (Node1-Sem)
4373 -- Procedure_To_Call (Node2-Sem)
4374 -- Do_Tag_Check (Flag13-Sem)
4375 -- By_Ref (Flag5-Sem)
4376 -- Comes_From_Extended_Return_Statement (Flag18-Sem)
4378 -- N_Return_Statement represents a simple_return_statement, and is
4379 -- renamed to be N_Simple_Return_Statement below. Clients should refer
4380 -- to N_Simple_Return_Statement. We retain N_Return_Statement because
4381 -- that's how gigi knows it. See also renaming of Make_Return_Statement
4382 -- as Make_Simple_Return_Statement in Sem_Util.
4384 -- Note: Return_Statement_Entity points to an E_Return_Statement
4386 -- If a range check is required, then Do_Range_Check is set on the
4387 -- Expression. The check is against the return subtype of the function.
4389 -- N_Extended_Return_Statement
4390 -- Sloc points to RETURN
4391 -- Return_Statement_Entity (Node5-Sem)
4392 -- Return_Object_Declarations (List3)
4393 -- Handled_Statement_Sequence (Node4) (set to Empty if not present)
4394 -- Storage_Pool (Node1-Sem)
4395 -- Procedure_To_Call (Node2-Sem)
4396 -- Do_Tag_Check (Flag13-Sem)
4397 -- By_Ref (Flag5-Sem)
4399 -- Note: Return_Statement_Entity points to an E_Return_Statement.
4400 -- Note that Return_Object_Declarations is a list containing the
4401 -- N_Object_Declaration -- see comment on this field above.
4402 -- The declared object will have Is_Return_Object = True.
4403 -- There is no such syntactic category as return_object_declaration
4404 -- in the RM. Return_Object_Declarations represents this portion of
4405 -- the syntax for EXTENDED_RETURN_STATEMENT:
4406 -- DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
4409 -- There are two entities associated with an extended_return_statement:
4410 -- the Return_Statement_Entity represents the statement itself, and the
4411 -- Defining_Identifier of the Object_Declaration in
4412 -- Return_Object_Declarations represents the object being
4413 -- returned. N_Simple_Return_Statement has only the former.
4415 ------------------------------
4416 -- 7.1 Package Declaration --
4417 ------------------------------
4419 -- PACKAGE_DECLARATION ::= PACKAGE_SPECIFICATION;
4421 -- Note: the activation chain entity for a package spec is used for
4422 -- all tasks declared in the package spec, or in the package body.
4424 -- N_Package_Declaration
4425 -- Sloc points to PACKAGE
4426 -- Specification (Node1)
4427 -- Corresponding_Body (Node5-Sem)
4428 -- Parent_Spec (Node4-Sem)
4429 -- Activation_Chain_Entity (Node3-Sem)
4431 --------------------------------
4432 -- 7.1 Package Specification --
4433 --------------------------------
4435 -- PACKAGE_SPECIFICATION ::=
4436 -- package DEFINING_PROGRAM_UNIT_NAME is
4437 -- {BASIC_DECLARATIVE_ITEM}
4439 -- {BASIC_DECLARATIVE_ITEM}]
4440 -- end [[PARENT_UNIT_NAME .] IDENTIFIER]
4442 -- N_Package_Specification
4443 -- Sloc points to PACKAGE
4444 -- Defining_Unit_Name (Node1)
4445 -- Visible_Declarations (List2)
4446 -- Private_Declarations (List3) (set to No_List if no private
4448 -- End_Label (Node4)
4449 -- Generic_Parent (Node5-Sem)
4450 -- Limited_View_Installed (Flag18-Sem)
4452 -----------------------
4453 -- 7.1 Package Body --
4454 -----------------------
4457 -- package body DEFINING_PROGRAM_UNIT_NAME is
4460 -- HANDLED_SEQUENCE_OF_STATEMENTS]
4461 -- end [[PARENT_UNIT_NAME .] IDENTIFIER];
4464 -- Sloc points to PACKAGE
4465 -- Defining_Unit_Name (Node1)
4466 -- Declarations (List2)
4467 -- Handled_Statement_Sequence (Node4) (set to Empty if no HSS present)
4468 -- Corresponding_Spec (Node5-Sem)
4469 -- Was_Originally_Stub (Flag13-Sem)
4471 -- Note: if a source level package does not contain a handled sequence
4472 -- of statements, then the parser supplies a dummy one with a null
4473 -- sequence of statements. Comes_From_Source will be False in this
4474 -- constructed sequence. The reason we need this is for the End_Label
4475 -- field in the HSS.
4477 -----------------------------------
4478 -- 7.4 Private Type Declaration --
4479 -----------------------------------
4481 -- PRIVATE_TYPE_DECLARATION ::=
4482 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART]
4483 -- is [[abstract] tagged] [limited] private;
4485 -- Note: TAGGED is not permitted in Ada 83 mode
4487 -- N_Private_Type_Declaration
4488 -- Sloc points to TYPE
4489 -- Defining_Identifier (Node1)
4490 -- Discriminant_Specifications (List4) (set to No_List if no
4491 -- discriminant part)
4492 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
4493 -- Abstract_Present (Flag4)
4494 -- Tagged_Present (Flag15)
4495 -- Limited_Present (Flag17)
4497 ----------------------------------------
4498 -- 7.4 Private Extension Declaration --
4499 ----------------------------------------
4501 -- PRIVATE_EXTENSION_DECLARATION ::=
4502 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART] is
4503 -- [abstract] [limited | synchronized]
4504 -- new ancestor_SUBTYPE_INDICATION [and INTERFACE_LIST]
4507 -- Note: LIMITED, and private extension declarations are not allowed
4510 -- N_Private_Extension_Declaration
4511 -- Sloc points to TYPE
4512 -- Defining_Identifier (Node1)
4513 -- Discriminant_Specifications (List4) (set to No_List if no
4514 -- discriminant part)
4515 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
4516 -- Abstract_Present (Flag4)
4517 -- Limited_Present (Flag17)
4518 -- Synchronized_Present (Flag7)
4519 -- Subtype_Indication (Node5)
4520 -- Interface_List (List2) (set to No_List if none)
4522 ---------------------
4523 -- 8.4 Use Clause --
4524 ---------------------
4526 -- USE_CLAUSE ::= USE_PACKAGE_CLAUSE | USE_TYPE_CLAUSE
4528 -----------------------------
4529 -- 8.4 Use Package Clause --
4530 -----------------------------
4532 -- USE_PACKAGE_CLAUSE ::= use package_NAME {, package_NAME};
4534 -- N_Use_Package_Clause
4535 -- Sloc points to USE
4537 -- Next_Use_Clause (Node3-Sem)
4538 -- Hidden_By_Use_Clause (Elist4-Sem)
4540 --------------------------
4541 -- 8.4 Use Type Clause --
4542 --------------------------
4544 -- USE_TYPE_CLAUSE ::= use type SUBTYPE_MARK {, SUBTYPE_MARK};
4546 -- Note: use type clause is not permitted in Ada 83 mode
4548 -- N_Use_Type_Clause
4549 -- Sloc points to USE
4550 -- Subtype_Marks (List2)
4551 -- Next_Use_Clause (Node3-Sem)
4552 -- Hidden_By_Use_Clause (Elist4-Sem)
4554 -------------------------------
4555 -- 8.5 Renaming Declaration --
4556 -------------------------------
4558 -- RENAMING_DECLARATION ::=
4559 -- OBJECT_RENAMING_DECLARATION
4560 -- | EXCEPTION_RENAMING_DECLARATION
4561 -- | PACKAGE_RENAMING_DECLARATION
4562 -- | SUBPROGRAM_RENAMING_DECLARATION
4563 -- | GENERIC_RENAMING_DECLARATION
4565 --------------------------------------
4566 -- 8.5 Object Renaming Declaration --
4567 --------------------------------------
4569 -- OBJECT_RENAMING_DECLARATION ::=
4570 -- DEFINING_IDENTIFIER :
4571 -- [NULL_EXCLUSION] SUBTYPE_MARK renames object_NAME;
4572 -- | DEFINING_IDENTIFIER :
4573 -- ACCESS_DEFINITION renames object_NAME;
4575 -- Note: Access_Definition is an optional field that gives support to
4576 -- Ada 2005 (AI-230). The parser generates nodes that have either the
4577 -- Subtype_Indication field or else the Access_Definition field.
4579 -- N_Object_Renaming_Declaration
4580 -- Sloc points to first identifier
4581 -- Defining_Identifier (Node1)
4582 -- Null_Exclusion_Present (Flag11) (set to False if not present)
4583 -- Subtype_Mark (Node4) (set to Empty if not present)
4584 -- Access_Definition (Node3) (set to Empty if not present)
4586 -- Corresponding_Generic_Association (Node5-Sem)
4588 -----------------------------------------
4589 -- 8.5 Exception Renaming Declaration --
4590 -----------------------------------------
4592 -- EXCEPTION_RENAMING_DECLARATION ::=
4593 -- DEFINING_IDENTIFIER : exception renames exception_NAME;
4595 -- N_Exception_Renaming_Declaration
4596 -- Sloc points to first identifier
4597 -- Defining_Identifier (Node1)
4600 ---------------------------------------
4601 -- 8.5 Package Renaming Declaration --
4602 ---------------------------------------
4604 -- PACKAGE_RENAMING_DECLARATION ::=
4605 -- package DEFINING_PROGRAM_UNIT_NAME renames package_NAME;
4607 -- N_Package_Renaming_Declaration
4608 -- Sloc points to PACKAGE
4609 -- Defining_Unit_Name (Node1)
4611 -- Parent_Spec (Node4-Sem)
4613 ------------------------------------------
4614 -- 8.5 Subprogram Renaming Declaration --
4615 ------------------------------------------
4617 -- SUBPROGRAM_RENAMING_DECLARATION ::=
4618 -- SUBPROGRAM_SPECIFICATION renames callable_entity_NAME;
4620 -- N_Subprogram_Renaming_Declaration
4621 -- Sloc points to RENAMES
4622 -- Specification (Node1)
4624 -- Parent_Spec (Node4-Sem)
4625 -- Corresponding_Spec (Node5-Sem)
4626 -- Corresponding_Formal_Spec (Node3-Sem)
4627 -- From_Default (Flag6-Sem)
4629 -----------------------------------------
4630 -- 8.5.5 Generic Renaming Declaration --
4631 -----------------------------------------
4633 -- GENERIC_RENAMING_DECLARATION ::=
4634 -- generic package DEFINING_PROGRAM_UNIT_NAME
4635 -- renames generic_package_NAME
4636 -- | generic procedure DEFINING_PROGRAM_UNIT_NAME
4637 -- renames generic_procedure_NAME
4638 -- | generic function DEFINING_PROGRAM_UNIT_NAME
4639 -- renames generic_function_NAME
4641 -- N_Generic_Package_Renaming_Declaration
4642 -- Sloc points to GENERIC
4643 -- Defining_Unit_Name (Node1)
4645 -- Parent_Spec (Node4-Sem)
4647 -- N_Generic_Procedure_Renaming_Declaration
4648 -- Sloc points to GENERIC
4649 -- Defining_Unit_Name (Node1)
4651 -- Parent_Spec (Node4-Sem)
4653 -- N_Generic_Function_Renaming_Declaration
4654 -- Sloc points to GENERIC
4655 -- Defining_Unit_Name (Node1)
4657 -- Parent_Spec (Node4-Sem)
4659 --------------------------------
4660 -- 9.1 Task Type Declaration --
4661 --------------------------------
4663 -- TASK_TYPE_DECLARATION ::=
4664 -- task type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
4665 -- [is [new INTERFACE_LIST with] TASK_DEFINITITION];
4667 -- N_Task_Type_Declaration
4668 -- Sloc points to TASK
4669 -- Defining_Identifier (Node1)
4670 -- Discriminant_Specifications (List4) (set to No_List if no
4671 -- discriminant part)
4672 -- Interface_List (List2) (set to No_List if none)
4673 -- Task_Definition (Node3) (set to Empty if not present)
4674 -- Corresponding_Body (Node5-Sem)
4676 ----------------------------------
4677 -- 9.1 Single Task Declaration --
4678 ----------------------------------
4680 -- SINGLE_TASK_DECLARATION ::=
4681 -- task DEFINING_IDENTIFIER
4682 -- [is [new INTERFACE_LIST with] TASK_DEFINITITION];
4684 -- N_Single_Task_Declaration
4685 -- Sloc points to TASK
4686 -- Defining_Identifier (Node1)
4687 -- Interface_List (List2) (set to No_List if none)
4688 -- Task_Definition (Node3) (set to Empty if not present)
4690 --------------------------
4691 -- 9.1 Task Definition --
4692 --------------------------
4694 -- TASK_DEFINITION ::=
4698 -- end [task_IDENTIFIER]
4700 -- Note: as a result of semantic analysis, the list of task items can
4701 -- include implicit type declarations resulting from entry families.
4703 -- N_Task_Definition
4704 -- Sloc points to first token of task definition
4705 -- Visible_Declarations (List2)
4706 -- Private_Declarations (List3) (set to No_List if no private part)
4707 -- End_Label (Node4)
4708 -- Has_Priority_Pragma (Flag6-Sem)
4709 -- Has_Storage_Size_Pragma (Flag5-Sem)
4710 -- Has_Task_Info_Pragma (Flag7-Sem)
4711 -- Has_Task_Name_Pragma (Flag8-Sem)
4713 --------------------
4715 --------------------
4717 -- TASK_ITEM ::= ENTRY_DECLARATION | REPRESENTATION_CLAUSE
4719 --------------------
4721 --------------------
4724 -- task body task_DEFINING_IDENTIFIER is
4727 -- HANDLED_SEQUENCE_OF_STATEMENTS
4728 -- end [task_IDENTIFIER];
4730 -- Gigi restriction: This node never appears
4733 -- Sloc points to TASK
4734 -- Defining_Identifier (Node1)
4735 -- Declarations (List2)
4736 -- Handled_Statement_Sequence (Node4)
4737 -- Is_Task_Master (Flag5-Sem)
4738 -- Activation_Chain_Entity (Node3-Sem)
4739 -- Corresponding_Spec (Node5-Sem)
4740 -- Was_Originally_Stub (Flag13-Sem)
4742 -------------------------------------
4743 -- 9.4 Protected Type Declaration --
4744 -------------------------------------
4746 -- PROTECTED_TYPE_DECLARATION ::=
4747 -- protected type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
4748 -- is [new INTERFACE_LIST with] PROTECTED_DEFINITION;
4750 -- Note: protected type declarations are not permitted in Ada 83 mode
4752 -- N_Protected_Type_Declaration
4753 -- Sloc points to PROTECTED
4754 -- Defining_Identifier (Node1)
4755 -- Discriminant_Specifications (List4) (set to No_List if no
4756 -- discriminant part)
4757 -- Interface_List (List2) (set to No_List if none)
4758 -- Protected_Definition (Node3)
4759 -- Corresponding_Body (Node5-Sem)
4761 ---------------------------------------
4762 -- 9.4 Single Protected Declaration --
4763 ---------------------------------------
4765 -- SINGLE_PROTECTED_DECLARATION ::=
4766 -- protected DEFINING_IDENTIFIER
4767 -- is [new INTERFACE_LIST with] PROTECTED_DEFINITION;
4769 -- Note: single protected declarations are not allowed in Ada 83 mode
4771 -- N_Single_Protected_Declaration
4772 -- Sloc points to PROTECTED
4773 -- Defining_Identifier (Node1)
4774 -- Interface_List (List2) (set to No_List if none)
4775 -- Protected_Definition (Node3)
4777 -------------------------------
4778 -- 9.4 Protected Definition --
4779 -------------------------------
4781 -- PROTECTED_DEFINITION ::=
4782 -- {PROTECTED_OPERATION_DECLARATION}
4784 -- {PROTECTED_ELEMENT_DECLARATION}]
4785 -- end [protected_IDENTIFIER]
4787 -- N_Protected_Definition
4788 -- Sloc points to first token of protected definition
4789 -- Visible_Declarations (List2)
4790 -- Private_Declarations (List3) (set to No_List if no private part)
4791 -- End_Label (Node4)
4792 -- Has_Priority_Pragma (Flag6-Sem)
4794 ------------------------------------------
4795 -- 9.4 Protected Operation Declaration --
4796 ------------------------------------------
4798 -- PROTECTED_OPERATION_DECLARATION ::=
4799 -- SUBPROGRAM_DECLARATION
4800 -- | ENTRY_DECLARATION
4801 -- | REPRESENTATION_CLAUSE
4803 ----------------------------------------
4804 -- 9.4 Protected Element Declaration --
4805 ----------------------------------------
4807 -- PROTECTED_ELEMENT_DECLARATION ::=
4808 -- PROTECTED_OPERATION_DECLARATION | COMPONENT_DECLARATION
4810 -------------------------
4811 -- 9.4 Protected Body --
4812 -------------------------
4814 -- PROTECTED_BODY ::=
4815 -- protected body DEFINING_IDENTIFIER is
4816 -- {PROTECTED_OPERATION_ITEM}
4817 -- end [protected_IDENTIFIER];
4819 -- Note: protected bodies are not allowed in Ada 83 mode
4821 -- Gigi restriction: This node never appears
4824 -- Sloc points to PROTECTED
4825 -- Defining_Identifier (Node1)
4826 -- Declarations (List2) protected operation items (and pragmas)
4827 -- End_Label (Node4)
4828 -- Corresponding_Spec (Node5-Sem)
4829 -- Was_Originally_Stub (Flag13-Sem)
4831 -----------------------------------
4832 -- 9.4 Protected Operation Item --
4833 -----------------------------------
4835 -- PROTECTED_OPERATION_ITEM ::=
4836 -- SUBPROGRAM_DECLARATION
4837 -- | SUBPROGRAM_BODY
4839 -- | REPRESENTATION_CLAUSE
4841 ------------------------------
4842 -- 9.5.2 Entry Declaration --
4843 ------------------------------
4845 -- ENTRY_DECLARATION ::=
4846 -- [[not] overriding]
4847 -- entry DEFINING_IDENTIFIER
4848 -- [(DISCRETE_SUBTYPE_DEFINITION)] PARAMETER_PROFILE;
4850 -- N_Entry_Declaration
4851 -- Sloc points to ENTRY
4852 -- Defining_Identifier (Node1)
4853 -- Discrete_Subtype_Definition (Node4) (set to Empty if not present)
4854 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4855 -- Corresponding_Body (Node5-Sem)
4856 -- Must_Override (Flag14) set if overriding indicator present
4857 -- Must_Not_Override (Flag15) set if not_overriding indicator present
4859 -- Note: overriding indicator is an Ada 2005 feature
4861 -----------------------------
4862 -- 9.5.2 Accept statement --
4863 -----------------------------
4865 -- ACCEPT_STATEMENT ::=
4866 -- accept entry_DIRECT_NAME
4867 -- [(ENTRY_INDEX)] PARAMETER_PROFILE [do
4868 -- HANDLED_SEQUENCE_OF_STATEMENTS
4869 -- end [entry_IDENTIFIER]];
4871 -- Gigi restriction: This node never appears
4873 -- Note: there are no explicit declarations allowed in an accept
4874 -- statement. However, the implicit declarations for any statement
4875 -- identifiers (labels and block/loop identifiers) are declarations
4876 -- that belong logically to the accept statement, and that is why
4877 -- there is a Declarations field in this node.
4879 -- N_Accept_Statement
4880 -- Sloc points to ACCEPT
4881 -- Entry_Direct_Name (Node1)
4882 -- Entry_Index (Node5) (set to Empty if not present)
4883 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4884 -- Handled_Statement_Sequence (Node4)
4885 -- Declarations (List2) (set to No_List if no declarations)
4887 ------------------------
4888 -- 9.5.2 Entry Index --
4889 ------------------------
4891 -- ENTRY_INDEX ::= EXPRESSION
4893 -----------------------
4894 -- 9.5.2 Entry Body --
4895 -----------------------
4898 -- entry DEFINING_IDENTIFIER ENTRY_BODY_FORMAL_PART ENTRY_BARRIER is
4901 -- HANDLED_SEQUENCE_OF_STATEMENTS
4902 -- end [entry_IDENTIFIER];
4904 -- ENTRY_BARRIER ::= when CONDITION
4906 -- Note: we store the CONDITION of the ENTRY_BARRIER in the node for
4907 -- the ENTRY_BODY_FORMAL_PART to avoid the N_Entry_Body node getting
4908 -- too full (it would otherwise have too many fields)
4910 -- Gigi restriction: This node never appears
4913 -- Sloc points to ENTRY
4914 -- Defining_Identifier (Node1)
4915 -- Entry_Body_Formal_Part (Node5)
4916 -- Declarations (List2)
4917 -- Handled_Statement_Sequence (Node4)
4918 -- Activation_Chain_Entity (Node3-Sem)
4920 -----------------------------------
4921 -- 9.5.2 Entry Body Formal Part --
4922 -----------------------------------
4924 -- ENTRY_BODY_FORMAL_PART ::=
4925 -- [(ENTRY_INDEX_SPECIFICATION)] PARAMETER_PROFILE
4927 -- Note that an entry body formal part node is present even if it is
4928 -- empty. This reflects the grammar, in which it is the components of
4929 -- the entry body formal part that are optional, not the entry body
4930 -- formal part itself. Also this means that the barrier condition
4931 -- always has somewhere to be stored.
4933 -- Gigi restriction: This node never appears
4935 -- N_Entry_Body_Formal_Part
4936 -- Sloc points to first token
4937 -- Entry_Index_Specification (Node4) (set to Empty if not present)
4938 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4939 -- Condition (Node1) from entry barrier of entry body
4941 --------------------------
4942 -- 9.5.2 Entry Barrier --
4943 --------------------------
4945 -- ENTRY_BARRIER ::= when CONDITION
4947 --------------------------------------
4948 -- 9.5.2 Entry Index Specification --
4949 --------------------------------------
4951 -- ENTRY_INDEX_SPECIFICATION ::=
4952 -- for DEFINING_IDENTIFIER in DISCRETE_SUBTYPE_DEFINITION
4954 -- Gigi restriction: This node never appears
4956 -- N_Entry_Index_Specification
4957 -- Sloc points to FOR
4958 -- Defining_Identifier (Node1)
4959 -- Discrete_Subtype_Definition (Node4)
4961 ---------------------------------
4962 -- 9.5.3 Entry Call Statement --
4963 ---------------------------------
4965 -- ENTRY_CALL_STATEMENT ::= entry_NAME [ACTUAL_PARAMETER_PART];
4967 -- The parser may generate a procedure call for this construct. The
4968 -- semantic pass must correct this misidentification where needed.
4970 -- Gigi restriction: This node never appears
4972 -- N_Entry_Call_Statement
4973 -- Sloc points to first token of name
4975 -- Parameter_Associations (List3) (set to No_List if no
4976 -- actual parameter part)
4977 -- First_Named_Actual (Node4-Sem)
4979 ------------------------------
4980 -- 9.5.4 Requeue Statement --
4981 ------------------------------
4983 -- REQUEUE_STATEMENT ::= requeue entry_NAME [with abort];
4985 -- Note: requeue statements are not permitted in Ada 83 mode
4987 -- Gigi restriction: This node never appears
4989 -- N_Requeue_Statement
4990 -- Sloc points to REQUEUE
4992 -- Abort_Present (Flag15)
4994 --------------------------
4995 -- 9.6 Delay Statement --
4996 --------------------------
4998 -- DELAY_STATEMENT ::=
4999 -- DELAY_UNTIL_STATEMENT
5000 -- | DELAY_RELATIVE_STATEMENT
5002 --------------------------------
5003 -- 9.6 Delay Until Statement --
5004 --------------------------------
5006 -- DELAY_UNTIL_STATEMENT ::= delay until delay_EXPRESSION;
5008 -- Note: delay until statements are not permitted in Ada 83 mode
5010 -- Gigi restriction: This node never appears
5012 -- N_Delay_Until_Statement
5013 -- Sloc points to DELAY
5014 -- Expression (Node3)
5016 -----------------------------------
5017 -- 9.6 Delay Relative Statement --
5018 -----------------------------------
5020 -- DELAY_RELATIVE_STATEMENT ::= delay delay_EXPRESSION;
5022 -- Gigi restriction: This node never appears
5024 -- N_Delay_Relative_Statement
5025 -- Sloc points to DELAY
5026 -- Expression (Node3)
5028 ---------------------------
5029 -- 9.7 Select Statement --
5030 ---------------------------
5032 -- SELECT_STATEMENT ::=
5034 -- | TIMED_ENTRY_CALL
5035 -- | CONDITIONAL_ENTRY_CALL
5036 -- | ASYNCHRONOUS_SELECT
5038 -----------------------------
5039 -- 9.7.1 Selective Accept --
5040 -----------------------------
5042 -- SELECTIVE_ACCEPT ::=
5045 -- SELECT_ALTERNATIVE
5048 -- SELECT_ALTERNATIVE}
5050 -- SEQUENCE_OF_STATEMENTS]
5053 -- Gigi restriction: This node never appears
5055 -- Note: the guard expression, if present, appears in the node for
5056 -- the select alternative.
5058 -- N_Selective_Accept
5059 -- Sloc points to SELECT
5060 -- Select_Alternatives (List1)
5061 -- Else_Statements (List4) (set to No_List if no else part)
5067 -- GUARD ::= when CONDITION =>
5069 -- As noted above, the CONDITION that is part of a GUARD is included
5070 -- in the node for the select alernative for convenience.
5072 -------------------------------
5073 -- 9.7.1 Select Alternative --
5074 -------------------------------
5076 -- SELECT_ALTERNATIVE ::=
5077 -- ACCEPT_ALTERNATIVE
5078 -- | DELAY_ALTERNATIVE
5079 -- | TERMINATE_ALTERNATIVE
5081 -------------------------------
5082 -- 9.7.1 Accept Alternative --
5083 -------------------------------
5085 -- ACCEPT_ALTERNATIVE ::=
5086 -- ACCEPT_STATEMENT [SEQUENCE_OF_STATEMENTS]
5088 -- Gigi restriction: This node never appears
5090 -- N_Accept_Alternative
5091 -- Sloc points to ACCEPT
5092 -- Accept_Statement (Node2)
5093 -- Condition (Node1) from the guard (set to Empty if no guard present)
5094 -- Statements (List3) (set to Empty_List if no statements)
5095 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5096 -- Accept_Handler_Records (List5-Sem)
5098 ------------------------------
5099 -- 9.7.1 Delay Alternative --
5100 ------------------------------
5102 -- DELAY_ALTERNATIVE ::=
5103 -- DELAY_STATEMENT [SEQUENCE_OF_STATEMENTS]
5105 -- Gigi restriction: This node never appears
5107 -- N_Delay_Alternative
5108 -- Sloc points to DELAY
5109 -- Delay_Statement (Node2)
5110 -- Condition (Node1) from the guard (set to Empty if no guard present)
5111 -- Statements (List3) (set to Empty_List if no statements)
5112 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5114 ----------------------------------
5115 -- 9.7.1 Terminate Alternative --
5116 ----------------------------------
5118 -- TERMINATE_ALTERNATIVE ::= terminate;
5120 -- Gigi restriction: This node never appears
5122 -- N_Terminate_Alternative
5123 -- Sloc points to TERMINATE
5124 -- Condition (Node1) from the guard (set to Empty if no guard present)
5125 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5126 -- Pragmas_After (List5) pragmas after alt (set to No_List if none)
5128 -----------------------------
5129 -- 9.7.2 Timed Entry Call --
5130 -----------------------------
5132 -- TIMED_ENTRY_CALL ::=
5134 -- ENTRY_CALL_ALTERNATIVE
5136 -- DELAY_ALTERNATIVE
5139 -- Gigi restriction: This node never appears
5141 -- N_Timed_Entry_Call
5142 -- Sloc points to SELECT
5143 -- Entry_Call_Alternative (Node1)
5144 -- Delay_Alternative (Node4)
5146 -----------------------------------
5147 -- 9.7.2 Entry Call Alternative --
5148 -----------------------------------
5150 -- ENTRY_CALL_ALTERNATIVE ::=
5151 -- PROCEDURE_OR_ENTRY_CALL [SEQUENCE_OF_STATEMENTS]
5153 -- PROCEDURE_OR_ENTRY_CALL ::=
5154 -- PROCEDURE_CALL_STATEMENT | ENTRY_CALL_STATEMENT
5156 -- Gigi restriction: This node never appears
5158 -- N_Entry_Call_Alternative
5159 -- Sloc points to first token of entry call statement
5160 -- Entry_Call_Statement (Node1)
5161 -- Statements (List3) (set to Empty_List if no statements)
5162 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5164 -----------------------------------
5165 -- 9.7.3 Conditional Entry Call --
5166 -----------------------------------
5168 -- CONDITIONAL_ENTRY_CALL ::=
5170 -- ENTRY_CALL_ALTERNATIVE
5172 -- SEQUENCE_OF_STATEMENTS
5175 -- Gigi restriction: This node never appears
5177 -- N_Conditional_Entry_Call
5178 -- Sloc points to SELECT
5179 -- Entry_Call_Alternative (Node1)
5180 -- Else_Statements (List4)
5182 --------------------------------
5183 -- 9.7.4 Asynchronous Select --
5184 --------------------------------
5186 -- ASYNCHRONOUS_SELECT ::=
5188 -- TRIGGERING_ALTERNATIVE
5193 -- Note: asynchronous select is not permitted in Ada 83 mode
5195 -- Gigi restriction: This node never appears
5197 -- N_Asynchronous_Select
5198 -- Sloc points to SELECT
5199 -- Triggering_Alternative (Node1)
5200 -- Abortable_Part (Node2)
5202 -----------------------------------
5203 -- 9.7.4 Triggering Alternative --
5204 -----------------------------------
5206 -- TRIGGERING_ALTERNATIVE ::=
5207 -- TRIGGERING_STATEMENT [SEQUENCE_OF_STATEMENTS]
5209 -- Gigi restriction: This node never appears
5211 -- N_Triggering_Alternative
5212 -- Sloc points to first token of triggering statement
5213 -- Triggering_Statement (Node1)
5214 -- Statements (List3) (set to Empty_List if no statements)
5215 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5217 ---------------------------------
5218 -- 9.7.4 Triggering Statement --
5219 ---------------------------------
5221 -- TRIGGERING_STATEMENT ::= PROCEDURE_OR_ENTRY_CALL | DELAY_STATEMENT
5223 ---------------------------
5224 -- 9.7.4 Abortable Part --
5225 ---------------------------
5227 -- ABORTABLE_PART ::= SEQUENCE_OF_STATEMENTS
5229 -- Gigi restriction: This node never appears
5232 -- Sloc points to ABORT
5233 -- Statements (List3)
5235 --------------------------
5236 -- 9.8 Abort Statement --
5237 --------------------------
5239 -- ABORT_STATEMENT ::= abort task_NAME {, task_NAME};
5241 -- Gigi restriction: This node never appears
5243 -- N_Abort_Statement
5244 -- Sloc points to ABORT
5247 -------------------------
5248 -- 10.1.1 Compilation --
5249 -------------------------
5251 -- COMPILATION ::= {COMPILATION_UNIT}
5253 -- There is no explicit node in the tree for a compilation, since in
5254 -- general the compiler is processing only a single compilation unit
5255 -- at a time. It is possible to parse multiple units in syntax check
5256 -- only mode, but they the trees are discarded in any case.
5258 ------------------------------
5259 -- 10.1.1 Compilation Unit --
5260 ------------------------------
5262 -- COMPILATION_UNIT ::=
5263 -- CONTEXT_CLAUSE LIBRARY_ITEM
5264 -- | CONTEXT_CLAUSE SUBUNIT
5266 -- The N_Compilation_Unit node itself respresents the above syntax.
5267 -- However, there are two additional items not reflected in the above
5268 -- syntax. First we have the global declarations that are added by the
5269 -- code generator. These are outer level declarations (so they cannot
5270 -- be represented as being inside the units). An example is the wrapper
5271 -- subprograms that are created to do ABE checking. As always a list of
5272 -- declarations can contain actions as well (i.e. statements), and such
5273 -- statements are executed as part of the elaboration of the unit. Note
5274 -- that all such declarations are elaborated before the library unit.
5276 -- Similarly, certain actions need to be elaborated at the completion
5277 -- of elaboration of the library unit (notably the statement that sets
5278 -- the Boolean flag indicating that elaboration is complete).
5280 -- The third item not reflected in the syntax is pragmas that appear
5281 -- after the compilation unit. As always pragmas are a problem since
5282 -- they are not part of the formal syntax, but can be stuck into the
5283 -- source following a set of ad hoc rules, and we have to find an ad
5284 -- hoc way of sticking them into the tree. For pragmas that appear
5285 -- before the library unit, we just consider them to be part of the
5286 -- context clause, and pragmas can appear in the Context_Items list
5287 -- of the compilation unit. However, pragmas can also appear after
5288 -- the library item.
5290 -- To deal with all these problems, we create an auxiliary node for
5291 -- a compilation unit, referenced from the N_Compilation_Unit node
5292 -- that contains these three items.
5294 -- N_Compilation_Unit
5295 -- Sloc points to first token of defining unit name
5296 -- Library_Unit (Node4-Sem) corresponding/parent spec/body
5297 -- Context_Items (List1) context items and pragmas preceding unit
5298 -- Private_Present (Flag15) set if library unit has private keyword
5299 -- Unit (Node2) library item or subunit
5300 -- Aux_Decls_Node (Node5) points to the N_Compilation_Unit_Aux node
5301 -- Has_No_Elaboration_Code (Flag17-Sem)
5302 -- Body_Required (Flag13-Sem) set for spec if body is required
5303 -- Acts_As_Spec (Flag4-Sem) flag for subprogram body with no spec
5304 -- First_Inlined_Subprogram (Node3-Sem)
5306 -- N_Compilation_Unit_Aux
5307 -- Sloc is a copy of the Sloc from the N_Compilation_Unit node
5308 -- Declarations (List2) (set to No_List if no global declarations)
5309 -- Actions (List1) (set to No_List if no actions)
5310 -- Pragmas_After (List5) pragmas after unit (set to No_List if none)
5311 -- Config_Pragmas (List4) config pragmas (set to Empty_List if none)
5313 --------------------------
5314 -- 10.1.1 Library Item --
5315 --------------------------
5318 -- [private] LIBRARY_UNIT_DECLARATION
5319 -- | LIBRARY_UNIT_BODY
5320 -- | [private] LIBRARY_UNIT_RENAMING_DECLARATION
5322 -- Note: PRIVATE is not allowed in Ada 83 mode
5324 -- There is no explicit node in the tree for library item, instead
5325 -- the declaration or body, and the flag for private if present,
5326 -- appear in the N_Compilation_Unit clause.
5328 ----------------------------------------
5329 -- 10.1.1 Library Unit Declararation --
5330 ----------------------------------------
5332 -- LIBRARY_UNIT_DECLARATION ::=
5333 -- SUBPROGRAM_DECLARATION | PACKAGE_DECLARATION
5334 -- | GENERIC_DECLARATION | GENERIC_INSTANTIATION
5336 -------------------------------------------------
5337 -- 10.1.1 Library Unit Renaming Declararation --
5338 -------------------------------------------------
5340 -- LIBRARY_UNIT_RENAMING_DECLARATION ::=
5341 -- PACKAGE_RENAMING_DECLARATION
5342 -- | GENERIC_RENAMING_DECLARATION
5343 -- | SUBPROGRAM_RENAMING_DECLARATION
5345 -------------------------------
5346 -- 10.1.1 Library unit body --
5347 -------------------------------
5349 -- LIBRARY_UNIT_BODY ::= SUBPROGRAM_BODY | PACKAGE_BODY
5351 ------------------------------
5352 -- 10.1.1 Parent Unit Name --
5353 ------------------------------
5355 -- PARENT_UNIT_NAME ::= NAME
5357 ----------------------------
5358 -- 10.1.2 Context clause --
5359 ----------------------------
5361 -- CONTEXT_CLAUSE ::= {CONTEXT_ITEM}
5363 -- The context clause can include pragmas, and any pragmas that appear
5364 -- before the context clause proper (i.e. all configuration pragmas,
5365 -- also appear at the front of this list).
5367 --------------------------
5368 -- 10.1.2 Context_Item --
5369 --------------------------
5371 -- CONTEXT_ITEM ::= WITH_CLAUSE | USE_CLAUSE | WITH_TYPE_CLAUSE
5373 -------------------------
5374 -- 10.1.2 With clause --
5375 -------------------------
5378 -- with library_unit_NAME {,library_unit_NAME};
5380 -- A separate With clause is built for each name, so that we have
5381 -- a Corresponding_Spec field for each with'ed spec. The flags
5382 -- First_Name and Last_Name are used to reconstruct the exact
5383 -- source form. When a list of names appears in one with clause,
5384 -- the first name in the list has First_Name set, and the last
5385 -- has Last_Name set. If the with clause has only one name, then
5386 -- both of the flags First_Name and Last_Name are set in this name.
5388 -- Note: in the case of implicit with's that are installed by the
5389 -- Rtsfind routine, Implicit_With is set, and the Sloc is typically
5390 -- set to Standard_Location, but it is incorrect to test the Sloc
5391 -- to find out if a with clause is implicit, test the flag instead.
5394 -- Sloc points to first token of library unit name
5396 -- Library_Unit (Node4-Sem)
5397 -- Corresponding_Spec (Node5-Sem)
5398 -- First_Name (Flag5) (set to True if first name or only one name)
5399 -- Last_Name (Flag6) (set to True if last name or only one name)
5400 -- Context_Installed (Flag13-Sem)
5401 -- Elaborate_Present (Flag4-Sem)
5402 -- Elaborate_All_Present (Flag14-Sem)
5403 -- Elaborate_All_Desirable (Flag9-Sem)
5404 -- Elaborate_Desirable (Flag11-Sem)
5405 -- Private_Present (Flag15) set if with_clause has private keyword
5406 -- Implicit_With (Flag16-Sem)
5407 -- Limited_Present (Flag17) set if LIMITED is present
5408 -- Limited_View_Installed (Flag18-Sem)
5409 -- Unreferenced_In_Spec (Flag7-Sem)
5410 -- No_Entities_Ref_In_Spec (Flag8-Sem)
5412 -- Note: Limited_Present and Limited_View_Installed give support to
5413 -- Ada 2005 (AI-50217).
5414 -- Similarly, Private_Present gives support to AI-50262.
5416 ----------------------
5417 -- With_Type clause --
5418 ----------------------
5420 -- This is a GNAT extension, used to implement mutually recursive
5421 -- types declared in different packages.
5422 -- Note: this is now obsolete. The functionality of this construct
5423 -- is now implemented by the Ada 2005 Limited_with_Clause.
5425 ---------------------
5426 -- 10.2 Body stub --
5427 ---------------------
5430 -- SUBPROGRAM_BODY_STUB
5431 -- | PACKAGE_BODY_STUB
5433 -- | PROTECTED_BODY_STUB
5435 ----------------------------------
5436 -- 10.1.3 Subprogram Body Stub --
5437 ----------------------------------
5439 -- SUBPROGRAM_BODY_STUB ::=
5440 -- SUBPROGRAM_SPECIFICATION is separate;
5442 -- N_Subprogram_Body_Stub
5443 -- Sloc points to FUNCTION or PROCEDURE
5444 -- Specification (Node1)
5445 -- Library_Unit (Node4-Sem) points to the subunit
5446 -- Corresponding_Body (Node5-Sem)
5448 -------------------------------
5449 -- 10.1.3 Package Body Stub --
5450 -------------------------------
5452 -- PACKAGE_BODY_STUB ::=
5453 -- package body DEFINING_IDENTIFIER is separate;
5455 -- N_Package_Body_Stub
5456 -- Sloc points to PACKAGE
5457 -- Defining_Identifier (Node1)
5458 -- Library_Unit (Node4-Sem) points to the subunit
5459 -- Corresponding_Body (Node5-Sem)
5461 ----------------------------
5462 -- 10.1.3 Task Body Stub --
5463 ----------------------------
5465 -- TASK_BODY_STUB ::=
5466 -- task body DEFINING_IDENTIFIER is separate;
5469 -- Sloc points to TASK
5470 -- Defining_Identifier (Node1)
5471 -- Library_Unit (Node4-Sem) points to the subunit
5472 -- Corresponding_Body (Node5-Sem)
5474 ---------------------------------
5475 -- 10.1.3 Protected Body Stub --
5476 ---------------------------------
5478 -- PROTECTED_BODY_STUB ::=
5479 -- protected body DEFINING_IDENTIFIER is separate;
5481 -- Note: protected body stubs are not allowed in Ada 83 mode
5483 -- N_Protected_Body_Stub
5484 -- Sloc points to PROTECTED
5485 -- Defining_Identifier (Node1)
5486 -- Library_Unit (Node4-Sem) points to the subunit
5487 -- Corresponding_Body (Node5-Sem)
5489 ---------------------
5490 -- 10.1.3 Subunit --
5491 ---------------------
5493 -- SUBUNIT ::= separate (PARENT_UNIT_NAME) PROPER_BODY
5496 -- Sloc points to SEPARATE
5497 -- Name (Node2) is the name of the parent unit
5498 -- Proper_Body (Node1) is the subunit body
5499 -- Corresponding_Stub (Node3-Sem) is the stub declaration for the unit.
5501 ---------------------------------
5502 -- 11.1 Exception Declaration --
5503 ---------------------------------
5505 -- EXCEPTION_DECLARATION ::= DEFINING_IDENTIFIER_LIST : exception;
5507 -- For consistency with object declarations etc, the parser converts
5508 -- the case of multiple identifiers being declared to a series of
5509 -- declarations in which the expression is copied, using the More_Ids
5510 -- and Prev_Ids flags to remember the souce form as described in the
5511 -- section on "Handling of Defining Identifier Lists".
5513 -- N_Exception_Declaration
5514 -- Sloc points to EXCEPTION
5515 -- Defining_Identifier (Node1)
5516 -- Expression (Node3-Sem)
5517 -- Renaming_Exception (Node2-Sem)
5518 -- More_Ids (Flag5) (set to False if no more identifiers in list)
5519 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
5521 ------------------------------------------
5522 -- 11.2 Handled Sequence Of Statements --
5523 ------------------------------------------
5525 -- HANDLED_SEQUENCE_OF_STATEMENTS ::=
5526 -- SEQUENCE_OF_STATEMENTS
5528 -- EXCEPTION_HANDLER
5529 -- {EXCEPTION_HANDLER}]
5531 -- cleanup_procedure_call (param, param, param, ...);]
5533 -- The AT END phrase is a GNAT extension to provide for cleanups. It is
5534 -- used only internally currently, but is considered to be syntactic.
5535 -- At the moment, the only cleanup action allowed is a single call to
5536 -- a parameterless procedure, and the Identifier field of the node is
5537 -- the procedure to be called. Also there is a current restriction
5538 -- that exception handles and a cleanup cannot be present in the same
5539 -- frame, so at least one of Exception_Handlers or the Identifier must
5542 -- Actually, more accurately, this restriction applies to the original
5543 -- source program. In the expanded tree, if the At_End_Proc field is
5544 -- present, then there will also be an exception handler of the form:
5546 -- when all others =>
5550 -- where cleanup is the procedure to be generated. The reason we do
5551 -- this is so that the front end can handle the necessary entries in
5552 -- the exception tables, and other exception handler actions required
5553 -- as part of the normal handling for exception handlers.
5555 -- The AT END cleanup handler protects only the sequence of statements
5556 -- (not the associated declarations of the parent), just like exception
5557 -- handlers. The big difference is that the cleanup procedure is called
5558 -- on either a normal or an abnormal exit from the statement sequence.
5560 -- Note: the list of Exception_Handlers can contain pragmas as well
5561 -- as actual handlers. In practice these pragmas can only occur at
5562 -- the start of the list, since any pragmas occurring later on will
5563 -- be included in the statement list of the corresponding handler.
5565 -- Note: although in the Ada syntax, the sequence of statements in
5566 -- a handled sequence of statements can only contain statements, we
5567 -- allow free mixing of declarations and statements in the resulting
5568 -- expanded tree. This is for example used to deal with the case of
5569 -- a cleanup procedure that must handle declarations as well as the
5570 -- statements of a block.
5572 -- N_Handled_Sequence_Of_Statements
5573 -- Sloc points to first token of first statement
5574 -- Statements (List3)
5575 -- End_Label (Node4) (set to Empty if expander generated)
5576 -- Exception_Handlers (List5) (set to No_List if none present)
5577 -- At_End_Proc (Node1) (set to Empty if no clean up procedure)
5578 -- First_Real_Statement (Node2-Sem)
5579 -- Zero_Cost_Handling (Flag5-Sem)
5581 -- Note: the parent always contains a Declarations field which contains
5582 -- declarations associated with the handled sequence of statements. This
5583 -- is true even in the case of an accept statement (see description of
5584 -- the N_Accept_Statement node).
5586 -- End_Label refers to the containing construct
5588 -----------------------------
5589 -- 11.2 Exception Handler --
5590 -----------------------------
5592 -- EXCEPTION_HANDLER ::=
5593 -- when [CHOICE_PARAMETER_SPECIFICATION :]
5594 -- EXCEPTION_CHOICE {| EXCEPTION_CHOICE} =>
5595 -- SEQUENCE_OF_STATEMENTS
5597 -- Note: choice parameter specification is not allowed in Ada 83 mode
5599 -- N_Exception_Handler
5600 -- Sloc points to WHEN
5601 -- Choice_Parameter (Node2) (set to Empty if not present)
5602 -- Exception_Choices (List4)
5603 -- Statements (List3)
5604 -- Exception_Label (Node5-Sem) (set to Empty of not present)
5605 -- Zero_Cost_Handling (Flag5-Sem)
5606 -- Local_Raise_Statements (Elist1-Sem) (set to No_Elist if not present)
5607 -- Local_Raise_Not_OK (Flag7-Sem)
5608 -- Has_Local_Raise (Flag8-Sem)
5610 ------------------------------------------
5611 -- 11.2 Choice parameter specification --
5612 ------------------------------------------
5614 -- CHOICE_PARAMETER_SPECIFICATION ::= DEFINING_IDENTIFIER
5616 ----------------------------
5617 -- 11.2 Exception Choice --
5618 ----------------------------
5620 -- EXCEPTION_CHOICE ::= exception_NAME | others
5622 -- Except in the case of OTHERS, no explicit node appears in the tree
5623 -- for exception choice. Instead the exception name appears directly.
5624 -- An OTHERS choice is represented by a N_Others_Choice node (see
5627 -- Note: for the exception choice created for an at end handler, the
5628 -- exception choice is an N_Others_Choice node with All_Others set.
5630 ---------------------------
5631 -- 11.3 Raise Statement --
5632 ---------------------------
5634 -- RAISE_STATEMENT ::= raise [exception_NAME];
5636 -- In Ada 2005, we have
5638 -- RAISE_STATEMENT ::= raise; | raise exception_NAME [with EXPRESSION];
5640 -- N_Raise_Statement
5641 -- Sloc points to RAISE
5642 -- Name (Node2) (set to Empty if no exception name present)
5643 -- Expression (Node3) (set to Empty if no expression present)
5645 -------------------------------
5646 -- 12.1 Generic Declaration --
5647 -------------------------------
5649 -- GENERIC_DECLARATION ::=
5650 -- GENERIC_SUBPROGRAM_DECLARATION | GENERIC_PACKAGE_DECLARATION
5652 ------------------------------------------
5653 -- 12.1 Generic Subprogram Declaration --
5654 ------------------------------------------
5656 -- GENERIC_SUBPROGRAM_DECLARATION ::=
5657 -- GENERIC_FORMAL_PART SUBPROGRAM_SPECIFICATION;
5659 -- Note: Generic_Formal_Declarations can include pragmas
5661 -- N_Generic_Subprogram_Declaration
5662 -- Sloc points to GENERIC
5663 -- Specification (Node1) subprogram specification
5664 -- Corresponding_Body (Node5-Sem)
5665 -- Generic_Formal_Declarations (List2) from generic formal part
5666 -- Parent_Spec (Node4-Sem)
5668 ---------------------------------------
5669 -- 12.1 Generic Package Declaration --
5670 ---------------------------------------
5672 -- GENERIC_PACKAGE_DECLARATION ::=
5673 -- GENERIC_FORMAL_PART PACKAGE_SPECIFICATION;
5675 -- Note: when we do generics right, the Activation_Chain_Entity entry
5676 -- for this node can be removed (since the expander won't see generic
5677 -- units any more)???.
5679 -- Note: Generic_Formal_Declarations can include pragmas
5681 -- N_Generic_Package_Declaration
5682 -- Sloc points to GENERIC
5683 -- Specification (Node1) package specification
5684 -- Corresponding_Body (Node5-Sem)
5685 -- Generic_Formal_Declarations (List2) from generic formal part
5686 -- Parent_Spec (Node4-Sem)
5687 -- Activation_Chain_Entity (Node3-Sem)
5689 -------------------------------
5690 -- 12.1 Generic Formal Part --
5691 -------------------------------
5693 -- GENERIC_FORMAL_PART ::=
5694 -- generic {GENERIC_FORMAL_PARAMETER_DECLARATION | USE_CLAUSE}
5696 ------------------------------------------------
5697 -- 12.1 Generic Formal Parameter Declaration --
5698 ------------------------------------------------
5700 -- GENERIC_FORMAL_PARAMETER_DECLARATION ::=
5701 -- FORMAL_OBJECT_DECLARATION
5702 -- | FORMAL_TYPE_DECLARATION
5703 -- | FORMAL_SUBPROGRAM_DECLARATION
5704 -- | FORMAL_PACKAGE_DECLARATION
5706 ---------------------------------
5707 -- 12.3 Generic Instantiation --
5708 ---------------------------------
5710 -- GENERIC_INSTANTIATION ::=
5711 -- package DEFINING_PROGRAM_UNIT_NAME is
5712 -- new generic_package_NAME [GENERIC_ACTUAL_PART];
5713 -- | [[not] overriding]
5714 -- procedure DEFINING_PROGRAM_UNIT_NAME is
5715 -- new generic_procedure_NAME [GENERIC_ACTUAL_PART];
5716 -- | [[not] overriding]
5717 -- function DEFINING_DESIGNATOR is
5718 -- new generic_function_NAME [GENERIC_ACTUAL_PART];
5720 -- N_Package_Instantiation
5721 -- Sloc points to PACKAGE
5722 -- Defining_Unit_Name (Node1)
5724 -- Generic_Associations (List3) (set to No_List if no
5725 -- generic actual part)
5726 -- Parent_Spec (Node4-Sem)
5727 -- Instance_Spec (Node5-Sem)
5728 -- ABE_Is_Certain (Flag18-Sem)
5730 -- N_Procedure_Instantiation
5731 -- Sloc points to PROCEDURE
5732 -- Defining_Unit_Name (Node1)
5734 -- Parent_Spec (Node4-Sem)
5735 -- Generic_Associations (List3) (set to No_List if no
5736 -- generic actual part)
5737 -- Instance_Spec (Node5-Sem)
5738 -- Must_Override (Flag14) set if overriding indicator present
5739 -- Must_Not_Override (Flag15) set if not_overriding indicator present
5740 -- ABE_Is_Certain (Flag18-Sem)
5742 -- N_Function_Instantiation
5743 -- Sloc points to FUNCTION
5744 -- Defining_Unit_Name (Node1)
5746 -- Generic_Associations (List3) (set to No_List if no
5747 -- generic actual part)
5748 -- Parent_Spec (Node4-Sem)
5749 -- Instance_Spec (Node5-Sem)
5750 -- Must_Override (Flag14) set if overriding indicator present
5751 -- Must_Not_Override (Flag15) set if not_overriding indicator present
5752 -- ABE_Is_Certain (Flag18-Sem)
5754 -- Note: overriding indicator is an Ada 2005 feature
5756 ------------------------------
5757 -- 12.3 Generic Actual Part --
5758 ------------------------------
5760 -- GENERIC_ACTUAL_PART ::=
5761 -- (GENERIC_ASSOCIATION {, GENERIC_ASSOCIATION})
5763 -------------------------------
5764 -- 12.3 Generic Association --
5765 -------------------------------
5767 -- GENERIC_ASSOCIATION ::=
5768 -- [generic_formal_parameter_SELECTOR_NAME =>]
5770 -- Note: unlike the procedure call case, a generic association node
5771 -- is generated for every association, even if no formal is present.
5772 -- In this case the parser will leave the Selector_Name field set
5773 -- to Empty, to be filled in later by the semantic pass.
5775 -- In Ada 2005, a formal may be associated with a box, if the
5776 -- association is part of the list of actuals for a formal package.
5777 -- If the association is given by OTHERS => <>, the association is
5778 -- an N_Others_Choice.
5780 -- N_Generic_Association
5781 -- Sloc points to first token of generic association
5782 -- Selector_Name (Node2) (set to Empty if no formal
5783 -- parameter selector name)
5784 -- Explicit_Generic_Actual_Parameter (Node1) (Empty if box present)
5785 -- Box_Present (Flag15) (for formal_package associations with a box)
5787 ---------------------------------------------
5788 -- 12.3 Explicit Generic Actual Parameter --
5789 ---------------------------------------------
5791 -- EXPLICIT_GENERIC_ACTUAL_PARAMETER ::=
5792 -- EXPRESSION | variable_NAME | subprogram_NAME
5793 -- | entry_NAME | SUBTYPE_MARK | package_instance_NAME
5795 -------------------------------------
5796 -- 12.4 Formal Object Declaration --
5797 -------------------------------------
5799 -- FORMAL_OBJECT_DECLARATION ::=
5800 -- DEFINING_IDENTIFIER_LIST :
5801 -- MODE [NULL_EXCLUSION] SUBTYPE_MARK [:= DEFAULT_EXPRESSION];
5802 -- | DEFINING_IDENTIFIER_LIST :
5803 -- MODE ACCESS_DEFINITION [:= DEFAULT_EXPRESSION];
5805 -- Although the syntax allows multiple identifiers in the list, the
5806 -- semantics is as though successive declarations were given with
5807 -- identical type definition and expression components. To simplify
5808 -- semantic processing, the parser represents a multiple declaration
5809 -- case as a sequence of single declarations, using the More_Ids and
5810 -- Prev_Ids flags to preserve the original source form as described
5811 -- in the section on "Handling of Defining Identifier Lists".
5813 -- N_Formal_Object_Declaration
5814 -- Sloc points to first identifier
5815 -- Defining_Identifier (Node1)
5816 -- In_Present (Flag15)
5817 -- Out_Present (Flag17)
5818 -- Null_Exclusion_Present (Flag11) (set to False if not present)
5819 -- Subtype_Mark (Node4) (set to Empty if not present)
5820 -- Access_Definition (Node3) (set to Empty if not present)
5821 -- Default_Expression (Node5) (set to Empty if no default expression)
5822 -- More_Ids (Flag5) (set to False if no more identifiers in list)
5823 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
5825 -----------------------------------
5826 -- 12.5 Formal Type Declaration --
5827 -----------------------------------
5829 -- FORMAL_TYPE_DECLARATION ::=
5830 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART]
5831 -- is FORMAL_TYPE_DEFINITION;
5833 -- N_Formal_Type_Declaration
5834 -- Sloc points to TYPE
5835 -- Defining_Identifier (Node1)
5836 -- Formal_Type_Definition (Node3)
5837 -- Discriminant_Specifications (List4) (set to No_List if no
5838 -- discriminant part)
5839 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
5841 ----------------------------------
5842 -- 12.5 Formal type definition --
5843 ----------------------------------
5845 -- FORMAL_TYPE_DEFINITION ::=
5846 -- FORMAL_PRIVATE_TYPE_DEFINITION
5847 -- | FORMAL_DERIVED_TYPE_DEFINITION
5848 -- | FORMAL_DISCRETE_TYPE_DEFINITION
5849 -- | FORMAL_SIGNED_INTEGER_TYPE_DEFINITION
5850 -- | FORMAL_MODULAR_TYPE_DEFINITION
5851 -- | FORMAL_FLOATING_POINT_DEFINITION
5852 -- | FORMAL_ORDINARY_FIXED_POINT_DEFINITION
5853 -- | FORMAL_DECIMAL_FIXED_POINT_DEFINITION
5854 -- | FORMAL_ARRAY_TYPE_DEFINITION
5855 -- | FORMAL_ACCESS_TYPE_DEFINITION
5856 -- | FORMAL_INTERFACE_TYPE_DEFINITION
5858 ---------------------------------------------
5859 -- 12.5.1 Formal Private Type Definition --
5860 ---------------------------------------------
5862 -- FORMAL_PRIVATE_TYPE_DEFINITION ::=
5863 -- [[abstract] tagged] [limited] private
5865 -- Note: TAGGED is not allowed in Ada 83 mode
5867 -- N_Formal_Private_Type_Definition
5868 -- Sloc points to PRIVATE
5869 -- Abstract_Present (Flag4)
5870 -- Tagged_Present (Flag15)
5871 -- Limited_Present (Flag17)
5873 --------------------------------------------
5874 -- 12.5.1 Formal Derived Type Definition --
5875 --------------------------------------------
5877 -- FORMAL_DERIVED_TYPE_DEFINITION ::=
5878 -- [abstract] [limited | synchronized]
5879 -- new SUBTYPE_MARK [[and INTERFACE_LIST] with private]
5880 -- Note: this construct is not allowed in Ada 83 mode
5882 -- N_Formal_Derived_Type_Definition
5883 -- Sloc points to NEW
5884 -- Subtype_Mark (Node4)
5885 -- Private_Present (Flag15)
5886 -- Abstract_Present (Flag4)
5887 -- Limited_Present (Flag17)
5888 -- Synchronized_Present (Flag7)
5889 -- Interface_List (List2) (set to No_List if none)
5891 ---------------------------------------------
5892 -- 12.5.2 Formal Discrete Type Definition --
5893 ---------------------------------------------
5895 -- FORMAL_DISCRETE_TYPE_DEFINITION ::= (<>)
5897 -- N_Formal_Discrete_Type_Definition
5900 ---------------------------------------------------
5901 -- 12.5.2 Formal Signed Integer Type Definition --
5902 ---------------------------------------------------
5904 -- FORMAL_SIGNED_INTEGER_TYPE_DEFINITION ::= range <>
5906 -- N_Formal_Signed_Integer_Type_Definition
5907 -- Sloc points to RANGE
5909 --------------------------------------------
5910 -- 12.5.2 Formal Modular Type Definition --
5911 --------------------------------------------
5913 -- FORMAL_MODULAR_TYPE_DEFINITION ::= mod <>
5915 -- N_Formal_Modular_Type_Definition
5916 -- Sloc points to MOD
5918 ----------------------------------------------
5919 -- 12.5.2 Formal Floating Point Definition --
5920 ----------------------------------------------
5922 -- FORMAL_FLOATING_POINT_DEFINITION ::= digits <>
5924 -- N_Formal_Floating_Point_Definition
5925 -- Sloc points to DIGITS
5927 ----------------------------------------------------
5928 -- 12.5.2 Formal Ordinary Fixed Point Definition --
5929 ----------------------------------------------------
5931 -- FORMAL_ORDINARY_FIXED_POINT_DEFINITION ::= delta <>
5933 -- N_Formal_Ordinary_Fixed_Point_Definition
5934 -- Sloc points to DELTA
5936 ---------------------------------------------------
5937 -- 12.5.2 Formal Decimal Fixed Point Definition --
5938 ---------------------------------------------------
5940 -- FORMAL_DECIMAL_FIXED_POINT_DEFINITION ::= delta <> digits <>
5942 -- Note: formal decimal fixed point definition not allowed in Ada 83
5944 -- N_Formal_Decimal_Fixed_Point_Definition
5945 -- Sloc points to DELTA
5947 ------------------------------------------
5948 -- 12.5.3 Formal Array Type Definition --
5949 ------------------------------------------
5951 -- FORMAL_ARRAY_TYPE_DEFINITION ::= ARRAY_TYPE_DEFINITION
5953 -------------------------------------------
5954 -- 12.5.4 Formal Access Type Definition --
5955 -------------------------------------------
5957 -- FORMAL_ACCESS_TYPE_DEFINITION ::= ACCESS_TYPE_DEFINITION
5959 ----------------------------------------------
5960 -- 12.5.5 Formal Interface Type Definition --
5961 ----------------------------------------------
5963 -- FORMAL_INTERFACE_TYPE_DEFINITION ::= INTERFACE_TYPE_DEFINITION
5965 -----------------------------------------
5966 -- 12.6 Formal Subprogram Declaration --
5967 -----------------------------------------
5969 -- FORMAL_SUBPROGRAM_DECLARATION ::=
5970 -- FORMAL_CONCRETE_SUBPROGRAM_DECLARATION
5971 -- | FORMAL_ABSTRACT_SUBPROGRAM_DECLARATION
5973 --------------------------------------------------
5974 -- 12.6 Formal Concrete Subprogram Declaration --
5975 --------------------------------------------------
5977 -- FORMAL_CONCRETE_SUBPROGRAM_DECLARATION ::=
5978 -- with SUBPROGRAM_SPECIFICATION [is SUBPROGRAM_DEFAULT];
5980 -- N_Formal_Concrete_Subprogram_Declaration
5981 -- Sloc points to WITH
5982 -- Specification (Node1)
5983 -- Default_Name (Node2) (set to Empty if no subprogram default)
5984 -- Box_Present (Flag15)
5986 -- Note: if no subprogram default is present, then Name is set
5987 -- to Empty, and Box_Present is False.
5989 --------------------------------------------------
5990 -- 12.6 Formal Abstract Subprogram Declaration --
5991 --------------------------------------------------
5993 -- FORMAL_ABSTRACT_SUBPROGRAM_DECLARATION ::=
5994 -- with SUBPROGRAM_SPECIFICATION is abstract [SUBPROGRAM_DEFAULT];
5996 -- N_Formal_Abstract_Subprogram_Declaration
5997 -- Sloc points to WITH
5998 -- Specification (Node1)
5999 -- Default_Name (Node2) (set to Empty if no subprogram default)
6000 -- Box_Present (Flag15)
6002 -- Note: if no subprogram default is present, then Name is set
6003 -- to Empty, and Box_Present is False.
6005 ------------------------------
6006 -- 12.6 Subprogram Default --
6007 ------------------------------
6009 -- SUBPROGRAM_DEFAULT ::= DEFAULT_NAME | <>
6011 -- There is no separate node in the tree for a subprogram default.
6012 -- Instead the parent (N_Formal_Concrete_Subprogram_Declaration
6013 -- or N_Formal_Abstract_Subprogram_Declaration) node contains the
6014 -- default name or box indication, as needed.
6016 ------------------------
6017 -- 12.6 Default Name --
6018 ------------------------
6020 -- DEFAULT_NAME ::= NAME
6022 --------------------------------------
6023 -- 12.7 Formal Package Declaration --
6024 --------------------------------------
6026 -- FORMAL_PACKAGE_DECLARATION ::=
6027 -- with package DEFINING_IDENTIFIER
6028 -- is new generic_package_NAME FORMAL_PACKAGE_ACTUAL_PART;
6030 -- Note: formal package declarations not allowed in Ada 83 mode
6032 -- N_Formal_Package_Declaration
6033 -- Sloc points to WITH
6034 -- Defining_Identifier (Node1)
6036 -- Generic_Associations (List3) (set to No_List if (<>) case or
6037 -- empty generic actual part)
6038 -- Box_Present (Flag15)
6039 -- Instance_Spec (Node5-Sem)
6040 -- ABE_Is_Certain (Flag18-Sem)
6042 --------------------------------------
6043 -- 12.7 Formal Package Actual Part --
6044 --------------------------------------
6046 -- FORMAL_PACKAGE_ACTUAL_PART ::=
6048 -- | [GENERIC_ACTUAL_PART]
6049 -- (FORMAL_PACKAGE_ASSOCIATION {. FORMAL_PACKAGE_ASSOCIATION}
6051 -- FORMAL_PACKAGE_ASSOCIATION ::=
6052 -- GENERIC_ASSOCIATION
6053 -- | GENERIC_FORMAL_PARAMETER_SELECTOR_NAME => <>
6055 -- There is no explicit node in the tree for a formal package actual
6056 -- part. Instead the information appears in the parent node (i.e. the
6057 -- formal package declaration node itself).
6059 -- There is no explicit node for a formal package association. All of
6060 -- them are represented either by a generic association, possibly with
6061 -- Box_Present, or by an N_Others_Choice.
6063 ---------------------------------
6064 -- 13.1 Representation clause --
6065 ---------------------------------
6067 -- REPRESENTATION_CLAUSE ::=
6068 -- ATTRIBUTE_DEFINITION_CLAUSE
6069 -- | ENUMERATION_REPRESENTATION_CLAUSE
6070 -- | RECORD_REPRESENTATION_CLAUSE
6073 ----------------------
6074 -- 13.1 Local Name --
6075 ----------------------
6079 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
6080 -- | library_unit_NAME
6082 -- The construct DIRECT_NAME'ATTRIBUTE_DESIGNATOR appears in the tree
6083 -- as an attribute reference, which has essentially the same form.
6085 ---------------------------------------
6086 -- 13.3 Attribute definition clause --
6087 ---------------------------------------
6089 -- ATTRIBUTE_DEFINITION_CLAUSE ::=
6090 -- for LOCAL_NAME'ATTRIBUTE_DESIGNATOR use EXPRESSION;
6091 -- | for LOCAL_NAME'ATTRIBUTE_DESIGNATOR use NAME;
6093 -- In Ada 83, the expression must be a simple expression and the
6094 -- local name must be a direct name.
6096 -- Note: the only attribute definition clause that is processed by
6097 -- gigi is an address clause. For all other cases, the information
6098 -- is extracted by the front end and either results in setting entity
6099 -- information, e.g. Esize for the Size clause, or in appropriate
6100 -- expansion actions (e.g. in the case of Storage_Size).
6102 -- For an address clause, Gigi constructs the appropriate addressing
6103 -- code. It also ensures that no aliasing optimizations are made
6104 -- for the object for which the address clause appears.
6106 -- Note: for an address clause used to achieve an overlay:
6110 -- for B'Address use A'Address;
6112 -- the above rule means that Gigi will ensure that no optimizations
6113 -- will be made for B that would violate the implementation advice
6114 -- of RM 13.3(19). However, this advice applies only to B and not
6115 -- to A, which seems unfortunate. The GNAT front end will mark the
6116 -- object A as volatile to also prevent unwanted optimization
6117 -- assumptions based on no aliasing being made for B.
6119 -- N_Attribute_Definition_Clause
6120 -- Sloc points to FOR
6121 -- Name (Node2) the local name
6122 -- Chars (Name1) the identifier name from the attribute designator
6123 -- Expression (Node3) the expression or name
6124 -- Entity (Node4-Sem)
6125 -- Next_Rep_Item (Node5-Sem)
6126 -- From_At_Mod (Flag4-Sem)
6127 -- Check_Address_Alignment (Flag11-Sem)
6128 -- Address_Warning_Posted (Flag18-Sem)
6130 ---------------------------------------------
6131 -- 13.4 Enumeration representation clause --
6132 ---------------------------------------------
6134 -- ENUMERATION_REPRESENTATION_CLAUSE ::=
6135 -- for first_subtype_LOCAL_NAME use ENUMERATION_AGGREGATE;
6137 -- In Ada 83, the name must be a direct name
6139 -- N_Enumeration_Representation_Clause
6140 -- Sloc points to FOR
6141 -- Identifier (Node1) direct name
6142 -- Array_Aggregate (Node3)
6143 -- Next_Rep_Item (Node5-Sem)
6145 ---------------------------------
6146 -- 13.4 Enumeration aggregate --
6147 ---------------------------------
6149 -- ENUMERATION_AGGREGATE ::= ARRAY_AGGREGATE
6151 ------------------------------------------
6152 -- 13.5.1 Record representation clause --
6153 ------------------------------------------
6155 -- RECORD_REPRESENTATION_CLAUSE ::=
6156 -- for first_subtype_LOCAL_NAME use
6157 -- record [MOD_CLAUSE]
6158 -- {COMPONENT_CLAUSE}
6161 -- Gigi restriction: Mod_Clause is always Empty (if present it is
6162 -- replaced by a corresponding Alignment attribute definition clause).
6164 -- Note: Component_Clauses can include pragmas
6166 -- N_Record_Representation_Clause
6167 -- Sloc points to FOR
6168 -- Identifier (Node1) direct name
6169 -- Mod_Clause (Node2) (set to Empty if no mod clause present)
6170 -- Component_Clauses (List3)
6171 -- Next_Rep_Item (Node5-Sem)
6173 ------------------------------
6174 -- 13.5.1 Component clause --
6175 ------------------------------
6177 -- COMPONENT_CLAUSE ::=
6178 -- component_LOCAL_NAME at POSITION
6179 -- range FIRST_BIT .. LAST_BIT;
6181 -- N_Component_Clause
6182 -- Sloc points to AT
6183 -- Component_Name (Node1) points to Name or Attribute_Reference
6185 -- First_Bit (Node3)
6188 ----------------------
6189 -- 13.5.1 Position --
6190 ----------------------
6192 -- POSITION ::= static_EXPRESSION
6194 -----------------------
6195 -- 13.5.1 First_Bit --
6196 -----------------------
6198 -- FIRST_BIT ::= static_SIMPLE_EXPRESSION
6200 ----------------------
6201 -- 13.5.1 Last_Bit --
6202 ----------------------
6204 -- LAST_BIT ::= static_SIMPLE_EXPRESSION
6206 --------------------------
6207 -- 13.8 Code statement --
6208 --------------------------
6210 -- CODE_STATEMENT ::= QUALIFIED_EXPRESSION;
6212 -- Note: in GNAT, the qualified expression has the form
6214 -- Asm_Insn'(Asm (...));
6216 -- See package System.Machine_Code in file s-maccod.ads for details on
6217 -- the allowed parameters to Asm. There are two ways this node can
6218 -- arise, as a code statement, in which case the expression is the
6219 -- qualified expression, or as a result of the expansion of an intrinsic
6220 -- call to the Asm or Asm_Input procedure.
6223 -- Sloc points to first token of the expression
6224 -- Expression (Node3)
6226 -- Note: package Exp_Code contains an abstract functional interface
6227 -- for use by Gigi in accessing the data from N_Code_Statement nodes.
6229 ------------------------
6230 -- 13.12 Restriction --
6231 ------------------------
6234 -- restriction_IDENTIFIER
6235 -- | restriction_parameter_IDENTIFIER => EXPRESSION
6237 -- There is no explicit node for restrictions. Instead the restriction
6238 -- appears in normal pragma syntax as a pragma argument association,
6239 -- which has the same syntactic form.
6241 --------------------------
6242 -- B.2 Shift Operators --
6243 --------------------------
6245 -- Calls to the intrinsic shift functions are converted to one of
6246 -- the following shift nodes, which have the form of normal binary
6247 -- operator names. Note that for a given shift operation, one node
6248 -- covers all possible types, as for normal operators.
6250 -- Note: it is perfectly permissible for the expander to generate
6251 -- shift operation nodes directly, in which case they will be analyzed
6252 -- and parsed in the usual manner.
6254 -- Sprint syntax: shift-function-name!(expr, count)
6256 -- Note: the Left_Opnd field holds the first argument (the value to
6257 -- be shifted). The Right_Opnd field holds the second argument (the
6258 -- shift count). The Chars field is the name of the intrinsic function.
6261 -- Sloc points to the function name
6262 -- plus fields for binary operator
6263 -- plus fields for expression
6264 -- Shift_Count_OK (Flag4-Sem)
6266 -- N_Op_Rotate_Right
6267 -- Sloc points to the function name
6268 -- plus fields for binary operator
6269 -- plus fields for expression
6270 -- Shift_Count_OK (Flag4-Sem)
6273 -- Sloc points to the function name
6274 -- plus fields for binary operator
6275 -- plus fields for expression
6276 -- Shift_Count_OK (Flag4-Sem)
6278 -- N_Op_Shift_Right_Arithmetic
6279 -- Sloc points to the function name
6280 -- plus fields for binary operator
6281 -- plus fields for expression
6282 -- Shift_Count_OK (Flag4-Sem)
6285 -- Sloc points to the function name
6286 -- plus fields for binary operator
6287 -- plus fields for expression
6288 -- Shift_Count_OK (Flag4-Sem)
6290 --------------------------
6291 -- Obsolescent Features --
6292 --------------------------
6294 -- The syntax descriptions and tree nodes for obsolescent features are
6295 -- grouped together, corresponding to their location in appendix I in
6296 -- the RM. However, parsing and semantic analysis for these constructs
6297 -- is located in an appropriate chapter (see individual notes).
6299 ---------------------------
6300 -- J.3 Delta Constraint --
6301 ---------------------------
6303 -- Note: the parse routine for this construct is located in section
6304 -- 3.5.9 of Par-Ch3, and semantic analysis is in Sem_Ch3, which is
6305 -- where delta constraint logically belongs.
6307 -- DELTA_CONSTRAINT ::= DELTA static_EXPRESSION [RANGE_CONSTRAINT]
6309 -- N_Delta_Constraint
6310 -- Sloc points to DELTA
6311 -- Delta_Expression (Node3)
6312 -- Range_Constraint (Node4) (set to Empty if not present)
6314 --------------------
6316 --------------------
6318 -- AT_CLAUSE ::= for DIRECT_NAME use at EXPRESSION;
6320 -- Note: the parse routine for this construct is located in Par-Ch13,
6321 -- and the semantic analysis is in Sem_Ch13, where at clause logically
6322 -- belongs if it were not obsolescent.
6324 -- Note: in Ada 83 the expression must be a simple expression
6326 -- Gigi restriction: This node never appears, it is rewritten as an
6327 -- address attribute definition clause.
6330 -- Sloc points to FOR
6331 -- Identifier (Node1)
6332 -- Expression (Node3)
6334 ---------------------
6335 -- J.8 Mod clause --
6336 ---------------------
6338 -- MOD_CLAUSE ::= at mod static_EXPRESSION;
6340 -- Note: the parse routine for this construct is located in Par-Ch13,
6341 -- and the semantic analysis is in Sem_Ch13, where mod clause logically
6342 -- belongs if it were not obsolescent.
6344 -- Note: in Ada 83, the expression must be a simple expression
6346 -- Gigi restriction: this node never appears. It is replaced
6347 -- by a corresponding Alignment attribute definition clause.
6349 -- Note: pragmas can appear before and after the MOD_CLAUSE since
6350 -- its name has "clause" in it. This is rather strange, but is quite
6351 -- definitely specified. The pragmas before are collected in the
6352 -- Pragmas_Before field of the mod clause node itself, and pragmas
6353 -- after are simply swallowed up in the list of component clauses.
6356 -- Sloc points to AT
6357 -- Expression (Node3)
6358 -- Pragmas_Before (List4) Pragmas before mod clause (No_List if none)
6360 --------------------
6361 -- Semantic Nodes --
6362 --------------------
6364 -- These semantic nodes are used to hold additional semantic information.
6365 -- They are inserted into the tree as a result of semantic processing.
6366 -- Although there are no legitimate source syntax constructions that
6367 -- correspond directly to these nodes, we need a source syntax for the
6368 -- reconstructed tree printed by Sprint, and the node descriptions here
6369 -- show this syntax.
6371 ----------------------------
6372 -- Conditional Expression --
6373 ----------------------------
6375 -- This node is used to represent an expression corresponding to the
6376 -- C construct (condition ? then-expression : else_expression), where
6377 -- Expressions is a three element list, whose first expression is the
6378 -- condition, and whose second and third expressions are the then and
6379 -- else expressions respectively.
6381 -- Note: the Then_Actions and Else_Actions fields are always set to
6382 -- No_List in the tree passed to Gigi. These fields are used only
6383 -- for temporary processing purposes in the expander.
6385 -- Sprint syntax: (if expr then expr else expr)
6387 -- N_Conditional_Expression
6388 -- Sloc points to related node
6389 -- Expressions (List1)
6390 -- Then_Actions (List2-Sem)
6391 -- Else_Actions (List3-Sem)
6392 -- plus fields for expression
6394 -- Note: in the case where a debug source file is generated, the Sloc
6395 -- for this node points to the IF keyword in the Sprint file output.
6401 -- The N_Expanded_Name node is used to represent a selected component
6402 -- name that has been resolved to an expanded name. The semantic phase
6403 -- replaces N_Selected_Component nodes that represent names by the use
6404 -- of this node, leaving the N_Selected_Component node used only when
6405 -- the prefix is a record or protected type.
6407 -- The fields of the N_Expanded_Name node are layed out identically
6408 -- to those of the N_Selected_Component node, allowing conversion of
6409 -- an expanded name node to a selected component node to be done
6410 -- easily, see Sinfo.CN.Change_Selected_Component_To_Expanded_Name.
6412 -- There is no special sprint syntax for an expanded name
6415 -- Sloc points to the period
6416 -- Chars (Name1) copy of Chars field of selector name
6418 -- Selector_Name (Node2)
6419 -- Entity (Node4-Sem)
6420 -- Associated_Node (Node4-Sem)
6421 -- Redundant_Use (Flag13-Sem)
6422 -- Has_Private_View (Flag11-Sem) set in generic units.
6423 -- plus fields for expression
6425 --------------------
6426 -- Free Statement --
6427 --------------------
6429 -- The N_Free_Statement node is generated as a result of a call to an
6430 -- instantiation of Unchecked_Deallocation. The instantiation of this
6431 -- generic is handled specially and generates this node directly.
6433 -- Sprint syntax: free expression
6436 -- Sloc is copied from the unchecked deallocation call
6437 -- Expression (Node3) argument to unchecked deallocation call
6438 -- Storage_Pool (Node1-Sem)
6439 -- Procedure_To_Call (Node2-Sem)
6440 -- Actual_Designated_Subtype (Node4-Sem)
6442 -- Note: in the case where a debug source file is generated, the Sloc
6443 -- for this node points to the FREE keyword in the Sprint file output.
6449 -- This node marks the point in a declarative part at which an entity
6450 -- declared therein becomes frozen. The expander places initialization
6451 -- procedures for types at those points. Gigi uses the freezing point
6452 -- to elaborate entities that may depend on previous private types.
6454 -- See the section in Einfo "Delayed Freezing and Elaboration" for
6455 -- a full description of the use of this node.
6457 -- The Entity field points back to the entity for the type (whose
6458 -- Freeze_Node field points back to this freeze node).
6460 -- The Actions field contains a list of declarations and statements
6461 -- generated by the expander which are associated with the freeze
6462 -- node, and are elaborated as though the freeze node were replaced
6463 -- by this sequence of actions.
6465 -- Note: the Sloc field in the freeze node references a construct
6466 -- associated with the freezing point. This is used for posting
6467 -- messages in some error/warning situations, e.g. the case where
6468 -- a primitive operation of a tagged type is declared too late.
6470 -- Sprint syntax: freeze entity-name [
6475 -- Sloc points near freeze point (see above special note)
6476 -- Entity (Node4-Sem)
6477 -- Access_Types_To_Process (Elist2-Sem) (set to No_Elist if none)
6478 -- TSS_Elist (Elist3-Sem) (set to No_Elist if no associated TSS's)
6479 -- Actions (List1) (set to No_List if no freeze actions)
6480 -- First_Subtype_Link (Node5-Sem) (set to Empty if no link)
6482 -- The Actions field holds actions associated with the freeze. These
6483 -- actions are elaborated at the point where the type is frozen.
6485 -- Note: in the case where a debug source file is generated, the Sloc
6486 -- for this node points to the FREEZE keyword in the Sprint file output.
6488 --------------------------------
6489 -- Implicit Label Declaration --
6490 --------------------------------
6492 -- An implicit label declaration is created for every occurrence of a
6493 -- label on a statement or a label on a block or loop. It is chained
6494 -- in the declarations of the innermost enclosing block as specified
6495 -- in RM section 5.1 (3).
6497 -- The Defining_Identifier is the actual identifier for the
6498 -- statement identifier. Note that the occurrence of the label
6499 -- is a reference, NOT the defining occurrence. The defining
6500 -- occurrence occurs at the head of the innermost enclosing
6501 -- block, and is represented by this node.
6503 -- Note: from the grammar, this might better be called an implicit
6504 -- statement identifier declaration, but the term we choose seems
6505 -- friendlier, since at least informally statement identifiers are
6506 -- called labels in both cases (i.e. when used in labels, and when
6507 -- used as the identifiers of blocks and loops).
6509 -- Note: although this is logically a semantic node, since it does
6510 -- not correspond directly to a source syntax construction, these
6511 -- nodes are actually created by the parser in a post pass done just
6512 -- after parsing is complete, before semantic analysis is started (see
6513 -- the Par.Labl subunit in file par-labl.adb).
6515 -- Sprint syntax: labelname : label;
6517 -- N_Implicit_Label_Declaration
6518 -- Sloc points to the << of the label
6519 -- Defining_Identifier (Node1)
6520 -- Label_Construct (Node2-Sem)
6522 -- Note: in the case where a debug source file is generated, the Sloc
6523 -- for this node points to the label name in the generated declaration.
6525 ---------------------
6526 -- Itype_Reference --
6527 ---------------------
6529 -- This node is used to create a reference to an Itype. The only
6530 -- purpose is to make sure that the Itype is defined if this is the
6533 -- A typical use of this node is when an Itype is to be referenced in
6534 -- two branches of an if statement. In this case it is important that
6535 -- the first use of the Itype not be inside the conditional, since
6536 -- then it might not be defined if the wrong branch of the if is
6537 -- taken in the case where the definition generates elaboration code.
6539 -- The Itype field points to the referenced Itype
6541 -- sprint syntax: reference itype-name
6543 -- N_Itype_Reference
6544 -- Sloc points to the node generating the reference
6545 -- Itype (Node1-Sem)
6547 -- Note: in the case where a debug source file is generated, the Sloc
6548 -- for this node points to the REFERENCE keyword in the file output.
6550 ---------------------
6551 -- Raise_xxx_Error --
6552 ---------------------
6554 -- One of these nodes is created during semantic analysis to replace
6555 -- a node for an expression that is determined to definitely raise
6556 -- the corresponding exception.
6558 -- The N_Raise_xxx_Error node may also stand alone in place
6559 -- of a declaration or statement, in which case it simply causes
6560 -- the exception to be raised (i.e. it is equivalent to a raise
6561 -- statement that raises the corresponding exception). This use
6562 -- is distinguished by the fact that the Etype in this case is
6563 -- Standard_Void_Type, In the subexprssion case, the Etype is the
6564 -- same as the type of the subexpression which it replaces.
6566 -- If Condition is empty, then the raise is unconditional. If the
6567 -- Condition field is non-empty, it is a boolean expression which
6568 -- is first evaluated, and the exception is raised only if the
6569 -- value of the expression is True. In the unconditional case, the
6570 -- creation of this node is usually accompanied by a warning message
6571 -- error. The creation of this node will usually be accompanied by a
6572 -- message (unless it appears within the right operand of a short
6573 -- circuit form whose left argument is static and decisively
6574 -- eliminates elaboration of the raise operation. The condition field
6575 -- can ONLY be present when the node is used as a statement form, it
6576 -- may NOT be present in the case where the node appears within an
6579 -- The exception is generated with a message that contains the
6580 -- file name and line number, and then appended text. The Reason
6581 -- code shows the text to be added. The Reason code is an element
6582 -- of the type Types.RT_Exception_Code, and indicates both the
6583 -- message to be added, and the exception to be raised (which must
6584 -- match the node type). The value is stored by storing a Uint which
6585 -- is the Pos value of the enumeration element in this type.
6587 -- Gigi restriction: This expander ensures that the type of the
6588 -- Condition field is always Standard.Boolean, even if the type
6589 -- in the source is some non-standard boolean type.
6591 -- Sprint syntax: [xxx_error "msg"]
6592 -- or: [xxx_error when condition "msg"]
6594 -- N_Raise_Constraint_Error
6595 -- Sloc references related construct
6596 -- Condition (Node1) (set to Empty if no condition)
6598 -- plus fields for expression
6600 -- N_Raise_Program_Error
6601 -- Sloc references related construct
6602 -- Condition (Node1) (set to Empty if no condition)
6604 -- plus fields for expression
6606 -- N_Raise_Storage_Error
6607 -- Sloc references related construct
6608 -- Condition (Node1) (set to Empty if no condition)
6610 -- plus fields for expression
6612 -- Note: Sloc is copied from the expression generating the exception.
6613 -- In the case where a debug source file is generated, the Sloc for
6614 -- this node points to the left bracket in the Sprint file output.
6616 -- Note: the back end may be required to translate these nodes into
6617 -- appropriate goto statements. See description of N_Push/Pop_xxx_Label.
6619 ---------------------------------------------
6620 -- Optimization of Exception Raise to Goto --
6621 ---------------------------------------------
6623 -- In some cases, the front end will determine that any exception raised
6624 -- by the back end for a certain exception should be transformed into a
6627 -- There are three kinds of exceptions raised by the back end (note that
6628 -- for this purpose we consider gigi to be part of the back end in the
6631 -- 1. Exceptions resulting from N_Raise_xxx_Error nodes
6632 -- 2. Exceptions from checks triggered by Do_xxx_Check flags
6633 -- 3. Other cases not specifically marked by the front end
6635 -- Normally all such exceptions are translated into calls to the proper
6636 -- Rcheck_xx procedure, where xx encodes both the exception to be raised
6637 -- and the exception message.
6639 -- The front end may determine that for a particular sequence of code,
6640 -- exceptions in any of these three categories for a particular builtin
6641 -- exception should result in a goto, rather than a call to Rcheck_xx.
6642 -- The exact sequence to be generated is:
6644 -- Local_Raise (exception'Identity);
6647 -- The front end marks such a sequence of code by bracketing it with
6648 -- push and pop nodes:
6650 -- N_Push_xxx_Label (referencing the label)
6652 -- (code where transformation is expected for exception xxx)
6656 -- The use of push/pop reflects the fact that such regions can properly
6657 -- nest, and one special case is a subregion in which no transformation
6658 -- is allowed. Such a region is marked by a N_Push_xxx_Label node whose
6659 -- Exception_Label field is Empty.
6661 -- N_Push_Constraint_Error_Label
6662 -- Sloc references first statement in region covered
6663 -- Exception_Label (Node5-Sem)
6665 -- N_Push_Program_Error_Label
6666 -- Sloc references first statement in region covered
6667 -- Exception_Label (Node5-Sem)
6669 -- N_Push_Storage_Error_Label
6670 -- Sloc references first statement in region covered
6671 -- Exception_Label (Node5-Sem)
6673 -- N_Pop_Constraint_Error_Label
6674 -- Sloc references last statement in region covered
6676 -- N_Pop_Program_Error_Label
6677 -- Sloc references last statement in region covered
6679 -- N_Pop_Storage_Error_Label
6680 -- Sloc references last statement in region covered
6686 -- For a number of purposes, we need to construct references to objects.
6687 -- These references are subsequently treated as normal access values.
6688 -- An example is the construction of the parameter block passed to a
6689 -- task entry. The N_Reference node is provided for this purpose. It is
6690 -- similar in effect to the use of the Unrestricted_Access attribute,
6691 -- and like Unrestricted_Access can be applied to objects which would
6692 -- not be valid prefixes for the Unchecked_Access attribute (e.g.
6693 -- objects which are not aliased, and slices). In addition it can be
6694 -- applied to composite type values as well as objects, including string
6695 -- values and aggregates.
6697 -- Note: we use the Prefix field for this expression so that the
6698 -- resulting node can be treated using common code with the attribute
6699 -- nodes for the 'Access and related attributes. Logically it would make
6700 -- more sense to call it an Expression field, but then we would have to
6701 -- special case the treatment of the N_Reference node.
6703 -- Sprint syntax: prefix'reference
6706 -- Sloc is copied from the expression
6708 -- plus fields for expression
6710 -- Note: in the case where a debug source file is generated, the Sloc
6711 -- for this node points to the quote in the Sprint file output.
6713 ---------------------
6714 -- Subprogram_Info --
6715 ---------------------
6717 -- This node generates the appropriate Subprogram_Info value for a
6718 -- given procedure. See Ada.Exceptions for further details
6720 -- Sprint syntax: subprog'subprogram_info
6722 -- N_Subprogram_Info
6723 -- Sloc points to the entity for the procedure
6724 -- Identifier (Node1) identifier referencing the procedure
6725 -- Etype (Node5-Sem) type (always set to Ada.Exceptions.Code_Loc
6727 -- Note: in the case where a debug source file is generated, the Sloc
6728 -- for this node points to the quote in the Sprint file output.
6730 --------------------------
6731 -- Unchecked Expression --
6732 --------------------------
6734 -- An unchecked expression is one that must be analyzed and resolved
6735 -- with all checks off, regardless of the current setting of scope
6738 -- Sprint syntax: `(expression)
6740 -- Note: this node is always removed from the tree (and replaced by
6741 -- its constituent expression) on completion of analysis, so it only
6742 -- appears in intermediate trees, and will never be seen by Gigi.
6744 -- N_Unchecked_Expression
6745 -- Sloc is a copy of the Sloc of the expression
6746 -- Expression (Node3)
6747 -- plus fields for expression
6749 -- Note: in the case where a debug source file is generated, the Sloc
6750 -- for this node points to the back quote in the Sprint file output.
6752 -------------------------------
6753 -- Unchecked Type Conversion --
6754 -------------------------------
6756 -- An unchecked type conversion node represents the semantic action
6757 -- corresponding to a call to an instantiation of Unchecked_Conversion.
6758 -- It is generated as a result of actual use of Unchecked_Conversion
6759 -- and also the expander generates unchecked type conversion nodes
6760 -- directly for expansion of complex semantic actions.
6762 -- Note: an unchecked type conversion is a variable as far as the
6763 -- semantics are concerned, which is convenient for the expander.
6764 -- This does not change what Ada source programs are legal, since
6765 -- clearly a function call to an instantiation of Unchecked_Conversion
6766 -- is not a variable in any case.
6768 -- Sprint syntax: subtype-mark!(expression)
6770 -- N_Unchecked_Type_Conversion
6771 -- Sloc points to related node in source
6772 -- Subtype_Mark (Node4)
6773 -- Expression (Node3)
6774 -- Kill_Range_Check (Flag11-Sem)
6775 -- No_Truncation (Flag17-Sem)
6776 -- plus fields for expression
6778 -- Note: in the case where a debug source file is generated, the Sloc
6779 -- for this node points to the exclamation in the Sprint file output.
6781 -----------------------------------
6782 -- Validate_Unchecked_Conversion --
6783 -----------------------------------
6785 -- The front end does most of the validation of unchecked conversion,
6786 -- including checking sizes (this is done after the back end is called
6787 -- to take advantage of back-annotation of calculated sizes).
6789 -- The front end also deals with specific cases that are not allowed
6790 -- e.g. involving unconstrained array types.
6792 -- For the case of the standard gigi backend, this means that all
6793 -- checks are done in the front-end.
6795 -- However, in the case of specialized back-ends, notably the JVM
6796 -- backend for JGNAT, additional requirements and restrictions apply
6797 -- to unchecked conversion, and these are most conveniently performed
6798 -- in the specialized back-end.
6800 -- To accommodate this requirement, for such back ends, the following
6801 -- special node is generated recording an unchecked conversion that
6802 -- needs to be validated. The back end should post an appropriate
6803 -- error message if the unchecked conversion is invalid or warrants
6804 -- a special warning message.
6806 -- Source_Type and Target_Type point to the entities for the two
6807 -- types involved in the unchecked conversion instantiation that
6808 -- is to be validated.
6810 -- Sprint syntax: validate Unchecked_Conversion (source, target);
6812 -- N_Validate_Unchecked_Conversion
6813 -- Sloc points to instantiation (location for warning message)
6814 -- Source_Type (Node1-Sem)
6815 -- Target_Type (Node2-Sem)
6817 -- Note: in the case where a debug source file is generated, the Sloc
6818 -- for this node points to the VALIDATE keyword in the file output.
6824 -- Used as the contents of the Nkind field of the dummy Empty node
6825 -- and in some other situations to indicate an uninitialized value.
6828 -- Chars (Name1) is set to No_Name
6834 -- Used as the contents of the Nkind field of the dummy Error node.
6835 -- Has an Etype field, which gets set to Any_Type later on, to help
6836 -- error recovery (Error_Posted is also set in the Error node).
6839 -- Chars (Name1) is set to Error_Name
6840 -- Etype (Node5-Sem)
6842 --------------------------
6843 -- Node Type Definition --
6844 --------------------------
6846 -- The following is the definition of the Node_Kind type. As previously
6847 -- discussed, this is separated off to allow rearrangement of the order
6848 -- to facilitiate definition of subtype ranges. The comments show the
6849 -- subtype classes which apply to each set of node kinds. The first
6850 -- entry in the comment characterizes the following list of nodes.
6855 -- N_Representation_Clause
6859 N_Enumeration_Representation_Clause,
6861 N_Record_Representation_Clause,
6863 -- N_Representation_Clause, N_Has_Chars
6865 N_Attribute_Definition_Clause,
6871 N_Pragma_Argument_Association,
6877 -- N_Entity, N_Has_Etype, N_Has_Chars
6879 N_Defining_Character_Literal,
6880 N_Defining_Identifier,
6881 N_Defining_Operator_Symbol,
6883 -- N_Subexpr, N_Has_Etype, N_Has_Chars, N_Has_Entity
6887 -- N_Direct_Name, N_Subexpr, N_Has_Etype,
6888 -- N_Has_Chars, N_Has_Entity
6893 -- N_Direct_Name, N_Subexpr, N_Has_Etype,
6894 -- N_Has_Chars, N_Has_Entity
6896 N_Character_Literal,
6898 -- N_Binary_Op, N_Op, N_Subexpr,
6899 -- N_Has_Etype, N_Has_Chars, N_Has_Entity
6906 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Treat_Fixed_As_Integer
6907 -- N_Has_Etype, N_Has_Chars, N_Has_Entity, N_Multiplying_Operator
6914 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
6915 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean
6919 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
6920 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean, N_Op_Compare
6929 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
6930 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean
6935 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype,
6936 -- N_Op_Shift, N_Has_Chars, N_Has_Entity
6942 N_Op_Shift_Right_Arithmetic,
6944 -- N_Unary_Op, N_Op, N_Subexpr, N_Has_Etype,
6945 -- N_Has_Chars, N_Has_Entity
6952 -- N_Subexpr, N_Has_Etype, N_Has_Entity
6954 N_Attribute_Reference,
6956 -- N_Subexpr, N_Has_Etype, N_Membership_Test
6961 -- N_Subexpr, N_Has_Etype
6964 N_Conditional_Expression,
6965 N_Explicit_Dereference,
6968 N_Indexed_Component,
6973 N_Procedure_Call_Statement,
6974 N_Qualified_Expression,
6976 -- N_Raise_xxx_Error, N_Subexpr, N_Has_Etype
6978 N_Raise_Constraint_Error,
6979 N_Raise_Program_Error,
6980 N_Raise_Storage_Error,
6982 -- N_Subexpr, N_Has_Etype
6986 N_Extension_Aggregate,
6990 N_Selected_Component,
6995 N_Unchecked_Expression,
6996 N_Unchecked_Type_Conversion,
7000 N_Subtype_Indication,
7004 N_Component_Declaration,
7005 N_Entry_Declaration,
7006 N_Formal_Object_Declaration,
7007 N_Formal_Type_Declaration,
7008 N_Full_Type_Declaration,
7009 N_Incomplete_Type_Declaration,
7010 N_Loop_Parameter_Specification,
7011 N_Object_Declaration,
7012 N_Protected_Type_Declaration,
7013 N_Private_Extension_Declaration,
7014 N_Private_Type_Declaration,
7015 N_Subtype_Declaration,
7017 -- N_Subprogram_Specification, N_Declaration
7019 N_Function_Specification,
7020 N_Procedure_Specification,
7022 -- N_Access_To_Subprogram_Definition
7024 N_Access_Function_Definition,
7025 N_Access_Procedure_Definition,
7027 -- N_Later_Decl_Item
7029 N_Task_Type_Declaration,
7031 -- N_Body_Stub, N_Later_Decl_Item
7033 N_Package_Body_Stub,
7034 N_Protected_Body_Stub,
7035 N_Subprogram_Body_Stub,
7038 -- N_Generic_Instantiation, N_Later_Decl_Item
7039 -- N_Subprogram_Instantiation
7041 N_Function_Instantiation,
7042 N_Procedure_Instantiation,
7044 -- N_Generic_Instantiation, N_Later_Decl_Item
7046 N_Package_Instantiation,
7048 -- N_Unit_Body, N_Later_Decl_Item, N_Proper_Body
7053 -- N_Later_Decl_Item, N_Proper_Body
7058 -- N_Later_Decl_Item
7060 N_Implicit_Label_Declaration,
7061 N_Package_Declaration,
7062 N_Single_Task_Declaration,
7063 N_Subprogram_Declaration,
7064 N_Use_Package_Clause,
7066 -- N_Generic_Declaration, N_Later_Decl_Item
7068 N_Generic_Package_Declaration,
7069 N_Generic_Subprogram_Declaration,
7071 -- N_Array_Type_Definition
7073 N_Constrained_Array_Definition,
7074 N_Unconstrained_Array_Definition,
7076 -- N_Renaming_Declaration
7078 N_Exception_Renaming_Declaration,
7079 N_Object_Renaming_Declaration,
7080 N_Package_Renaming_Declaration,
7081 N_Subprogram_Renaming_Declaration,
7083 -- N_Generic_Renaming_Declaration, N_Renaming_Declaration
7085 N_Generic_Function_Renaming_Declaration,
7086 N_Generic_Package_Renaming_Declaration,
7087 N_Generic_Procedure_Renaming_Declaration,
7089 -- N_Statement_Other_Than_Procedure_Call
7093 N_Assignment_Statement,
7094 N_Asynchronous_Select,
7098 N_Conditional_Entry_Call,
7100 -- N_Statement_Other_Than_Procedure_Call. N_Delay_Statement
7102 N_Delay_Relative_Statement,
7103 N_Delay_Until_Statement,
7105 -- N_Statement_Other_Than_Procedure_Call
7107 N_Entry_Call_Statement,
7113 N_Requeue_Statement,
7114 N_Return_Statement, -- renamed as N_Simple_Return_Statement in Sem_Util
7115 N_Extended_Return_Statement,
7119 -- N_Statement_Other_Than_Procedure_Call, N_Has_Condition
7126 N_Accept_Alternative,
7127 N_Delay_Alternative,
7129 N_Entry_Body_Formal_Part,
7131 N_Terminate_Alternative,
7133 -- N_Formal_Subprogram_Declaration
7135 N_Formal_Abstract_Subprogram_Declaration,
7136 N_Formal_Concrete_Subprogram_Declaration,
7138 -- N_Push_xxx_Label, N_Push_Pop_xxx_Label
7140 N_Push_Constraint_Error_Label,
7141 N_Push_Program_Error_Label,
7142 N_Push_Storage_Error_Label,
7144 -- N_Pop_xxx_Label, N_Push_Pop_xxx_Label
7146 N_Pop_Constraint_Error_Label,
7147 N_Pop_Program_Error_Label,
7148 N_Pop_Storage_Error_Label,
7150 -- Other nodes (not part of any subtype class)
7153 N_Abstract_Subprogram_Declaration,
7154 N_Access_Definition,
7155 N_Access_To_Object_Definition,
7156 N_Case_Statement_Alternative,
7158 N_Compilation_Unit_Aux,
7159 N_Component_Association,
7160 N_Component_Definition,
7162 N_Derived_Type_Definition,
7163 N_Decimal_Fixed_Point_Definition,
7164 N_Defining_Program_Unit_Name,
7167 N_Digits_Constraint,
7168 N_Discriminant_Association,
7169 N_Discriminant_Specification,
7170 N_Enumeration_Type_Definition,
7172 N_Entry_Call_Alternative,
7173 N_Entry_Index_Specification,
7174 N_Exception_Declaration,
7175 N_Exception_Handler,
7176 N_Floating_Point_Definition,
7177 N_Formal_Decimal_Fixed_Point_Definition,
7178 N_Formal_Derived_Type_Definition,
7179 N_Formal_Discrete_Type_Definition,
7180 N_Formal_Floating_Point_Definition,
7181 N_Formal_Modular_Type_Definition,
7182 N_Formal_Ordinary_Fixed_Point_Definition,
7183 N_Formal_Package_Declaration,
7184 N_Formal_Private_Type_Definition,
7185 N_Formal_Signed_Integer_Type_Definition,
7187 N_Generic_Association,
7188 N_Handled_Sequence_Of_Statements,
7189 N_Index_Or_Discriminant_Constraint,
7192 N_Modular_Type_Definition,
7193 N_Number_Declaration,
7194 N_Ordinary_Fixed_Point_Definition,
7196 N_Package_Specification,
7197 N_Parameter_Association,
7198 N_Parameter_Specification,
7199 N_Protected_Definition,
7201 N_Real_Range_Specification,
7202 N_Record_Definition,
7203 N_Signed_Integer_Type_Definition,
7204 N_Single_Protected_Declaration,
7207 N_Triggering_Alternative,
7209 N_Validate_Unchecked_Conversion,
7215 for Node_Kind'Size use 8;
7216 -- The data structures in Atree assume this!
7218 ----------------------------
7219 -- Node Class Definitions --
7220 ----------------------------
7222 subtype N_Access_To_Subprogram_Definition is Node_Kind range
7223 N_Access_Function_Definition ..
7224 N_Access_Procedure_Definition;
7226 subtype N_Array_Type_Definition is Node_Kind range
7227 N_Constrained_Array_Definition ..
7228 N_Unconstrained_Array_Definition;
7230 subtype N_Binary_Op is Node_Kind range
7232 N_Op_Shift_Right_Arithmetic;
7234 subtype N_Body_Stub is Node_Kind range
7235 N_Package_Body_Stub ..
7238 subtype N_Declaration is Node_Kind range
7239 N_Component_Declaration ..
7240 N_Procedure_Specification;
7241 -- Note: this includes all constructs normally thought of as declarations
7242 -- except those which are separately grouped as later declarations.
7244 subtype N_Delay_Statement is Node_Kind range
7245 N_Delay_Relative_Statement ..
7246 N_Delay_Until_Statement;
7248 subtype N_Direct_Name is Node_Kind range
7250 N_Character_Literal;
7252 subtype N_Entity is Node_Kind range
7253 N_Defining_Character_Literal ..
7254 N_Defining_Operator_Symbol;
7256 subtype N_Formal_Subprogram_Declaration is Node_Kind range
7257 N_Formal_Abstract_Subprogram_Declaration ..
7258 N_Formal_Concrete_Subprogram_Declaration;
7260 subtype N_Generic_Declaration is Node_Kind range
7261 N_Generic_Package_Declaration ..
7262 N_Generic_Subprogram_Declaration;
7264 subtype N_Generic_Instantiation is Node_Kind range
7265 N_Function_Instantiation ..
7266 N_Package_Instantiation;
7268 subtype N_Generic_Renaming_Declaration is Node_Kind range
7269 N_Generic_Function_Renaming_Declaration ..
7270 N_Generic_Procedure_Renaming_Declaration;
7272 subtype N_Has_Chars is Node_Kind range
7273 N_Attribute_Definition_Clause ..
7276 subtype N_Has_Entity is Node_Kind range
7278 N_Attribute_Reference;
7279 -- Nodes that have Entity fields
7280 -- Warning: DOES NOT INCLUDE N_Freeze_Entity!
7282 subtype N_Has_Etype is Node_Kind range
7284 N_Subtype_Indication;
7286 subtype N_Has_Treat_Fixed_As_Integer is Node_Kind range
7290 subtype N_Multiplying_Operator is Node_Kind range
7294 subtype N_Later_Decl_Item is Node_Kind range
7295 N_Task_Type_Declaration ..
7296 N_Generic_Subprogram_Declaration;
7297 -- Note: this is Ada 83 relevant only (see Ada 83 RM 3.9 (2)) and
7298 -- includes only those items which can appear as later declarative
7299 -- items. This also includes N_Implicit_Label_Declaration which is
7300 -- not specifically in the grammar but may appear as a valid later
7301 -- declarative items. It does NOT include N_Pragma which can also
7302 -- appear among later declarative items. It does however include
7303 -- N_Protected_Body, which is a bit peculiar, but harmless since
7304 -- this cannot appear in Ada 83 mode anyway.
7306 subtype N_Membership_Test is Node_Kind range
7310 subtype N_Op is Node_Kind range
7314 subtype N_Op_Boolean is Node_Kind range
7317 -- Binary operators which take operands of a boolean type, and yield
7318 -- a result of a boolean type.
7320 subtype N_Op_Compare is Node_Kind range
7324 subtype N_Op_Shift is Node_Kind range
7326 N_Op_Shift_Right_Arithmetic;
7328 subtype N_Proper_Body is Node_Kind range
7332 subtype N_Push_xxx_Label is Node_Kind range
7333 N_Push_Constraint_Error_Label ..
7334 N_Push_Storage_Error_Label;
7336 subtype N_Pop_xxx_Label is Node_Kind range
7337 N_Pop_Constraint_Error_Label ..
7338 N_Pop_Storage_Error_Label;
7340 subtype N_Push_Pop_xxx_Label is Node_Kind range
7341 N_Push_Constraint_Error_Label ..
7342 N_Pop_Storage_Error_Label;
7344 subtype N_Raise_xxx_Error is Node_Kind range
7345 N_Raise_Constraint_Error ..
7346 N_Raise_Storage_Error;
7348 subtype N_Renaming_Declaration is Node_Kind range
7349 N_Exception_Renaming_Declaration ..
7350 N_Generic_Procedure_Renaming_Declaration;
7352 subtype N_Representation_Clause is Node_Kind range
7354 N_Attribute_Definition_Clause;
7356 subtype N_Statement_Other_Than_Procedure_Call is Node_Kind range
7357 N_Abort_Statement ..
7359 -- Note that this includes all statement types except for the cases of the
7360 -- N_Procedure_Call_Statement which is considered to be a subexpression
7361 -- (since overloading is possible, so it needs to go through the normal
7362 -- overloading resolution for expressions).
7364 subtype N_Subprogram_Instantiation is Node_Kind range
7365 N_Function_Instantiation ..
7366 N_Procedure_Instantiation;
7368 subtype N_Has_Condition is Node_Kind range
7370 N_Terminate_Alternative;
7371 -- Nodes with condition fields (does not include N_Raise_xxx_Error)
7373 subtype N_Subexpr is Node_Kind range
7375 N_Unchecked_Type_Conversion;
7376 -- Nodes with expression fields
7378 subtype N_Subprogram_Specification is Node_Kind range
7379 N_Function_Specification ..
7380 N_Procedure_Specification;
7382 subtype N_Unary_Op is Node_Kind range
7386 subtype N_Unit_Body is Node_Kind range
7390 ---------------------------
7391 -- Node Access Functions --
7392 ---------------------------
7394 -- The following functions return the contents of the indicated field of
7395 -- the node referenced by the argument, which is a Node_Id. They provide
7396 -- logical access to fields in the node which could be accessed using the
7397 -- Atree.Unchecked_Access package, but the idea is always to use these
7398 -- higher level routines which preserve strong typing. In debug mode,
7399 -- these routines check that they are being applied to an appropriate
7400 -- node, as well as checking that the node is in range.
7402 function ABE_Is_Certain
7403 (N : Node_Id) return Boolean; -- Flag18
7405 function Abort_Present
7406 (N : Node_Id) return Boolean; -- Flag15
7408 function Abortable_Part
7409 (N : Node_Id) return Node_Id; -- Node2
7411 function Abstract_Present
7412 (N : Node_Id) return Boolean; -- Flag4
7414 function Accept_Handler_Records
7415 (N : Node_Id) return List_Id; -- List5
7417 function Accept_Statement
7418 (N : Node_Id) return Node_Id; -- Node2
7420 function Access_Definition
7421 (N : Node_Id) return Node_Id; -- Node3
7423 function Access_To_Subprogram_Definition
7424 (N : Node_Id) return Node_Id; -- Node3
7426 function Access_Types_To_Process
7427 (N : Node_Id) return Elist_Id; -- Elist2
7430 (N : Node_Id) return List_Id; -- List1
7432 function Activation_Chain_Entity
7433 (N : Node_Id) return Node_Id; -- Node3
7435 function Acts_As_Spec
7436 (N : Node_Id) return Boolean; -- Flag4
7438 function Actual_Designated_Subtype
7439 (N : Node_Id) return Node_Id; -- Node4
7441 function Address_Warning_Posted
7442 (N : Node_Id) return Boolean; -- Flag18
7444 function Aggregate_Bounds
7445 (N : Node_Id) return Node_Id; -- Node3
7447 function Aliased_Present
7448 (N : Node_Id) return Boolean; -- Flag4
7451 (N : Node_Id) return Boolean; -- Flag11
7453 function All_Present
7454 (N : Node_Id) return Boolean; -- Flag15
7456 function Alternatives
7457 (N : Node_Id) return List_Id; -- List4
7459 function Ancestor_Part
7460 (N : Node_Id) return Node_Id; -- Node3
7462 function Array_Aggregate
7463 (N : Node_Id) return Node_Id; -- Node3
7465 function Assignment_OK
7466 (N : Node_Id) return Boolean; -- Flag15
7468 function Associated_Node
7469 (N : Node_Id) return Node_Id; -- Node4
7471 function At_End_Proc
7472 (N : Node_Id) return Node_Id; -- Node1
7474 function Attribute_Name
7475 (N : Node_Id) return Name_Id; -- Name2
7477 function Aux_Decls_Node
7478 (N : Node_Id) return Node_Id; -- Node5
7480 function Backwards_OK
7481 (N : Node_Id) return Boolean; -- Flag6
7483 function Bad_Is_Detected
7484 (N : Node_Id) return Boolean; -- Flag15
7487 (N : Node_Id) return Boolean; -- Flag5
7489 function Body_Required
7490 (N : Node_Id) return Boolean; -- Flag13
7492 function Body_To_Inline
7493 (N : Node_Id) return Node_Id; -- Node3
7495 function Box_Present
7496 (N : Node_Id) return Boolean; -- Flag15
7498 function Char_Literal_Value
7499 (N : Node_Id) return Uint; -- Uint2
7502 (N : Node_Id) return Name_Id; -- Name1
7504 function Check_Address_Alignment
7505 (N : Node_Id) return Boolean; -- Flag11
7507 function Choice_Parameter
7508 (N : Node_Id) return Node_Id; -- Node2
7511 (N : Node_Id) return List_Id; -- List1
7513 function Coextensions
7514 (N : Node_Id) return Elist_Id; -- Elist4
7516 function Comes_From_Extended_Return_Statement
7517 (N : Node_Id) return Boolean; -- Flag18
7519 function Compile_Time_Known_Aggregate
7520 (N : Node_Id) return Boolean; -- Flag18
7522 function Component_Associations
7523 (N : Node_Id) return List_Id; -- List2
7525 function Component_Clauses
7526 (N : Node_Id) return List_Id; -- List3
7528 function Component_Definition
7529 (N : Node_Id) return Node_Id; -- Node4
7531 function Component_Items
7532 (N : Node_Id) return List_Id; -- List3
7534 function Component_List
7535 (N : Node_Id) return Node_Id; -- Node1
7537 function Component_Name
7538 (N : Node_Id) return Node_Id; -- Node1
7541 (N : Node_Id) return Node_Id; -- Node1
7543 function Condition_Actions
7544 (N : Node_Id) return List_Id; -- List3
7546 function Config_Pragmas
7547 (N : Node_Id) return List_Id; -- List4
7549 function Constant_Present
7550 (N : Node_Id) return Boolean; -- Flag17
7553 (N : Node_Id) return Node_Id; -- Node3
7555 function Constraints
7556 (N : Node_Id) return List_Id; -- List1
7558 function Context_Installed
7559 (N : Node_Id) return Boolean; -- Flag13
7561 function Context_Items
7562 (N : Node_Id) return List_Id; -- List1
7564 function Controlling_Argument
7565 (N : Node_Id) return Node_Id; -- Node1
7567 function Conversion_OK
7568 (N : Node_Id) return Boolean; -- Flag14
7570 function Corresponding_Body
7571 (N : Node_Id) return Node_Id; -- Node5
7573 function Corresponding_Formal_Spec
7574 (N : Node_Id) return Node_Id; -- Node3
7576 function Corresponding_Generic_Association
7577 (N : Node_Id) return Node_Id; -- Node5
7579 function Corresponding_Integer_Value
7580 (N : Node_Id) return Uint; -- Uint4
7582 function Corresponding_Spec
7583 (N : Node_Id) return Node_Id; -- Node5
7585 function Corresponding_Stub
7586 (N : Node_Id) return Node_Id; -- Node3
7588 function Dcheck_Function
7589 (N : Node_Id) return Entity_Id; -- Node5
7591 function Debug_Statement
7592 (N : Node_Id) return Node_Id; -- Node3
7594 function Declarations
7595 (N : Node_Id) return List_Id; -- List2
7597 function Default_Expression
7598 (N : Node_Id) return Node_Id; -- Node5
7600 function Default_Name
7601 (N : Node_Id) return Node_Id; -- Node2
7603 function Defining_Identifier
7604 (N : Node_Id) return Entity_Id; -- Node1
7606 function Defining_Unit_Name
7607 (N : Node_Id) return Node_Id; -- Node1
7609 function Delay_Alternative
7610 (N : Node_Id) return Node_Id; -- Node4
7612 function Delay_Statement
7613 (N : Node_Id) return Node_Id; -- Node2
7615 function Delta_Expression
7616 (N : Node_Id) return Node_Id; -- Node3
7618 function Digits_Expression
7619 (N : Node_Id) return Node_Id; -- Node2
7621 function Discr_Check_Funcs_Built
7622 (N : Node_Id) return Boolean; -- Flag11
7624 function Discrete_Choices
7625 (N : Node_Id) return List_Id; -- List4
7627 function Discrete_Range
7628 (N : Node_Id) return Node_Id; -- Node4
7630 function Discrete_Subtype_Definition
7631 (N : Node_Id) return Node_Id; -- Node4
7633 function Discrete_Subtype_Definitions
7634 (N : Node_Id) return List_Id; -- List2
7636 function Discriminant_Specifications
7637 (N : Node_Id) return List_Id; -- List4
7639 function Discriminant_Type
7640 (N : Node_Id) return Node_Id; -- Node5
7642 function Do_Accessibility_Check
7643 (N : Node_Id) return Boolean; -- Flag13
7645 function Do_Discriminant_Check
7646 (N : Node_Id) return Boolean; -- Flag13
7648 function Do_Division_Check
7649 (N : Node_Id) return Boolean; -- Flag13
7651 function Do_Length_Check
7652 (N : Node_Id) return Boolean; -- Flag4
7654 function Do_Overflow_Check
7655 (N : Node_Id) return Boolean; -- Flag17
7657 function Do_Range_Check
7658 (N : Node_Id) return Boolean; -- Flag9
7660 function Do_Storage_Check
7661 (N : Node_Id) return Boolean; -- Flag17
7663 function Do_Tag_Check
7664 (N : Node_Id) return Boolean; -- Flag13
7666 function Elaborate_All_Desirable
7667 (N : Node_Id) return Boolean; -- Flag9
7669 function Elaborate_All_Present
7670 (N : Node_Id) return Boolean; -- Flag14
7672 function Elaborate_Desirable
7673 (N : Node_Id) return Boolean; -- Flag11
7675 function Elaborate_Present
7676 (N : Node_Id) return Boolean; -- Flag4
7678 function Elaboration_Boolean
7679 (N : Node_Id) return Node_Id; -- Node2
7681 function Else_Actions
7682 (N : Node_Id) return List_Id; -- List3
7684 function Else_Statements
7685 (N : Node_Id) return List_Id; -- List4
7687 function Elsif_Parts
7688 (N : Node_Id) return List_Id; -- List3
7690 function Enclosing_Variant
7691 (N : Node_Id) return Node_Id; -- Node2
7694 (N : Node_Id) return Node_Id; -- Node4
7697 (N : Node_Id) return Uint; -- Uint5
7700 (N : Node_Id) return Node_Id; -- Node4
7702 function Entity_Or_Associated_Node
7703 (N : Node_Id) return Node_Id; -- Node4
7705 function Entry_Body_Formal_Part
7706 (N : Node_Id) return Node_Id; -- Node5
7708 function Entry_Call_Alternative
7709 (N : Node_Id) return Node_Id; -- Node1
7711 function Entry_Call_Statement
7712 (N : Node_Id) return Node_Id; -- Node1
7714 function Entry_Direct_Name
7715 (N : Node_Id) return Node_Id; -- Node1
7717 function Entry_Index
7718 (N : Node_Id) return Node_Id; -- Node5
7720 function Entry_Index_Specification
7721 (N : Node_Id) return Node_Id; -- Node4
7724 (N : Node_Id) return Node_Id; -- Node5
7726 function Exception_Choices
7727 (N : Node_Id) return List_Id; -- List4
7729 function Exception_Handlers
7730 (N : Node_Id) return List_Id; -- List5
7732 function Exception_Junk
7733 (N : Node_Id) return Boolean; -- Flag8
7735 function Exception_Label
7736 (N : Node_Id) return Node_Id; -- Node5
7738 function Explicit_Actual_Parameter
7739 (N : Node_Id) return Node_Id; -- Node3
7741 function Expansion_Delayed
7742 (N : Node_Id) return Boolean; -- Flag11
7744 function Explicit_Generic_Actual_Parameter
7745 (N : Node_Id) return Node_Id; -- Node1
7748 (N : Node_Id) return Node_Id; -- Node3
7750 function Expressions
7751 (N : Node_Id) return List_Id; -- List1
7754 (N : Node_Id) return Node_Id; -- Node3
7756 function First_Inlined_Subprogram
7757 (N : Node_Id) return Entity_Id; -- Node3
7760 (N : Node_Id) return Boolean; -- Flag5
7762 function First_Named_Actual
7763 (N : Node_Id) return Node_Id; -- Node4
7765 function First_Real_Statement
7766 (N : Node_Id) return Node_Id; -- Node2
7768 function First_Subtype_Link
7769 (N : Node_Id) return Entity_Id; -- Node5
7771 function Float_Truncate
7772 (N : Node_Id) return Boolean; -- Flag11
7774 function Formal_Type_Definition
7775 (N : Node_Id) return Node_Id; -- Node3
7777 function Forwards_OK
7778 (N : Node_Id) return Boolean; -- Flag5
7780 function From_At_Mod
7781 (N : Node_Id) return Boolean; -- Flag4
7783 function From_Default
7784 (N : Node_Id) return Boolean; -- Flag6
7786 function Generic_Associations
7787 (N : Node_Id) return List_Id; -- List3
7789 function Generic_Formal_Declarations
7790 (N : Node_Id) return List_Id; -- List2
7792 function Generic_Parent
7793 (N : Node_Id) return Node_Id; -- Node5
7795 function Generic_Parent_Type
7796 (N : Node_Id) return Node_Id; -- Node4
7798 function Handled_Statement_Sequence
7799 (N : Node_Id) return Node_Id; -- Node4
7801 function Handler_List_Entry
7802 (N : Node_Id) return Node_Id; -- Node2
7804 function Has_Created_Identifier
7805 (N : Node_Id) return Boolean; -- Flag15
7807 function Has_Dynamic_Length_Check
7808 (N : Node_Id) return Boolean; -- Flag10
7810 function Has_Dynamic_Range_Check
7811 (N : Node_Id) return Boolean; -- Flag12
7813 function Has_Init_Expression
7814 (N : Node_Id) return Boolean; -- Flag14
7816 function Has_Local_Raise
7817 (N : Node_Id) return Boolean; -- Flag8
7819 function Has_No_Elaboration_Code
7820 (N : Node_Id) return Boolean; -- Flag17
7822 function Has_Priority_Pragma
7823 (N : Node_Id) return Boolean; -- Flag6
7825 function Has_Private_View
7826 (N : Node_Id) return Boolean; -- Flag11
7828 function Has_Self_Reference
7829 (N : Node_Id) return Boolean; -- Flag13
7831 function Has_Storage_Size_Pragma
7832 (N : Node_Id) return Boolean; -- Flag5
7834 function Has_Task_Info_Pragma
7835 (N : Node_Id) return Boolean; -- Flag7
7837 function Has_Task_Name_Pragma
7838 (N : Node_Id) return Boolean; -- Flag8
7840 function Has_Wide_Character
7841 (N : Node_Id) return Boolean; -- Flag11
7843 function Hidden_By_Use_Clause
7844 (N : Node_Id) return Elist_Id; -- Elist4
7847 (N : Node_Id) return Node_Id; -- Node2
7850 (N : Node_Id) return Node_Id; -- Node1
7852 function Interface_List
7853 (N : Node_Id) return List_Id; -- List2
7855 function Interface_Present
7856 (N : Node_Id) return Boolean; -- Flag16
7858 function Implicit_With
7859 (N : Node_Id) return Boolean; -- Flag16
7862 (N : Node_Id) return Boolean; -- Flag15
7864 function Includes_Infinities
7865 (N : Node_Id) return Boolean; -- Flag11
7867 function Instance_Spec
7868 (N : Node_Id) return Node_Id; -- Node5
7871 (N : Node_Id) return Uint; -- Uint3
7873 function Is_Asynchronous_Call_Block
7874 (N : Node_Id) return Boolean; -- Flag7
7876 function Is_Component_Left_Opnd
7877 (N : Node_Id) return Boolean; -- Flag13
7879 function Is_Component_Right_Opnd
7880 (N : Node_Id) return Boolean; -- Flag14
7882 function Is_Controlling_Actual
7883 (N : Node_Id) return Boolean; -- Flag16
7885 function Is_Dynamic_Coextension
7886 (N : Node_Id) return Boolean; -- Flag18
7888 function Is_Entry_Barrier_Function
7889 (N : Node_Id) return Boolean; -- Flag8
7891 function Is_Expanded_Build_In_Place_Call
7892 (N : Node_Id) return Boolean; -- Flag11
7894 function Is_Folded_In_Parser
7895 (N : Node_Id) return Boolean; -- Flag4
7897 function Is_In_Discriminant_Check
7898 (N : Node_Id) return Boolean; -- Flag11
7900 function Is_Machine_Number
7901 (N : Node_Id) return Boolean; -- Flag11
7903 function Is_Null_Loop
7904 (N : Node_Id) return Boolean; -- Flag16
7906 function Is_Overloaded
7907 (N : Node_Id) return Boolean; -- Flag5
7909 function Is_Power_Of_2_For_Shift
7910 (N : Node_Id) return Boolean; -- Flag13
7912 function Is_Protected_Subprogram_Body
7913 (N : Node_Id) return Boolean; -- Flag7
7915 function Is_Static_Coextension
7916 (N : Node_Id) return Boolean; -- Flag14
7918 function Is_Static_Expression
7919 (N : Node_Id) return Boolean; -- Flag6
7921 function Is_Subprogram_Descriptor
7922 (N : Node_Id) return Boolean; -- Flag16
7924 function Is_Task_Allocation_Block
7925 (N : Node_Id) return Boolean; -- Flag6
7927 function Is_Task_Master
7928 (N : Node_Id) return Boolean; -- Flag5
7930 function Iteration_Scheme
7931 (N : Node_Id) return Node_Id; -- Node2
7934 (N : Node_Id) return Entity_Id; -- Node1
7936 function Kill_Range_Check
7937 (N : Node_Id) return Boolean; -- Flag11
7939 function Label_Construct
7940 (N : Node_Id) return Node_Id; -- Node2
7943 (N : Node_Id) return Node_Id; -- Node2
7946 (N : Node_Id) return Node_Id; -- Node4
7949 (N : Node_Id) return Boolean; -- Flag6
7951 function Library_Unit
7952 (N : Node_Id) return Node_Id; -- Node4
7954 function Limited_View_Installed
7955 (N : Node_Id) return Boolean; -- Flag18
7957 function Limited_Present
7958 (N : Node_Id) return Boolean; -- Flag17
7961 (N : Node_Id) return List_Id; -- List1
7963 function Local_Raise_Not_OK
7964 (N : Node_Id) return Boolean; -- Flag7
7966 function Local_Raise_Statements
7967 (N : Node_Id) return Elist_Id; -- Elist1
7969 function Loop_Actions
7970 (N : Node_Id) return List_Id; -- List2
7972 function Loop_Parameter_Specification
7973 (N : Node_Id) return Node_Id; -- Node4
7976 (N : Node_Id) return Node_Id; -- Node1
7979 (N : Node_Id) return Node_Id; -- Node2
7982 (N : Node_Id) return Boolean; -- Flag5
7984 function Must_Be_Byte_Aligned
7985 (N : Node_Id) return Boolean; -- Flag14
7987 function Must_Not_Freeze
7988 (N : Node_Id) return Boolean; -- Flag8
7990 function Must_Not_Override
7991 (N : Node_Id) return Boolean; -- Flag15
7993 function Must_Override
7994 (N : Node_Id) return Boolean; -- Flag14
7997 (N : Node_Id) return Node_Id; -- Node2
8000 (N : Node_Id) return List_Id; -- List2
8002 function Next_Entity
8003 (N : Node_Id) return Node_Id; -- Node2
8005 function Next_Named_Actual
8006 (N : Node_Id) return Node_Id; -- Node4
8008 function Next_Rep_Item
8009 (N : Node_Id) return Node_Id; -- Node5
8011 function Next_Use_Clause
8012 (N : Node_Id) return Node_Id; -- Node3
8014 function No_Ctrl_Actions
8015 (N : Node_Id) return Boolean; -- Flag7
8017 function No_Elaboration_Check
8018 (N : Node_Id) return Boolean; -- Flag14
8020 function No_Entities_Ref_In_Spec
8021 (N : Node_Id) return Boolean; -- Flag8
8023 function No_Initialization
8024 (N : Node_Id) return Boolean; -- Flag13
8026 function No_Truncation
8027 (N : Node_Id) return Boolean; -- Flag17
8029 function Null_Present
8030 (N : Node_Id) return Boolean; -- Flag13
8032 function Null_Exclusion_Present
8033 (N : Node_Id) return Boolean; -- Flag11
8035 function Null_Record_Present
8036 (N : Node_Id) return Boolean; -- Flag17
8038 function Object_Definition
8039 (N : Node_Id) return Node_Id; -- Node4
8041 function Original_Discriminant
8042 (N : Node_Id) return Node_Id; -- Node2
8044 function Original_Entity
8045 (N : Node_Id) return Entity_Id; -- Node2
8047 function Others_Discrete_Choices
8048 (N : Node_Id) return List_Id; -- List1
8050 function Out_Present
8051 (N : Node_Id) return Boolean; -- Flag17
8053 function Parameter_Associations
8054 (N : Node_Id) return List_Id; -- List3
8056 function Parameter_List_Truncated
8057 (N : Node_Id) return Boolean; -- Flag17
8059 function Parameter_Specifications
8060 (N : Node_Id) return List_Id; -- List3
8062 function Parameter_Type
8063 (N : Node_Id) return Node_Id; -- Node2
8065 function Parent_Spec
8066 (N : Node_Id) return Node_Id; -- Node4
8069 (N : Node_Id) return Node_Id; -- Node2
8071 function Pragma_Argument_Associations
8072 (N : Node_Id) return List_Id; -- List2
8074 function Pragmas_After
8075 (N : Node_Id) return List_Id; -- List5
8077 function Pragmas_Before
8078 (N : Node_Id) return List_Id; -- List4
8081 (N : Node_Id) return Node_Id; -- Node3
8083 function Present_Expr
8084 (N : Node_Id) return Uint; -- Uint3
8087 (N : Node_Id) return Boolean; -- Flag6
8089 function Print_In_Hex
8090 (N : Node_Id) return Boolean; -- Flag13
8092 function Private_Declarations
8093 (N : Node_Id) return List_Id; -- List3
8095 function Private_Present
8096 (N : Node_Id) return Boolean; -- Flag15
8098 function Procedure_To_Call
8099 (N : Node_Id) return Node_Id; -- Node2
8101 function Proper_Body
8102 (N : Node_Id) return Node_Id; -- Node1
8104 function Protected_Definition
8105 (N : Node_Id) return Node_Id; -- Node3
8107 function Protected_Present
8108 (N : Node_Id) return Boolean; -- Flag6
8110 function Raises_Constraint_Error
8111 (N : Node_Id) return Boolean; -- Flag7
8113 function Range_Constraint
8114 (N : Node_Id) return Node_Id; -- Node4
8116 function Range_Expression
8117 (N : Node_Id) return Node_Id; -- Node4
8119 function Real_Range_Specification
8120 (N : Node_Id) return Node_Id; -- Node4
8123 (N : Node_Id) return Ureal; -- Ureal3
8126 (N : Node_Id) return Uint; -- Uint3
8128 function Record_Extension_Part
8129 (N : Node_Id) return Node_Id; -- Node3
8131 function Redundant_Use
8132 (N : Node_Id) return Boolean; -- Flag13
8134 function Renaming_Exception
8135 (N : Node_Id) return Node_Id; -- Node2
8137 function Result_Definition
8138 (N : Node_Id) return Node_Id; -- Node4
8140 function Return_Object_Declarations
8141 (N : Node_Id) return List_Id; -- List3
8143 function Return_Statement_Entity
8144 (N : Node_Id) return Node_Id; -- Node5
8146 function Reverse_Present
8147 (N : Node_Id) return Boolean; -- Flag15
8150 (N : Node_Id) return Node_Id; -- Node3
8152 function Rounded_Result
8153 (N : Node_Id) return Boolean; -- Flag18
8156 (N : Node_Id) return Node_Id; -- Node3
8158 function Select_Alternatives
8159 (N : Node_Id) return List_Id; -- List1
8161 function Selector_Name
8162 (N : Node_Id) return Node_Id; -- Node2
8164 function Selector_Names
8165 (N : Node_Id) return List_Id; -- List1
8167 function Shift_Count_OK
8168 (N : Node_Id) return Boolean; -- Flag4
8170 function Source_Type
8171 (N : Node_Id) return Entity_Id; -- Node1
8173 function Specification
8174 (N : Node_Id) return Node_Id; -- Node1
8177 (N : Node_Id) return List_Id; -- List3
8179 function Static_Processing_OK
8180 (N : Node_Id) return Boolean; -- Flag4
8182 function Storage_Pool
8183 (N : Node_Id) return Node_Id; -- Node1
8186 (N : Node_Id) return String_Id; -- Str3
8188 function Subtype_Indication
8189 (N : Node_Id) return Node_Id; -- Node5
8191 function Subtype_Mark
8192 (N : Node_Id) return Node_Id; -- Node4
8194 function Subtype_Marks
8195 (N : Node_Id) return List_Id; -- List2
8197 function Synchronized_Present
8198 (N : Node_Id) return Boolean; -- Flag7
8200 function Tagged_Present
8201 (N : Node_Id) return Boolean; -- Flag15
8203 function Target_Type
8204 (N : Node_Id) return Entity_Id; -- Node2
8206 function Task_Definition
8207 (N : Node_Id) return Node_Id; -- Node3
8209 function Task_Present
8210 (N : Node_Id) return Boolean; -- Flag5
8212 function Then_Actions
8213 (N : Node_Id) return List_Id; -- List2
8215 function Then_Statements
8216 (N : Node_Id) return List_Id; -- List2
8218 function Treat_Fixed_As_Integer
8219 (N : Node_Id) return Boolean; -- Flag14
8221 function Triggering_Alternative
8222 (N : Node_Id) return Node_Id; -- Node1
8224 function Triggering_Statement
8225 (N : Node_Id) return Node_Id; -- Node1
8228 (N : Node_Id) return Elist_Id; -- Elist3
8230 function Type_Definition
8231 (N : Node_Id) return Node_Id; -- Node3
8234 (N : Node_Id) return Node_Id; -- Node2
8236 function Unknown_Discriminants_Present
8237 (N : Node_Id) return Boolean; -- Flag13
8239 function Unreferenced_In_Spec
8240 (N : Node_Id) return Boolean; -- Flag7
8242 function Variant_Part
8243 (N : Node_Id) return Node_Id; -- Node4
8246 (N : Node_Id) return List_Id; -- List1
8248 function Visible_Declarations
8249 (N : Node_Id) return List_Id; -- List2
8251 function Was_Originally_Stub
8252 (N : Node_Id) return Boolean; -- Flag13
8254 function Zero_Cost_Handling
8255 (N : Node_Id) return Boolean; -- Flag5
8257 -- End functions (note used by xsinfo utility program to end processing)
8259 ----------------------------
8260 -- Node Update Procedures --
8261 ----------------------------
8263 -- These are the corresponding node update routines, which again provide
8264 -- a high level logical access with type checking. In addition to setting
8265 -- the indicated field of the node N to the given Val, in the case of
8266 -- tree pointers (List1-4), the parent pointer of the Val node is set to
8267 -- point back to node N. This automates the setting of the parent pointer.
8269 procedure Set_ABE_Is_Certain
8270 (N : Node_Id; Val : Boolean := True); -- Flag18
8272 procedure Set_Abort_Present
8273 (N : Node_Id; Val : Boolean := True); -- Flag15
8275 procedure Set_Abortable_Part
8276 (N : Node_Id; Val : Node_Id); -- Node2
8278 procedure Set_Abstract_Present
8279 (N : Node_Id; Val : Boolean := True); -- Flag4
8281 procedure Set_Accept_Handler_Records
8282 (N : Node_Id; Val : List_Id); -- List5
8284 procedure Set_Accept_Statement
8285 (N : Node_Id; Val : Node_Id); -- Node2
8287 procedure Set_Access_Definition
8288 (N : Node_Id; Val : Node_Id); -- Node3
8290 procedure Set_Access_To_Subprogram_Definition
8291 (N : Node_Id; Val : Node_Id); -- Node3
8293 procedure Set_Access_Types_To_Process
8294 (N : Node_Id; Val : Elist_Id); -- Elist2
8296 procedure Set_Actions
8297 (N : Node_Id; Val : List_Id); -- List1
8299 procedure Set_Activation_Chain_Entity
8300 (N : Node_Id; Val : Node_Id); -- Node3
8302 procedure Set_Acts_As_Spec
8303 (N : Node_Id; Val : Boolean := True); -- Flag4
8305 procedure Set_Actual_Designated_Subtype
8306 (N : Node_Id; Val : Node_Id); -- Node4
8308 procedure Set_Address_Warning_Posted
8309 (N : Node_Id; Val : Boolean := True); -- Flag18
8311 procedure Set_Aggregate_Bounds
8312 (N : Node_Id; Val : Node_Id); -- Node3
8314 procedure Set_Aliased_Present
8315 (N : Node_Id; Val : Boolean := True); -- Flag4
8317 procedure Set_All_Others
8318 (N : Node_Id; Val : Boolean := True); -- Flag11
8320 procedure Set_All_Present
8321 (N : Node_Id; Val : Boolean := True); -- Flag15
8323 procedure Set_Alternatives
8324 (N : Node_Id; Val : List_Id); -- List4
8326 procedure Set_Ancestor_Part
8327 (N : Node_Id; Val : Node_Id); -- Node3
8329 procedure Set_Array_Aggregate
8330 (N : Node_Id; Val : Node_Id); -- Node3
8332 procedure Set_Assignment_OK
8333 (N : Node_Id; Val : Boolean := True); -- Flag15
8335 procedure Set_Associated_Node
8336 (N : Node_Id; Val : Node_Id); -- Node4
8338 procedure Set_Attribute_Name
8339 (N : Node_Id; Val : Name_Id); -- Name2
8341 procedure Set_At_End_Proc
8342 (N : Node_Id; Val : Node_Id); -- Node1
8344 procedure Set_Aux_Decls_Node
8345 (N : Node_Id; Val : Node_Id); -- Node5
8347 procedure Set_Backwards_OK
8348 (N : Node_Id; Val : Boolean := True); -- Flag6
8350 procedure Set_Bad_Is_Detected
8351 (N : Node_Id; Val : Boolean := True); -- Flag15
8353 procedure Set_Body_Required
8354 (N : Node_Id; Val : Boolean := True); -- Flag13
8356 procedure Set_Body_To_Inline
8357 (N : Node_Id; Val : Node_Id); -- Node3
8359 procedure Set_Box_Present
8360 (N : Node_Id; Val : Boolean := True); -- Flag15
8362 procedure Set_By_Ref
8363 (N : Node_Id; Val : Boolean := True); -- Flag5
8365 procedure Set_Char_Literal_Value
8366 (N : Node_Id; Val : Uint); -- Uint2
8369 (N : Node_Id; Val : Name_Id); -- Name1
8371 procedure Set_Check_Address_Alignment
8372 (N : Node_Id; Val : Boolean := True); -- Flag11
8374 procedure Set_Choice_Parameter
8375 (N : Node_Id; Val : Node_Id); -- Node2
8377 procedure Set_Coextensions
8378 (N : Node_Id; Val : Elist_Id); -- Elist4
8380 procedure Set_Choices
8381 (N : Node_Id; Val : List_Id); -- List1
8383 procedure Set_Comes_From_Extended_Return_Statement
8384 (N : Node_Id; Val : Boolean := True); -- Flag18
8386 procedure Set_Compile_Time_Known_Aggregate
8387 (N : Node_Id; Val : Boolean := True); -- Flag18
8389 procedure Set_Component_Associations
8390 (N : Node_Id; Val : List_Id); -- List2
8392 procedure Set_Component_Clauses
8393 (N : Node_Id; Val : List_Id); -- List3
8395 procedure Set_Component_Definition
8396 (N : Node_Id; Val : Node_Id); -- Node4
8398 procedure Set_Component_Items
8399 (N : Node_Id; Val : List_Id); -- List3
8401 procedure Set_Component_List
8402 (N : Node_Id; Val : Node_Id); -- Node1
8404 procedure Set_Component_Name
8405 (N : Node_Id; Val : Node_Id); -- Node1
8407 procedure Set_Condition
8408 (N : Node_Id; Val : Node_Id); -- Node1
8410 procedure Set_Condition_Actions
8411 (N : Node_Id; Val : List_Id); -- List3
8413 procedure Set_Config_Pragmas
8414 (N : Node_Id; Val : List_Id); -- List4
8416 procedure Set_Constant_Present
8417 (N : Node_Id; Val : Boolean := True); -- Flag17
8419 procedure Set_Constraint
8420 (N : Node_Id; Val : Node_Id); -- Node3
8422 procedure Set_Constraints
8423 (N : Node_Id; Val : List_Id); -- List1
8425 procedure Set_Context_Installed
8426 (N : Node_Id; Val : Boolean := True); -- Flag13
8428 procedure Set_Context_Items
8429 (N : Node_Id; Val : List_Id); -- List1
8431 procedure Set_Controlling_Argument
8432 (N : Node_Id; Val : Node_Id); -- Node1
8434 procedure Set_Conversion_OK
8435 (N : Node_Id; Val : Boolean := True); -- Flag14
8437 procedure Set_Corresponding_Body
8438 (N : Node_Id; Val : Node_Id); -- Node5
8440 procedure Set_Corresponding_Formal_Spec
8441 (N : Node_Id; Val : Node_Id); -- Node3
8443 procedure Set_Corresponding_Generic_Association
8444 (N : Node_Id; Val : Node_Id); -- Node5
8446 procedure Set_Corresponding_Integer_Value
8447 (N : Node_Id; Val : Uint); -- Uint4
8449 procedure Set_Corresponding_Spec
8450 (N : Node_Id; Val : Node_Id); -- Node5
8452 procedure Set_Corresponding_Stub
8453 (N : Node_Id; Val : Node_Id); -- Node3
8455 procedure Set_Dcheck_Function
8456 (N : Node_Id; Val : Entity_Id); -- Node5
8458 procedure Set_Debug_Statement
8459 (N : Node_Id; Val : Node_Id); -- Node3
8461 procedure Set_Declarations
8462 (N : Node_Id; Val : List_Id); -- List2
8464 procedure Set_Default_Expression
8465 (N : Node_Id; Val : Node_Id); -- Node5
8467 procedure Set_Default_Name
8468 (N : Node_Id; Val : Node_Id); -- Node2
8470 procedure Set_Defining_Identifier
8471 (N : Node_Id; Val : Entity_Id); -- Node1
8473 procedure Set_Defining_Unit_Name
8474 (N : Node_Id; Val : Node_Id); -- Node1
8476 procedure Set_Delay_Alternative
8477 (N : Node_Id; Val : Node_Id); -- Node4
8479 procedure Set_Delay_Statement
8480 (N : Node_Id; Val : Node_Id); -- Node2
8482 procedure Set_Delta_Expression
8483 (N : Node_Id; Val : Node_Id); -- Node3
8485 procedure Set_Digits_Expression
8486 (N : Node_Id; Val : Node_Id); -- Node2
8488 procedure Set_Discr_Check_Funcs_Built
8489 (N : Node_Id; Val : Boolean := True); -- Flag11
8491 procedure Set_Discrete_Choices
8492 (N : Node_Id; Val : List_Id); -- List4
8494 procedure Set_Discrete_Range
8495 (N : Node_Id; Val : Node_Id); -- Node4
8497 procedure Set_Discrete_Subtype_Definition
8498 (N : Node_Id; Val : Node_Id); -- Node4
8500 procedure Set_Discrete_Subtype_Definitions
8501 (N : Node_Id; Val : List_Id); -- List2
8503 procedure Set_Discriminant_Specifications
8504 (N : Node_Id; Val : List_Id); -- List4
8506 procedure Set_Discriminant_Type
8507 (N : Node_Id; Val : Node_Id); -- Node5
8509 procedure Set_Do_Accessibility_Check
8510 (N : Node_Id; Val : Boolean := True); -- Flag13
8512 procedure Set_Do_Discriminant_Check
8513 (N : Node_Id; Val : Boolean := True); -- Flag13
8515 procedure Set_Do_Division_Check
8516 (N : Node_Id; Val : Boolean := True); -- Flag13
8518 procedure Set_Do_Length_Check
8519 (N : Node_Id; Val : Boolean := True); -- Flag4
8521 procedure Set_Do_Overflow_Check
8522 (N : Node_Id; Val : Boolean := True); -- Flag17
8524 procedure Set_Do_Range_Check
8525 (N : Node_Id; Val : Boolean := True); -- Flag9
8527 procedure Set_Do_Storage_Check
8528 (N : Node_Id; Val : Boolean := True); -- Flag17
8530 procedure Set_Do_Tag_Check
8531 (N : Node_Id; Val : Boolean := True); -- Flag13
8533 procedure Set_Elaborate_All_Desirable
8534 (N : Node_Id; Val : Boolean := True); -- Flag9
8536 procedure Set_Elaborate_All_Present
8537 (N : Node_Id; Val : Boolean := True); -- Flag14
8539 procedure Set_Elaborate_Desirable
8540 (N : Node_Id; Val : Boolean := True); -- Flag11
8542 procedure Set_Elaborate_Present
8543 (N : Node_Id; Val : Boolean := True); -- Flag4
8545 procedure Set_Elaboration_Boolean
8546 (N : Node_Id; Val : Node_Id); -- Node2
8548 procedure Set_Else_Actions
8549 (N : Node_Id; Val : List_Id); -- List3
8551 procedure Set_Else_Statements
8552 (N : Node_Id; Val : List_Id); -- List4
8554 procedure Set_Elsif_Parts
8555 (N : Node_Id; Val : List_Id); -- List3
8557 procedure Set_Enclosing_Variant
8558 (N : Node_Id; Val : Node_Id); -- Node2
8560 procedure Set_End_Label
8561 (N : Node_Id; Val : Node_Id); -- Node4
8563 procedure Set_End_Span
8564 (N : Node_Id; Val : Uint); -- Uint5
8566 procedure Set_Entity
8567 (N : Node_Id; Val : Node_Id); -- Node4
8569 procedure Set_Entry_Body_Formal_Part
8570 (N : Node_Id; Val : Node_Id); -- Node5
8572 procedure Set_Entry_Call_Alternative
8573 (N : Node_Id; Val : Node_Id); -- Node1
8575 procedure Set_Entry_Call_Statement
8576 (N : Node_Id; Val : Node_Id); -- Node1
8578 procedure Set_Entry_Direct_Name
8579 (N : Node_Id; Val : Node_Id); -- Node1
8581 procedure Set_Entry_Index
8582 (N : Node_Id; Val : Node_Id); -- Node5
8584 procedure Set_Entry_Index_Specification
8585 (N : Node_Id; Val : Node_Id); -- Node4
8588 (N : Node_Id; Val : Node_Id); -- Node5
8590 procedure Set_Exception_Choices
8591 (N : Node_Id; Val : List_Id); -- List4
8593 procedure Set_Exception_Handlers
8594 (N : Node_Id; Val : List_Id); -- List5
8596 procedure Set_Exception_Junk
8597 (N : Node_Id; Val : Boolean := True); -- Flag8
8599 procedure Set_Exception_Label
8600 (N : Node_Id; Val : Node_Id); -- Node5
8602 procedure Set_Expansion_Delayed
8603 (N : Node_Id; Val : Boolean := True); -- Flag11
8605 procedure Set_Explicit_Actual_Parameter
8606 (N : Node_Id; Val : Node_Id); -- Node3
8608 procedure Set_Explicit_Generic_Actual_Parameter
8609 (N : Node_Id; Val : Node_Id); -- Node1
8611 procedure Set_Expression
8612 (N : Node_Id; Val : Node_Id); -- Node3
8614 procedure Set_Expressions
8615 (N : Node_Id; Val : List_Id); -- List1
8617 procedure Set_First_Bit
8618 (N : Node_Id; Val : Node_Id); -- Node3
8620 procedure Set_First_Inlined_Subprogram
8621 (N : Node_Id; Val : Entity_Id); -- Node3
8623 procedure Set_First_Name
8624 (N : Node_Id; Val : Boolean := True); -- Flag5
8626 procedure Set_First_Named_Actual
8627 (N : Node_Id; Val : Node_Id); -- Node4
8629 procedure Set_First_Real_Statement
8630 (N : Node_Id; Val : Node_Id); -- Node2
8632 procedure Set_First_Subtype_Link
8633 (N : Node_Id; Val : Entity_Id); -- Node5
8635 procedure Set_Float_Truncate
8636 (N : Node_Id; Val : Boolean := True); -- Flag11
8638 procedure Set_Formal_Type_Definition
8639 (N : Node_Id; Val : Node_Id); -- Node3
8641 procedure Set_Forwards_OK
8642 (N : Node_Id; Val : Boolean := True); -- Flag5
8644 procedure Set_From_At_Mod
8645 (N : Node_Id; Val : Boolean := True); -- Flag4
8647 procedure Set_From_Default
8648 (N : Node_Id; Val : Boolean := True); -- Flag6
8650 procedure Set_Generic_Associations
8651 (N : Node_Id; Val : List_Id); -- List3
8653 procedure Set_Generic_Formal_Declarations
8654 (N : Node_Id; Val : List_Id); -- List2
8656 procedure Set_Generic_Parent
8657 (N : Node_Id; Val : Node_Id); -- Node5
8659 procedure Set_Generic_Parent_Type
8660 (N : Node_Id; Val : Node_Id); -- Node4
8662 procedure Set_Handled_Statement_Sequence
8663 (N : Node_Id; Val : Node_Id); -- Node4
8665 procedure Set_Handler_List_Entry
8666 (N : Node_Id; Val : Node_Id); -- Node2
8668 procedure Set_Has_Created_Identifier
8669 (N : Node_Id; Val : Boolean := True); -- Flag15
8671 procedure Set_Has_Dynamic_Length_Check
8672 (N : Node_Id; Val : Boolean := True); -- Flag10
8674 procedure Set_Has_Dynamic_Range_Check
8675 (N : Node_Id; Val : Boolean := True); -- Flag12
8677 procedure Set_Has_Init_Expression
8678 (N : Node_Id; Val : Boolean := True); -- Flag14
8680 procedure Set_Has_Local_Raise
8681 (N : Node_Id; Val : Boolean := True); -- Flag8
8683 procedure Set_Has_No_Elaboration_Code
8684 (N : Node_Id; Val : Boolean := True); -- Flag17
8686 procedure Set_Has_Priority_Pragma
8687 (N : Node_Id; Val : Boolean := True); -- Flag6
8689 procedure Set_Has_Private_View
8690 (N : Node_Id; Val : Boolean := True); -- Flag11
8692 procedure Set_Has_Self_Reference
8693 (N : Node_Id; Val : Boolean := True); -- Flag13
8695 procedure Set_Has_Storage_Size_Pragma
8696 (N : Node_Id; Val : Boolean := True); -- Flag5
8698 procedure Set_Has_Task_Info_Pragma
8699 (N : Node_Id; Val : Boolean := True); -- Flag7
8701 procedure Set_Has_Task_Name_Pragma
8702 (N : Node_Id; Val : Boolean := True); -- Flag8
8704 procedure Set_Has_Wide_Character
8705 (N : Node_Id; Val : Boolean := True); -- Flag11
8707 procedure Set_Hidden_By_Use_Clause
8708 (N : Node_Id; Val : Elist_Id); -- Elist4
8710 procedure Set_High_Bound
8711 (N : Node_Id; Val : Node_Id); -- Node2
8713 procedure Set_Identifier
8714 (N : Node_Id; Val : Node_Id); -- Node1
8716 procedure Set_Interface_List
8717 (N : Node_Id; Val : List_Id); -- List2
8719 procedure Set_Interface_Present
8720 (N : Node_Id; Val : Boolean := True); -- Flag16
8722 procedure Set_Implicit_With
8723 (N : Node_Id; Val : Boolean := True); -- Flag16
8725 procedure Set_In_Present
8726 (N : Node_Id; Val : Boolean := True); -- Flag15
8728 procedure Set_Includes_Infinities
8729 (N : Node_Id; Val : Boolean := True); -- Flag11
8731 procedure Set_Instance_Spec
8732 (N : Node_Id; Val : Node_Id); -- Node5
8734 procedure Set_Intval
8735 (N : Node_Id; Val : Uint); -- Uint3
8737 procedure Set_Is_Asynchronous_Call_Block
8738 (N : Node_Id; Val : Boolean := True); -- Flag7
8740 procedure Set_Is_Component_Left_Opnd
8741 (N : Node_Id; Val : Boolean := True); -- Flag13
8743 procedure Set_Is_Component_Right_Opnd
8744 (N : Node_Id; Val : Boolean := True); -- Flag14
8746 procedure Set_Is_Controlling_Actual
8747 (N : Node_Id; Val : Boolean := True); -- Flag16
8749 procedure Set_Is_Dynamic_Coextension
8750 (N : Node_Id; Val : Boolean := True); -- Flag18
8752 procedure Set_Is_Entry_Barrier_Function
8753 (N : Node_Id; Val : Boolean := True); -- Flag8
8755 procedure Set_Is_Expanded_Build_In_Place_Call
8756 (N : Node_Id; Val : Boolean := True); -- Flag11
8758 procedure Set_Is_Folded_In_Parser
8759 (N : Node_Id; Val : Boolean := True); -- Flag4
8761 procedure Set_Is_In_Discriminant_Check
8762 (N : Node_Id; Val : Boolean := True); -- Flag11
8764 procedure Set_Is_Machine_Number
8765 (N : Node_Id; Val : Boolean := True); -- Flag11
8767 procedure Set_Is_Null_Loop
8768 (N : Node_Id; Val : Boolean := True); -- Flag16
8770 procedure Set_Is_Overloaded
8771 (N : Node_Id; Val : Boolean := True); -- Flag5
8773 procedure Set_Is_Power_Of_2_For_Shift
8774 (N : Node_Id; Val : Boolean := True); -- Flag13
8776 procedure Set_Is_Protected_Subprogram_Body
8777 (N : Node_Id; Val : Boolean := True); -- Flag7
8779 procedure Set_Is_Static_Coextension
8780 (N : Node_Id; Val : Boolean := True); -- Flag14
8782 procedure Set_Is_Static_Expression
8783 (N : Node_Id; Val : Boolean := True); -- Flag6
8785 procedure Set_Is_Subprogram_Descriptor
8786 (N : Node_Id; Val : Boolean := True); -- Flag16
8788 procedure Set_Is_Task_Allocation_Block
8789 (N : Node_Id; Val : Boolean := True); -- Flag6
8791 procedure Set_Is_Task_Master
8792 (N : Node_Id; Val : Boolean := True); -- Flag5
8794 procedure Set_Iteration_Scheme
8795 (N : Node_Id; Val : Node_Id); -- Node2
8798 (N : Node_Id; Val : Entity_Id); -- Node1
8800 procedure Set_Kill_Range_Check
8801 (N : Node_Id; Val : Boolean := True); -- Flag11
8803 procedure Set_Last_Bit
8804 (N : Node_Id; Val : Node_Id); -- Node4
8806 procedure Set_Last_Name
8807 (N : Node_Id; Val : Boolean := True); -- Flag6
8809 procedure Set_Library_Unit
8810 (N : Node_Id; Val : Node_Id); -- Node4
8812 procedure Set_Label_Construct
8813 (N : Node_Id; Val : Node_Id); -- Node2
8815 procedure Set_Left_Opnd
8816 (N : Node_Id; Val : Node_Id); -- Node2
8818 procedure Set_Limited_View_Installed
8819 (N : Node_Id; Val : Boolean := True); -- Flag18
8821 procedure Set_Limited_Present
8822 (N : Node_Id; Val : Boolean := True); -- Flag17
8824 procedure Set_Literals
8825 (N : Node_Id; Val : List_Id); -- List1
8827 procedure Set_Local_Raise_Not_OK
8828 (N : Node_Id; Val : Boolean := True); -- Flag7
8830 procedure Set_Local_Raise_Statements
8831 (N : Node_Id; Val : Elist_Id); -- Elist1
8833 procedure Set_Loop_Actions
8834 (N : Node_Id; Val : List_Id); -- List2
8836 procedure Set_Loop_Parameter_Specification
8837 (N : Node_Id; Val : Node_Id); -- Node4
8839 procedure Set_Low_Bound
8840 (N : Node_Id; Val : Node_Id); -- Node1
8842 procedure Set_Mod_Clause
8843 (N : Node_Id; Val : Node_Id); -- Node2
8845 procedure Set_More_Ids
8846 (N : Node_Id; Val : Boolean := True); -- Flag5
8848 procedure Set_Must_Be_Byte_Aligned
8849 (N : Node_Id; Val : Boolean := True); -- Flag14
8851 procedure Set_Must_Not_Freeze
8852 (N : Node_Id; Val : Boolean := True); -- Flag8
8854 procedure Set_Must_Not_Override
8855 (N : Node_Id; Val : Boolean := True); -- Flag15
8857 procedure Set_Must_Override
8858 (N : Node_Id; Val : Boolean := True); -- Flag14
8861 (N : Node_Id; Val : Node_Id); -- Node2
8864 (N : Node_Id; Val : List_Id); -- List2
8866 procedure Set_Next_Entity
8867 (N : Node_Id; Val : Node_Id); -- Node2
8869 procedure Set_Next_Named_Actual
8870 (N : Node_Id; Val : Node_Id); -- Node4
8872 procedure Set_Next_Rep_Item
8873 (N : Node_Id; Val : Node_Id); -- Node5
8875 procedure Set_Next_Use_Clause
8876 (N : Node_Id; Val : Node_Id); -- Node3
8878 procedure Set_No_Ctrl_Actions
8879 (N : Node_Id; Val : Boolean := True); -- Flag7
8881 procedure Set_No_Elaboration_Check
8882 (N : Node_Id; Val : Boolean := True); -- Flag14
8884 procedure Set_No_Entities_Ref_In_Spec
8885 (N : Node_Id; Val : Boolean := True); -- Flag8
8887 procedure Set_No_Initialization
8888 (N : Node_Id; Val : Boolean := True); -- Flag13
8890 procedure Set_No_Truncation
8891 (N : Node_Id; Val : Boolean := True); -- Flag17
8893 procedure Set_Null_Present
8894 (N : Node_Id; Val : Boolean := True); -- Flag13
8896 procedure Set_Null_Exclusion_Present
8897 (N : Node_Id; Val : Boolean := True); -- Flag11
8899 procedure Set_Null_Record_Present
8900 (N : Node_Id; Val : Boolean := True); -- Flag17
8902 procedure Set_Object_Definition
8903 (N : Node_Id; Val : Node_Id); -- Node4
8905 procedure Set_Original_Discriminant
8906 (N : Node_Id; Val : Node_Id); -- Node2
8908 procedure Set_Original_Entity
8909 (N : Node_Id; Val : Entity_Id); -- Node2
8911 procedure Set_Others_Discrete_Choices
8912 (N : Node_Id; Val : List_Id); -- List1
8914 procedure Set_Out_Present
8915 (N : Node_Id; Val : Boolean := True); -- Flag17
8917 procedure Set_Parameter_Associations
8918 (N : Node_Id; Val : List_Id); -- List3
8920 procedure Set_Parameter_List_Truncated
8921 (N : Node_Id; Val : Boolean := True); -- Flag17
8923 procedure Set_Parameter_Specifications
8924 (N : Node_Id; Val : List_Id); -- List3
8926 procedure Set_Parameter_Type
8927 (N : Node_Id; Val : Node_Id); -- Node2
8929 procedure Set_Parent_Spec
8930 (N : Node_Id; Val : Node_Id); -- Node4
8932 procedure Set_Position
8933 (N : Node_Id; Val : Node_Id); -- Node2
8935 procedure Set_Pragma_Argument_Associations
8936 (N : Node_Id; Val : List_Id); -- List2
8938 procedure Set_Pragmas_After
8939 (N : Node_Id; Val : List_Id); -- List5
8941 procedure Set_Pragmas_Before
8942 (N : Node_Id; Val : List_Id); -- List4
8944 procedure Set_Prefix
8945 (N : Node_Id; Val : Node_Id); -- Node3
8947 procedure Set_Present_Expr
8948 (N : Node_Id; Val : Uint); -- Uint3
8950 procedure Set_Prev_Ids
8951 (N : Node_Id; Val : Boolean := True); -- Flag6
8953 procedure Set_Print_In_Hex
8954 (N : Node_Id; Val : Boolean := True); -- Flag13
8956 procedure Set_Private_Declarations
8957 (N : Node_Id; Val : List_Id); -- List3
8959 procedure Set_Private_Present
8960 (N : Node_Id; Val : Boolean := True); -- Flag15
8962 procedure Set_Procedure_To_Call
8963 (N : Node_Id; Val : Node_Id); -- Node2
8965 procedure Set_Proper_Body
8966 (N : Node_Id; Val : Node_Id); -- Node1
8968 procedure Set_Protected_Definition
8969 (N : Node_Id; Val : Node_Id); -- Node3
8971 procedure Set_Protected_Present
8972 (N : Node_Id; Val : Boolean := True); -- Flag6
8974 procedure Set_Raises_Constraint_Error
8975 (N : Node_Id; Val : Boolean := True); -- Flag7
8977 procedure Set_Range_Constraint
8978 (N : Node_Id; Val : Node_Id); -- Node4
8980 procedure Set_Range_Expression
8981 (N : Node_Id; Val : Node_Id); -- Node4
8983 procedure Set_Real_Range_Specification
8984 (N : Node_Id; Val : Node_Id); -- Node4
8986 procedure Set_Realval
8987 (N : Node_Id; Val : Ureal); -- Ureal3
8989 procedure Set_Reason
8990 (N : Node_Id; Val : Uint); -- Uint3
8992 procedure Set_Record_Extension_Part
8993 (N : Node_Id; Val : Node_Id); -- Node3
8995 procedure Set_Redundant_Use
8996 (N : Node_Id; Val : Boolean := True); -- Flag13
8998 procedure Set_Renaming_Exception
8999 (N : Node_Id; Val : Node_Id); -- Node2
9001 procedure Set_Result_Definition
9002 (N : Node_Id; Val : Node_Id); -- Node4
9004 procedure Set_Return_Object_Declarations
9005 (N : Node_Id; Val : List_Id); -- List3
9007 procedure Set_Return_Statement_Entity
9008 (N : Node_Id; Val : Node_Id); -- Node5
9010 procedure Set_Reverse_Present
9011 (N : Node_Id; Val : Boolean := True); -- Flag15
9013 procedure Set_Right_Opnd
9014 (N : Node_Id; Val : Node_Id); -- Node3
9016 procedure Set_Rounded_Result
9017 (N : Node_Id; Val : Boolean := True); -- Flag18
9020 (N : Node_Id; Val : Node_Id); -- Node3
9022 procedure Set_Select_Alternatives
9023 (N : Node_Id; Val : List_Id); -- List1
9025 procedure Set_Selector_Name
9026 (N : Node_Id; Val : Node_Id); -- Node2
9028 procedure Set_Selector_Names
9029 (N : Node_Id; Val : List_Id); -- List1
9031 procedure Set_Shift_Count_OK
9032 (N : Node_Id; Val : Boolean := True); -- Flag4
9034 procedure Set_Source_Type
9035 (N : Node_Id; Val : Entity_Id); -- Node1
9037 procedure Set_Specification
9038 (N : Node_Id; Val : Node_Id); -- Node1
9040 procedure Set_Statements
9041 (N : Node_Id; Val : List_Id); -- List3
9043 procedure Set_Static_Processing_OK
9044 (N : Node_Id; Val : Boolean); -- Flag4
9046 procedure Set_Storage_Pool
9047 (N : Node_Id; Val : Node_Id); -- Node1
9049 procedure Set_Strval
9050 (N : Node_Id; Val : String_Id); -- Str3
9052 procedure Set_Subtype_Indication
9053 (N : Node_Id; Val : Node_Id); -- Node5
9055 procedure Set_Subtype_Mark
9056 (N : Node_Id; Val : Node_Id); -- Node4
9058 procedure Set_Subtype_Marks
9059 (N : Node_Id; Val : List_Id); -- List2
9061 procedure Set_Synchronized_Present
9062 (N : Node_Id; Val : Boolean := True); -- Flag7
9064 procedure Set_Tagged_Present
9065 (N : Node_Id; Val : Boolean := True); -- Flag15
9067 procedure Set_Target_Type
9068 (N : Node_Id; Val : Entity_Id); -- Node2
9070 procedure Set_Task_Definition
9071 (N : Node_Id; Val : Node_Id); -- Node3
9073 procedure Set_Task_Present
9074 (N : Node_Id; Val : Boolean := True); -- Flag5
9076 procedure Set_Then_Actions
9077 (N : Node_Id; Val : List_Id); -- List2
9079 procedure Set_Then_Statements
9080 (N : Node_Id; Val : List_Id); -- List2
9082 procedure Set_Treat_Fixed_As_Integer
9083 (N : Node_Id; Val : Boolean := True); -- Flag14
9085 procedure Set_Triggering_Alternative
9086 (N : Node_Id; Val : Node_Id); -- Node1
9088 procedure Set_Triggering_Statement
9089 (N : Node_Id; Val : Node_Id); -- Node1
9091 procedure Set_TSS_Elist
9092 (N : Node_Id; Val : Elist_Id); -- Elist3
9094 procedure Set_Type_Definition
9095 (N : Node_Id; Val : Node_Id); -- Node3
9098 (N : Node_Id; Val : Node_Id); -- Node2
9100 procedure Set_Unknown_Discriminants_Present
9101 (N : Node_Id; Val : Boolean := True); -- Flag13
9103 procedure Set_Unreferenced_In_Spec
9104 (N : Node_Id; Val : Boolean := True); -- Flag7
9106 procedure Set_Variant_Part
9107 (N : Node_Id; Val : Node_Id); -- Node4
9109 procedure Set_Variants
9110 (N : Node_Id; Val : List_Id); -- List1
9112 procedure Set_Visible_Declarations
9113 (N : Node_Id; Val : List_Id); -- List2
9115 procedure Set_Was_Originally_Stub
9116 (N : Node_Id; Val : Boolean := True); -- Flag13
9118 procedure Set_Zero_Cost_Handling
9119 (N : Node_Id; Val : Boolean := True); -- Flag5
9121 -------------------------
9122 -- Iterator Procedures --
9123 -------------------------
9125 -- The call to Next_xxx (N) is equivalent to N := Next_xxx (N)
9127 procedure Next_Entity (N : in out Node_Id);
9128 procedure Next_Named_Actual (N : in out Node_Id);
9129 procedure Next_Rep_Item (N : in out Node_Id);
9130 procedure Next_Use_Clause (N : in out Node_Id);
9132 --------------------------------------
9133 -- Logical Access to End_Span Field --
9134 --------------------------------------
9136 function End_Location (N : Node_Id) return Source_Ptr;
9137 -- N is an N_If_Statement or N_Case_Statement node, and this
9138 -- function returns the location of the IF token in the END IF
9139 -- sequence by translating the value of the End_Span field.
9141 procedure Set_End_Location (N : Node_Id; S : Source_Ptr);
9142 -- N is an N_If_Statement or N_Case_Statement node. This procedure
9143 -- sets the End_Span field to correspond to the given value S. In
9144 -- other words, End_Span is set to the difference between S and
9145 -- Sloc (N), the starting location.
9147 -----------------------------
9148 -- Syntactic Parent Tables --
9149 -----------------------------
9151 -- These tables show for each node, and for each of the five fields,
9152 -- whether the corresponding field is syntactic (True) or semantic (False).
9153 -- Unused entries are also set to False.
9155 subtype Field_Num is Natural range 1 .. 5;
9157 Is_Syntactic_Field : constant array (Node_Kind, Field_Num) of Boolean := (
9159 -- Following entries can be built automatically from the sinfo sources
9160 -- using the makeisf utility (currently this program is in spitbol).
9163 (1 => True, -- Chars (Name1)
9164 2 => False, -- Original_Discriminant (Node2-Sem)
9165 3 => False, -- unused
9166 4 => False, -- Entity (Node4-Sem)
9167 5 => False), -- Etype (Node5-Sem)
9169 N_Integer_Literal =>
9170 (1 => False, -- unused
9171 2 => False, -- Original_Entity (Node2-Sem)
9172 3 => True, -- Intval (Uint3)
9173 4 => False, -- unused
9174 5 => False), -- Etype (Node5-Sem)
9177 (1 => False, -- unused
9178 2 => False, -- Original_Entity (Node2-Sem)
9179 3 => True, -- Realval (Ureal3)
9180 4 => False, -- Corresponding_Integer_Value (Uint4-Sem)
9181 5 => False), -- Etype (Node5-Sem)
9183 N_Character_Literal =>
9184 (1 => True, -- Chars (Name1)
9185 2 => True, -- Char_Literal_Value (Uint2)
9186 3 => False, -- unused
9187 4 => False, -- Entity (Node4-Sem)
9188 5 => False), -- Etype (Node5-Sem)
9191 (1 => False, -- unused
9192 2 => False, -- unused
9193 3 => True, -- Strval (Str3)
9194 4 => False, -- unused
9195 5 => False), -- Etype (Node5-Sem)
9198 (1 => True, -- Chars (Name1)
9199 2 => True, -- Pragma_Argument_Associations (List2)
9200 3 => True, -- Debug_Statement (Node3)
9201 4 => False, -- Entity (Node4-Sem)
9202 5 => False), -- Next_Rep_Item (Node5-Sem)
9204 N_Pragma_Argument_Association =>
9205 (1 => True, -- Chars (Name1)
9206 2 => False, -- unused
9207 3 => True, -- Expression (Node3)
9208 4 => False, -- unused
9209 5 => False), -- unused
9211 N_Defining_Identifier =>
9212 (1 => True, -- Chars (Name1)
9213 2 => False, -- Next_Entity (Node2-Sem)
9214 3 => False, -- Scope (Node3-Sem)
9215 4 => False, -- unused
9216 5 => False), -- Etype (Node5-Sem)
9218 N_Full_Type_Declaration =>
9219 (1 => True, -- Defining_Identifier (Node1)
9220 2 => False, -- unused
9221 3 => True, -- Type_Definition (Node3)
9222 4 => True, -- Discriminant_Specifications (List4)
9223 5 => False), -- unused
9225 N_Subtype_Declaration =>
9226 (1 => True, -- Defining_Identifier (Node1)
9227 2 => False, -- unused
9228 3 => False, -- unused
9229 4 => False, -- Generic_Parent_Type (Node4-Sem)
9230 5 => True), -- Subtype_Indication (Node5)
9232 N_Subtype_Indication =>
9233 (1 => False, -- unused
9234 2 => False, -- unused
9235 3 => True, -- Constraint (Node3)
9236 4 => True, -- Subtype_Mark (Node4)
9237 5 => False), -- Etype (Node5-Sem)
9239 N_Object_Declaration =>
9240 (1 => True, -- Defining_Identifier (Node1)
9241 2 => False, -- Handler_List_Entry (Node2-Sem)
9242 3 => True, -- Expression (Node3)
9243 4 => True, -- Object_Definition (Node4)
9244 5 => False), -- Corresponding_Generic_Association (Node5-Sem)
9246 N_Number_Declaration =>
9247 (1 => True, -- Defining_Identifier (Node1)
9248 2 => False, -- unused
9249 3 => True, -- Expression (Node3)
9250 4 => False, -- unused
9251 5 => False), -- unused
9253 N_Derived_Type_Definition =>
9254 (1 => False, -- unused
9255 2 => True, -- Interface_List (List2)
9256 3 => True, -- Record_Extension_Part (Node3)
9257 4 => False, -- unused
9258 5 => True), -- Subtype_Indication (Node5)
9260 N_Range_Constraint =>
9261 (1 => False, -- unused
9262 2 => False, -- unused
9263 3 => False, -- unused
9264 4 => True, -- Range_Expression (Node4)
9265 5 => False), -- unused
9268 (1 => True, -- Low_Bound (Node1)
9269 2 => True, -- High_Bound (Node2)
9270 3 => False, -- unused
9271 4 => False, -- unused
9272 5 => False), -- Etype (Node5-Sem)
9274 N_Enumeration_Type_Definition =>
9275 (1 => True, -- Literals (List1)
9276 2 => False, -- unused
9277 3 => False, -- unused
9278 4 => True, -- End_Label (Node4)
9279 5 => False), -- unused
9281 N_Defining_Character_Literal =>
9282 (1 => True, -- Chars (Name1)
9283 2 => False, -- Next_Entity (Node2-Sem)
9284 3 => False, -- Scope (Node3-Sem)
9285 4 => False, -- unused
9286 5 => False), -- Etype (Node5-Sem)
9288 N_Signed_Integer_Type_Definition =>
9289 (1 => True, -- Low_Bound (Node1)
9290 2 => True, -- High_Bound (Node2)
9291 3 => False, -- unused
9292 4 => False, -- unused
9293 5 => False), -- unused
9295 N_Modular_Type_Definition =>
9296 (1 => False, -- unused
9297 2 => False, -- unused
9298 3 => True, -- Expression (Node3)
9299 4 => False, -- unused
9300 5 => False), -- unused
9302 N_Floating_Point_Definition =>
9303 (1 => False, -- unused
9304 2 => True, -- Digits_Expression (Node2)
9305 3 => False, -- unused
9306 4 => True, -- Real_Range_Specification (Node4)
9307 5 => False), -- unused
9309 N_Real_Range_Specification =>
9310 (1 => True, -- Low_Bound (Node1)
9311 2 => True, -- High_Bound (Node2)
9312 3 => False, -- unused
9313 4 => False, -- unused
9314 5 => False), -- unused
9316 N_Ordinary_Fixed_Point_Definition =>
9317 (1 => False, -- unused
9318 2 => False, -- unused
9319 3 => True, -- Delta_Expression (Node3)
9320 4 => True, -- Real_Range_Specification (Node4)
9321 5 => False), -- unused
9323 N_Decimal_Fixed_Point_Definition =>
9324 (1 => False, -- unused
9325 2 => True, -- Digits_Expression (Node2)
9326 3 => True, -- Delta_Expression (Node3)
9327 4 => True, -- Real_Range_Specification (Node4)
9328 5 => False), -- unused
9330 N_Digits_Constraint =>
9331 (1 => False, -- unused
9332 2 => True, -- Digits_Expression (Node2)
9333 3 => False, -- unused
9334 4 => True, -- Range_Constraint (Node4)
9335 5 => False), -- unused
9337 N_Unconstrained_Array_Definition =>
9338 (1 => False, -- unused
9339 2 => True, -- Subtype_Marks (List2)
9340 3 => False, -- unused
9341 4 => True, -- Component_Definition (Node4)
9342 5 => False), -- unused
9344 N_Constrained_Array_Definition =>
9345 (1 => False, -- unused
9346 2 => True, -- Discrete_Subtype_Definitions (List2)
9347 3 => False, -- unused
9348 4 => True, -- Component_Definition (Node4)
9349 5 => False), -- unused
9351 N_Component_Definition =>
9352 (1 => False, -- unused
9353 2 => False, -- unused
9354 3 => True, -- Access_Definition (Node3)
9355 4 => False, -- unused
9356 5 => True), -- Subtype_Indication (Node5)
9358 N_Discriminant_Specification =>
9359 (1 => True, -- Defining_Identifier (Node1)
9360 2 => False, -- unused
9361 3 => True, -- Expression (Node3)
9362 4 => False, -- unused
9363 5 => True), -- Discriminant_Type (Node5)
9365 N_Index_Or_Discriminant_Constraint =>
9366 (1 => True, -- Constraints (List1)
9367 2 => False, -- unused
9368 3 => False, -- unused
9369 4 => False, -- unused
9370 5 => False), -- unused
9372 N_Discriminant_Association =>
9373 (1 => True, -- Selector_Names (List1)
9374 2 => False, -- unused
9375 3 => True, -- Expression (Node3)
9376 4 => False, -- unused
9377 5 => False), -- unused
9379 N_Record_Definition =>
9380 (1 => True, -- Component_List (Node1)
9381 2 => True, -- Interface_List (List2)
9382 3 => False, -- unused
9383 4 => True, -- End_Label (Node4)
9384 5 => False), -- unused
9387 (1 => False, -- unused
9388 2 => False, -- unused
9389 3 => True, -- Component_Items (List3)
9390 4 => True, -- Variant_Part (Node4)
9391 5 => False), -- unused
9393 N_Component_Declaration =>
9394 (1 => True, -- Defining_Identifier (Node1)
9395 2 => False, -- unused
9396 3 => True, -- Expression (Node3)
9397 4 => True, -- Component_Definition (Node4)
9398 5 => False), -- unused
9401 (1 => True, -- Variants (List1)
9402 2 => True, -- Name (Node2)
9403 3 => False, -- unused
9404 4 => False, -- unused
9405 5 => False), -- unused
9408 (1 => True, -- Component_List (Node1)
9409 2 => False, -- Enclosing_Variant (Node2-Sem)
9410 3 => False, -- Present_Expr (Uint3-Sem)
9411 4 => True, -- Discrete_Choices (List4)
9412 5 => False), -- Dcheck_Function (Node5-Sem)
9415 (1 => False, -- Others_Discrete_Choices (List1-Sem)
9416 2 => False, -- unused
9417 3 => False, -- unused
9418 4 => False, -- unused
9419 5 => False), -- unused
9421 N_Access_To_Object_Definition =>
9422 (1 => False, -- unused
9423 2 => False, -- unused
9424 3 => False, -- unused
9425 4 => False, -- unused
9426 5 => True), -- Subtype_Indication (Node5)
9428 N_Access_Function_Definition =>
9429 (1 => False, -- unused
9430 2 => False, -- unused
9431 3 => True, -- Parameter_Specifications (List3)
9432 4 => True, -- Result_Definition (Node4)
9433 5 => False), -- unused
9435 N_Access_Procedure_Definition =>
9436 (1 => False, -- unused
9437 2 => False, -- unused
9438 3 => True, -- Parameter_Specifications (List3)
9439 4 => False, -- unused
9440 5 => False), -- unused
9442 N_Access_Definition =>
9443 (1 => False, -- unused
9444 2 => False, -- unused
9445 3 => True, -- Access_To_Subprogram_Definition (Node3)
9446 4 => True, -- Subtype_Mark (Node4)
9447 5 => False), -- unused
9449 N_Incomplete_Type_Declaration =>
9450 (1 => True, -- Defining_Identifier (Node1)
9451 2 => False, -- unused
9452 3 => False, -- unused
9453 4 => True, -- Discriminant_Specifications (List4)
9454 5 => False), -- unused
9456 N_Explicit_Dereference =>
9457 (1 => False, -- unused
9458 2 => False, -- unused
9459 3 => True, -- Prefix (Node3)
9460 4 => False, -- Actual_Designated_Subtype (Node4-Sem)
9461 5 => False), -- Etype (Node5-Sem)
9463 N_Indexed_Component =>
9464 (1 => True, -- Expressions (List1)
9465 2 => False, -- unused
9466 3 => True, -- Prefix (Node3)
9467 4 => False, -- unused
9468 5 => False), -- Etype (Node5-Sem)
9471 (1 => False, -- unused
9472 2 => False, -- unused
9473 3 => True, -- Prefix (Node3)
9474 4 => True, -- Discrete_Range (Node4)
9475 5 => False), -- Etype (Node5-Sem)
9477 N_Selected_Component =>
9478 (1 => False, -- unused
9479 2 => True, -- Selector_Name (Node2)
9480 3 => True, -- Prefix (Node3)
9481 4 => False, -- unused
9482 5 => False), -- Etype (Node5-Sem)
9484 N_Attribute_Reference =>
9485 (1 => True, -- Expressions (List1)
9486 2 => True, -- Attribute_Name (Name2)
9487 3 => True, -- Prefix (Node3)
9488 4 => False, -- Entity (Node4-Sem)
9489 5 => False), -- Etype (Node5-Sem)
9492 (1 => True, -- Expressions (List1)
9493 2 => True, -- Component_Associations (List2)
9494 3 => False, -- Aggregate_Bounds (Node3-Sem)
9495 4 => False, -- unused
9496 5 => False), -- Etype (Node5-Sem)
9498 N_Component_Association =>
9499 (1 => True, -- Choices (List1)
9500 2 => False, -- Loop_Actions (List2-Sem)
9501 3 => True, -- Expression (Node3)
9502 4 => False, -- unused
9503 5 => False), -- unused
9505 N_Extension_Aggregate =>
9506 (1 => True, -- Expressions (List1)
9507 2 => True, -- Component_Associations (List2)
9508 3 => True, -- Ancestor_Part (Node3)
9509 4 => False, -- unused
9510 5 => False), -- Etype (Node5-Sem)
9513 (1 => False, -- unused
9514 2 => False, -- unused
9515 3 => False, -- unused
9516 4 => False, -- unused
9517 5 => False), -- Etype (Node5-Sem)
9520 (1 => False, -- Actions (List1-Sem)
9521 2 => True, -- Left_Opnd (Node2)
9522 3 => True, -- Right_Opnd (Node3)
9523 4 => False, -- unused
9524 5 => False), -- Etype (Node5-Sem)
9527 (1 => False, -- Actions (List1-Sem)
9528 2 => True, -- Left_Opnd (Node2)
9529 3 => True, -- Right_Opnd (Node3)
9530 4 => False, -- unused
9531 5 => False), -- Etype (Node5-Sem)
9534 (1 => False, -- unused
9535 2 => True, -- Left_Opnd (Node2)
9536 3 => True, -- Right_Opnd (Node3)
9537 4 => False, -- unused
9538 5 => False), -- Etype (Node5-Sem)
9541 (1 => False, -- unused
9542 2 => True, -- Left_Opnd (Node2)
9543 3 => True, -- Right_Opnd (Node3)
9544 4 => False, -- unused
9545 5 => False), -- Etype (Node5-Sem)
9548 (1 => True, -- Chars (Name1)
9549 2 => True, -- Left_Opnd (Node2)
9550 3 => True, -- Right_Opnd (Node3)
9551 4 => False, -- Entity (Node4-Sem)
9552 5 => False), -- Etype (Node5-Sem)
9555 (1 => True, -- Chars (Name1)
9556 2 => True, -- Left_Opnd (Node2)
9557 3 => True, -- Right_Opnd (Node3)
9558 4 => False, -- Entity (Node4-Sem)
9559 5 => False), -- Etype (Node5-Sem)
9562 (1 => True, -- Chars (Name1)
9563 2 => True, -- Left_Opnd (Node2)
9564 3 => True, -- Right_Opnd (Node3)
9565 4 => False, -- Entity (Node4-Sem)
9566 5 => False), -- Etype (Node5-Sem)
9569 (1 => True, -- Chars (Name1)
9570 2 => True, -- Left_Opnd (Node2)
9571 3 => True, -- Right_Opnd (Node3)
9572 4 => False, -- Entity (Node4-Sem)
9573 5 => False), -- Etype (Node5-Sem)
9576 (1 => True, -- Chars (Name1)
9577 2 => True, -- Left_Opnd (Node2)
9578 3 => True, -- Right_Opnd (Node3)
9579 4 => False, -- Entity (Node4-Sem)
9580 5 => False), -- Etype (Node5-Sem)
9583 (1 => True, -- Chars (Name1)
9584 2 => True, -- Left_Opnd (Node2)
9585 3 => True, -- Right_Opnd (Node3)
9586 4 => False, -- Entity (Node4-Sem)
9587 5 => False), -- Etype (Node5-Sem)
9590 (1 => True, -- Chars (Name1)
9591 2 => True, -- Left_Opnd (Node2)
9592 3 => True, -- Right_Opnd (Node3)
9593 4 => False, -- Entity (Node4-Sem)
9594 5 => False), -- Etype (Node5-Sem)
9597 (1 => True, -- Chars (Name1)
9598 2 => True, -- Left_Opnd (Node2)
9599 3 => True, -- Right_Opnd (Node3)
9600 4 => False, -- Entity (Node4-Sem)
9601 5 => False), -- Etype (Node5-Sem)
9604 (1 => True, -- Chars (Name1)
9605 2 => True, -- Left_Opnd (Node2)
9606 3 => True, -- Right_Opnd (Node3)
9607 4 => False, -- Entity (Node4-Sem)
9608 5 => False), -- Etype (Node5-Sem)
9611 (1 => True, -- Chars (Name1)
9612 2 => True, -- Left_Opnd (Node2)
9613 3 => True, -- Right_Opnd (Node3)
9614 4 => False, -- Entity (Node4-Sem)
9615 5 => False), -- Etype (Node5-Sem)
9618 (1 => True, -- Chars (Name1)
9619 2 => True, -- Left_Opnd (Node2)
9620 3 => True, -- Right_Opnd (Node3)
9621 4 => False, -- Entity (Node4-Sem)
9622 5 => False), -- Etype (Node5-Sem)
9625 (1 => True, -- Chars (Name1)
9626 2 => True, -- Left_Opnd (Node2)
9627 3 => True, -- Right_Opnd (Node3)
9628 4 => False, -- Entity (Node4-Sem)
9629 5 => False), -- Etype (Node5-Sem)
9632 (1 => True, -- Chars (Name1)
9633 2 => True, -- Left_Opnd (Node2)
9634 3 => True, -- Right_Opnd (Node3)
9635 4 => False, -- Entity (Node4-Sem)
9636 5 => False), -- Etype (Node5-Sem)
9639 (1 => True, -- Chars (Name1)
9640 2 => True, -- Left_Opnd (Node2)
9641 3 => True, -- Right_Opnd (Node3)
9642 4 => False, -- Entity (Node4-Sem)
9643 5 => False), -- Etype (Node5-Sem)
9646 (1 => True, -- Chars (Name1)
9647 2 => True, -- Left_Opnd (Node2)
9648 3 => True, -- Right_Opnd (Node3)
9649 4 => False, -- Entity (Node4-Sem)
9650 5 => False), -- Etype (Node5-Sem)
9653 (1 => True, -- Chars (Name1)
9654 2 => True, -- Left_Opnd (Node2)
9655 3 => True, -- Right_Opnd (Node3)
9656 4 => False, -- Entity (Node4-Sem)
9657 5 => False), -- Etype (Node5-Sem)
9660 (1 => True, -- Chars (Name1)
9661 2 => True, -- Left_Opnd (Node2)
9662 3 => True, -- Right_Opnd (Node3)
9663 4 => False, -- Entity (Node4-Sem)
9664 5 => False), -- Etype (Node5-Sem)
9667 (1 => True, -- Chars (Name1)
9668 2 => False, -- unused
9669 3 => True, -- Right_Opnd (Node3)
9670 4 => False, -- Entity (Node4-Sem)
9671 5 => False), -- Etype (Node5-Sem)
9674 (1 => True, -- Chars (Name1)
9675 2 => False, -- unused
9676 3 => True, -- Right_Opnd (Node3)
9677 4 => False, -- Entity (Node4-Sem)
9678 5 => False), -- Etype (Node5-Sem)
9681 (1 => True, -- Chars (Name1)
9682 2 => False, -- unused
9683 3 => True, -- Right_Opnd (Node3)
9684 4 => False, -- Entity (Node4-Sem)
9685 5 => False), -- Etype (Node5-Sem)
9688 (1 => True, -- Chars (Name1)
9689 2 => False, -- unused
9690 3 => True, -- Right_Opnd (Node3)
9691 4 => False, -- Entity (Node4-Sem)
9692 5 => False), -- Etype (Node5-Sem)
9694 N_Type_Conversion =>
9695 (1 => False, -- unused
9696 2 => False, -- unused
9697 3 => True, -- Expression (Node3)
9698 4 => True, -- Subtype_Mark (Node4)
9699 5 => False), -- Etype (Node5-Sem)
9701 N_Qualified_Expression =>
9702 (1 => False, -- unused
9703 2 => False, -- unused
9704 3 => True, -- Expression (Node3)
9705 4 => True, -- Subtype_Mark (Node4)
9706 5 => False), -- Etype (Node5-Sem)
9709 (1 => False, -- Storage_Pool (Node1-Sem)
9710 2 => False, -- Procedure_To_Call (Node2-Sem)
9711 3 => True, -- Expression (Node3)
9712 4 => False, -- Coextensions (Elist4-Sem)
9713 5 => False), -- Etype (Node5-Sem)
9716 (1 => False, -- unused
9717 2 => False, -- unused
9718 3 => False, -- unused
9719 4 => False, -- unused
9720 5 => False), -- unused
9723 (1 => True, -- Identifier (Node1)
9724 2 => False, -- unused
9725 3 => False, -- unused
9726 4 => False, -- unused
9727 5 => False), -- unused
9729 N_Assignment_Statement =>
9730 (1 => False, -- unused
9731 2 => True, -- Name (Node2)
9732 3 => True, -- Expression (Node3)
9733 4 => False, -- unused
9734 5 => False), -- unused
9737 (1 => True, -- Condition (Node1)
9738 2 => True, -- Then_Statements (List2)
9739 3 => True, -- Elsif_Parts (List3)
9740 4 => True, -- Else_Statements (List4)
9741 5 => True), -- End_Span (Uint5)
9744 (1 => True, -- Condition (Node1)
9745 2 => True, -- Then_Statements (List2)
9746 3 => False, -- Condition_Actions (List3-Sem)
9747 4 => False, -- unused
9748 5 => False), -- unused
9751 (1 => False, -- unused
9752 2 => False, -- unused
9753 3 => True, -- Expression (Node3)
9754 4 => True, -- Alternatives (List4)
9755 5 => True), -- End_Span (Uint5)
9757 N_Case_Statement_Alternative =>
9758 (1 => False, -- unused
9759 2 => False, -- unused
9760 3 => True, -- Statements (List3)
9761 4 => True, -- Discrete_Choices (List4)
9762 5 => False), -- unused
9765 (1 => True, -- Identifier (Node1)
9766 2 => True, -- Iteration_Scheme (Node2)
9767 3 => True, -- Statements (List3)
9768 4 => True, -- End_Label (Node4)
9769 5 => False), -- unused
9771 N_Iteration_Scheme =>
9772 (1 => True, -- Condition (Node1)
9773 2 => False, -- unused
9774 3 => False, -- Condition_Actions (List3-Sem)
9775 4 => True, -- Loop_Parameter_Specification (Node4)
9776 5 => False), -- unused
9778 N_Loop_Parameter_Specification =>
9779 (1 => True, -- Defining_Identifier (Node1)
9780 2 => False, -- unused
9781 3 => False, -- unused
9782 4 => True, -- Discrete_Subtype_Definition (Node4)
9783 5 => False), -- unused
9785 N_Block_Statement =>
9786 (1 => True, -- Identifier (Node1)
9787 2 => True, -- Declarations (List2)
9788 3 => False, -- Activation_Chain_Entity (Node3-Sem)
9789 4 => True, -- Handled_Statement_Sequence (Node4)
9790 5 => False), -- unused
9793 (1 => True, -- Condition (Node1)
9794 2 => True, -- Name (Node2)
9795 3 => False, -- unused
9796 4 => False, -- unused
9797 5 => False), -- unused
9800 (1 => False, -- unused
9801 2 => True, -- Name (Node2)
9802 3 => False, -- unused
9803 4 => False, -- unused
9804 5 => False), -- unused
9806 N_Subprogram_Declaration =>
9807 (1 => True, -- Specification (Node1)
9808 2 => False, -- unused
9809 3 => False, -- Body_To_Inline (Node3-Sem)
9810 4 => False, -- Parent_Spec (Node4-Sem)
9811 5 => False), -- Corresponding_Body (Node5-Sem)
9813 N_Abstract_Subprogram_Declaration =>
9814 (1 => True, -- Specification (Node1)
9815 2 => False, -- unused
9816 3 => False, -- unused
9817 4 => False, -- unused
9818 5 => False), -- unused
9820 N_Function_Specification =>
9821 (1 => True, -- Defining_Unit_Name (Node1)
9822 2 => False, -- Elaboration_Boolean (Node2-Sem)
9823 3 => True, -- Parameter_Specifications (List3)
9824 4 => True, -- Result_Definition (Node4)
9825 5 => False), -- Generic_Parent (Node5-Sem)
9827 N_Procedure_Specification =>
9828 (1 => True, -- Defining_Unit_Name (Node1)
9829 2 => False, -- Elaboration_Boolean (Node2-Sem)
9830 3 => True, -- Parameter_Specifications (List3)
9831 4 => False, -- unused
9832 5 => False), -- Generic_Parent (Node5-Sem)
9835 (1 => True, -- Identifier (Node1)
9836 2 => True, -- Name (Node2)
9837 3 => False, -- unused
9838 4 => False, -- unused
9839 5 => False), -- unused
9841 N_Defining_Program_Unit_Name =>
9842 (1 => True, -- Defining_Identifier (Node1)
9843 2 => True, -- Name (Node2)
9844 3 => False, -- unused
9845 4 => False, -- unused
9846 5 => False), -- unused
9848 N_Operator_Symbol =>
9849 (1 => True, -- Chars (Name1)
9850 2 => False, -- unused
9851 3 => True, -- Strval (Str3)
9852 4 => False, -- Entity (Node4-Sem)
9853 5 => False), -- Etype (Node5-Sem)
9855 N_Defining_Operator_Symbol =>
9856 (1 => True, -- Chars (Name1)
9857 2 => False, -- Next_Entity (Node2-Sem)
9858 3 => False, -- Scope (Node3-Sem)
9859 4 => False, -- unused
9860 5 => False), -- Etype (Node5-Sem)
9862 N_Parameter_Specification =>
9863 (1 => True, -- Defining_Identifier (Node1)
9864 2 => True, -- Parameter_Type (Node2)
9865 3 => True, -- Expression (Node3)
9866 4 => False, -- unused
9867 5 => False), -- Default_Expression (Node5-Sem)
9869 N_Subprogram_Body =>
9870 (1 => True, -- Specification (Node1)
9871 2 => True, -- Declarations (List2)
9872 3 => False, -- Activation_Chain_Entity (Node3-Sem)
9873 4 => True, -- Handled_Statement_Sequence (Node4)
9874 5 => False), -- Corresponding_Spec (Node5-Sem)
9876 N_Procedure_Call_Statement =>
9877 (1 => False, -- Controlling_Argument (Node1-Sem)
9878 2 => True, -- Name (Node2)
9879 3 => True, -- Parameter_Associations (List3)
9880 4 => False, -- First_Named_Actual (Node4-Sem)
9881 5 => False), -- Etype (Node5-Sem)
9884 (1 => False, -- Controlling_Argument (Node1-Sem)
9885 2 => True, -- Name (Node2)
9886 3 => True, -- Parameter_Associations (List3)
9887 4 => False, -- First_Named_Actual (Node4-Sem)
9888 5 => False), -- Etype (Node5-Sem)
9890 N_Parameter_Association =>
9891 (1 => False, -- unused
9892 2 => True, -- Selector_Name (Node2)
9893 3 => True, -- Explicit_Actual_Parameter (Node3)
9894 4 => False, -- Next_Named_Actual (Node4-Sem)
9895 5 => False), -- unused
9897 N_Return_Statement =>
9898 (1 => False, -- Storage_Pool (Node1-Sem)
9899 2 => False, -- Procedure_To_Call (Node2-Sem)
9900 3 => True, -- Expression (Node3)
9901 4 => False, -- unused
9902 5 => False), -- Return_Statement_Entity (Node5-Sem)
9904 N_Extended_Return_Statement =>
9905 (1 => False, -- Storage_Pool (Node1-Sem)
9906 2 => False, -- Procedure_To_Call (Node2-Sem)
9907 3 => True, -- Return_Object_Declarations (List3)
9908 4 => True, -- Handled_Statement_Sequence (Node4)
9909 5 => False), -- Return_Statement_Entity (Node5-Sem)
9911 N_Package_Declaration =>
9912 (1 => True, -- Specification (Node1)
9913 2 => False, -- unused
9914 3 => False, -- Activation_Chain_Entity (Node3-Sem)
9915 4 => False, -- Parent_Spec (Node4-Sem)
9916 5 => False), -- Corresponding_Body (Node5-Sem)
9918 N_Package_Specification =>
9919 (1 => True, -- Defining_Unit_Name (Node1)
9920 2 => True, -- Visible_Declarations (List2)
9921 3 => True, -- Private_Declarations (List3)
9922 4 => True, -- End_Label (Node4)
9923 5 => False), -- Generic_Parent (Node5-Sem)
9926 (1 => True, -- Defining_Unit_Name (Node1)
9927 2 => True, -- Declarations (List2)
9928 3 => False, -- unused
9929 4 => True, -- Handled_Statement_Sequence (Node4)
9930 5 => False), -- Corresponding_Spec (Node5-Sem)
9932 N_Private_Type_Declaration =>
9933 (1 => True, -- Defining_Identifier (Node1)
9934 2 => False, -- unused
9935 3 => False, -- unused
9936 4 => True, -- Discriminant_Specifications (List4)
9937 5 => False), -- unused
9939 N_Private_Extension_Declaration =>
9940 (1 => True, -- Defining_Identifier (Node1)
9941 2 => True, -- Interface_List (List2)
9942 3 => False, -- unused
9943 4 => True, -- Discriminant_Specifications (List4)
9944 5 => True), -- Subtype_Indication (Node5)
9946 N_Use_Package_Clause =>
9947 (1 => False, -- unused
9948 2 => True, -- Names (List2)
9949 3 => False, -- Next_Use_Clause (Node3-Sem)
9950 4 => False, -- Hidden_By_Use_Clause (Elist4-Sem)
9951 5 => False), -- unused
9953 N_Use_Type_Clause =>
9954 (1 => False, -- unused
9955 2 => True, -- Subtype_Marks (List2)
9956 3 => False, -- Next_Use_Clause (Node3-Sem)
9957 4 => False, -- Hidden_By_Use_Clause (Elist4-Sem)
9958 5 => False), -- unused
9960 N_Object_Renaming_Declaration =>
9961 (1 => True, -- Defining_Identifier (Node1)
9962 2 => True, -- Name (Node2)
9963 3 => True, -- Access_Definition (Node3)
9964 4 => True, -- Subtype_Mark (Node4)
9965 5 => False), -- Corresponding_Generic_Association (Node5-Sem)
9967 N_Exception_Renaming_Declaration =>
9968 (1 => True, -- Defining_Identifier (Node1)
9969 2 => True, -- Name (Node2)
9970 3 => False, -- unused
9971 4 => False, -- unused
9972 5 => False), -- unused
9974 N_Package_Renaming_Declaration =>
9975 (1 => True, -- Defining_Unit_Name (Node1)
9976 2 => True, -- Name (Node2)
9977 3 => False, -- unused
9978 4 => False, -- Parent_Spec (Node4-Sem)
9979 5 => False), -- unused
9981 N_Subprogram_Renaming_Declaration =>
9982 (1 => True, -- Specification (Node1)
9983 2 => True, -- Name (Node2)
9984 3 => False, -- Corresponding_Formal_Spec (Node3-Sem)
9985 4 => False, -- Parent_Spec (Node4-Sem)
9986 5 => False), -- Corresponding_Spec (Node5-Sem)
9988 N_Generic_Package_Renaming_Declaration =>
9989 (1 => True, -- Defining_Unit_Name (Node1)
9990 2 => True, -- Name (Node2)
9991 3 => False, -- unused
9992 4 => False, -- Parent_Spec (Node4-Sem)
9993 5 => False), -- unused
9995 N_Generic_Procedure_Renaming_Declaration =>
9996 (1 => True, -- Defining_Unit_Name (Node1)
9997 2 => True, -- Name (Node2)
9998 3 => False, -- unused
9999 4 => False, -- Parent_Spec (Node4-Sem)
10000 5 => False), -- unused
10002 N_Generic_Function_Renaming_Declaration =>
10003 (1 => True, -- Defining_Unit_Name (Node1)
10004 2 => True, -- Name (Node2)
10005 3 => False, -- unused
10006 4 => False, -- Parent_Spec (Node4-Sem)
10007 5 => False), -- unused
10009 N_Task_Type_Declaration =>
10010 (1 => True, -- Defining_Identifier (Node1)
10011 2 => True, -- Interface_List (List2)
10012 3 => True, -- Task_Definition (Node3)
10013 4 => True, -- Discriminant_Specifications (List4)
10014 5 => False), -- Corresponding_Body (Node5-Sem)
10016 N_Single_Task_Declaration =>
10017 (1 => True, -- Defining_Identifier (Node1)
10018 2 => True, -- Interface_List (List2)
10019 3 => True, -- Task_Definition (Node3)
10020 4 => False, -- unused
10021 5 => False), -- unused
10023 N_Task_Definition =>
10024 (1 => False, -- unused
10025 2 => True, -- Visible_Declarations (List2)
10026 3 => True, -- Private_Declarations (List3)
10027 4 => True, -- End_Label (Node4)
10028 5 => False), -- unused
10031 (1 => True, -- Defining_Identifier (Node1)
10032 2 => True, -- Declarations (List2)
10033 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10034 4 => True, -- Handled_Statement_Sequence (Node4)
10035 5 => False), -- Corresponding_Spec (Node5-Sem)
10037 N_Protected_Type_Declaration =>
10038 (1 => True, -- Defining_Identifier (Node1)
10039 2 => True, -- Interface_List (List2)
10040 3 => True, -- Protected_Definition (Node3)
10041 4 => True, -- Discriminant_Specifications (List4)
10042 5 => False), -- Corresponding_Body (Node5-Sem)
10044 N_Single_Protected_Declaration =>
10045 (1 => True, -- Defining_Identifier (Node1)
10046 2 => True, -- Interface_List (List2)
10047 3 => True, -- Protected_Definition (Node3)
10048 4 => False, -- unused
10049 5 => False), -- unused
10051 N_Protected_Definition =>
10052 (1 => False, -- unused
10053 2 => True, -- Visible_Declarations (List2)
10054 3 => True, -- Private_Declarations (List3)
10055 4 => True, -- End_Label (Node4)
10056 5 => False), -- unused
10058 N_Protected_Body =>
10059 (1 => True, -- Defining_Identifier (Node1)
10060 2 => True, -- Declarations (List2)
10061 3 => False, -- unused
10062 4 => True, -- End_Label (Node4)
10063 5 => False), -- Corresponding_Spec (Node5-Sem)
10065 N_Entry_Declaration =>
10066 (1 => True, -- Defining_Identifier (Node1)
10067 2 => False, -- unused
10068 3 => True, -- Parameter_Specifications (List3)
10069 4 => True, -- Discrete_Subtype_Definition (Node4)
10070 5 => False), -- Corresponding_Body (Node5-Sem)
10072 N_Accept_Statement =>
10073 (1 => True, -- Entry_Direct_Name (Node1)
10074 2 => True, -- Declarations (List2)
10075 3 => True, -- Parameter_Specifications (List3)
10076 4 => True, -- Handled_Statement_Sequence (Node4)
10077 5 => True), -- Entry_Index (Node5)
10080 (1 => True, -- Defining_Identifier (Node1)
10081 2 => True, -- Declarations (List2)
10082 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10083 4 => True, -- Handled_Statement_Sequence (Node4)
10084 5 => True), -- Entry_Body_Formal_Part (Node5)
10086 N_Entry_Body_Formal_Part =>
10087 (1 => True, -- Condition (Node1)
10088 2 => False, -- unused
10089 3 => True, -- Parameter_Specifications (List3)
10090 4 => True, -- Entry_Index_Specification (Node4)
10091 5 => False), -- unused
10093 N_Entry_Index_Specification =>
10094 (1 => True, -- Defining_Identifier (Node1)
10095 2 => False, -- unused
10096 3 => False, -- unused
10097 4 => True, -- Discrete_Subtype_Definition (Node4)
10098 5 => False), -- unused
10100 N_Entry_Call_Statement =>
10101 (1 => False, -- unused
10102 2 => True, -- Name (Node2)
10103 3 => True, -- Parameter_Associations (List3)
10104 4 => False, -- First_Named_Actual (Node4-Sem)
10105 5 => False), -- unused
10107 N_Requeue_Statement =>
10108 (1 => False, -- unused
10109 2 => True, -- Name (Node2)
10110 3 => False, -- unused
10111 4 => False, -- unused
10112 5 => False), -- unused
10114 N_Delay_Until_Statement =>
10115 (1 => False, -- unused
10116 2 => False, -- unused
10117 3 => True, -- Expression (Node3)
10118 4 => False, -- unused
10119 5 => False), -- unused
10121 N_Delay_Relative_Statement =>
10122 (1 => False, -- unused
10123 2 => False, -- unused
10124 3 => True, -- Expression (Node3)
10125 4 => False, -- unused
10126 5 => False), -- unused
10128 N_Selective_Accept =>
10129 (1 => True, -- Select_Alternatives (List1)
10130 2 => False, -- unused
10131 3 => False, -- unused
10132 4 => True, -- Else_Statements (List4)
10133 5 => False), -- unused
10135 N_Accept_Alternative =>
10136 (1 => True, -- Condition (Node1)
10137 2 => True, -- Accept_Statement (Node2)
10138 3 => True, -- Statements (List3)
10139 4 => True, -- Pragmas_Before (List4)
10140 5 => False), -- Accept_Handler_Records (List5-Sem)
10142 N_Delay_Alternative =>
10143 (1 => True, -- Condition (Node1)
10144 2 => True, -- Delay_Statement (Node2)
10145 3 => True, -- Statements (List3)
10146 4 => True, -- Pragmas_Before (List4)
10147 5 => False), -- unused
10149 N_Terminate_Alternative =>
10150 (1 => True, -- Condition (Node1)
10151 2 => False, -- unused
10152 3 => False, -- unused
10153 4 => True, -- Pragmas_Before (List4)
10154 5 => True), -- Pragmas_After (List5)
10156 N_Timed_Entry_Call =>
10157 (1 => True, -- Entry_Call_Alternative (Node1)
10158 2 => False, -- unused
10159 3 => False, -- unused
10160 4 => True, -- Delay_Alternative (Node4)
10161 5 => False), -- unused
10163 N_Entry_Call_Alternative =>
10164 (1 => True, -- Entry_Call_Statement (Node1)
10165 2 => False, -- unused
10166 3 => True, -- Statements (List3)
10167 4 => True, -- Pragmas_Before (List4)
10168 5 => False), -- unused
10170 N_Conditional_Entry_Call =>
10171 (1 => True, -- Entry_Call_Alternative (Node1)
10172 2 => False, -- unused
10173 3 => False, -- unused
10174 4 => True, -- Else_Statements (List4)
10175 5 => False), -- unused
10177 N_Asynchronous_Select =>
10178 (1 => True, -- Triggering_Alternative (Node1)
10179 2 => True, -- Abortable_Part (Node2)
10180 3 => False, -- unused
10181 4 => False, -- unused
10182 5 => False), -- unused
10184 N_Triggering_Alternative =>
10185 (1 => True, -- Triggering_Statement (Node1)
10186 2 => False, -- unused
10187 3 => True, -- Statements (List3)
10188 4 => True, -- Pragmas_Before (List4)
10189 5 => False), -- unused
10191 N_Abortable_Part =>
10192 (1 => False, -- unused
10193 2 => False, -- unused
10194 3 => True, -- Statements (List3)
10195 4 => False, -- unused
10196 5 => False), -- unused
10198 N_Abort_Statement =>
10199 (1 => False, -- unused
10200 2 => True, -- Names (List2)
10201 3 => False, -- unused
10202 4 => False, -- unused
10203 5 => False), -- unused
10205 N_Compilation_Unit =>
10206 (1 => True, -- Context_Items (List1)
10207 2 => True, -- Unit (Node2)
10208 3 => False, -- First_Inlined_Subprogram (Node3-Sem)
10209 4 => False, -- Library_Unit (Node4-Sem)
10210 5 => True), -- Aux_Decls_Node (Node5)
10212 N_Compilation_Unit_Aux =>
10213 (1 => True, -- Actions (List1)
10214 2 => True, -- Declarations (List2)
10215 3 => False, -- unused
10216 4 => True, -- Config_Pragmas (List4)
10217 5 => True), -- Pragmas_After (List5)
10220 (1 => False, -- unused
10221 2 => True, -- Name (Node2)
10222 3 => False, -- unused
10223 4 => False, -- Library_Unit (Node4-Sem)
10224 5 => False), -- Corresponding_Spec (Node5-Sem)
10226 N_Subprogram_Body_Stub =>
10227 (1 => True, -- Specification (Node1)
10228 2 => False, -- unused
10229 3 => False, -- unused
10230 4 => False, -- Library_Unit (Node4-Sem)
10231 5 => False), -- Corresponding_Body (Node5-Sem)
10233 N_Package_Body_Stub =>
10234 (1 => True, -- Defining_Identifier (Node1)
10235 2 => False, -- unused
10236 3 => False, -- unused
10237 4 => False, -- Library_Unit (Node4-Sem)
10238 5 => False), -- Corresponding_Body (Node5-Sem)
10240 N_Task_Body_Stub =>
10241 (1 => True, -- Defining_Identifier (Node1)
10242 2 => False, -- unused
10243 3 => False, -- unused
10244 4 => False, -- Library_Unit (Node4-Sem)
10245 5 => False), -- Corresponding_Body (Node5-Sem)
10247 N_Protected_Body_Stub =>
10248 (1 => True, -- Defining_Identifier (Node1)
10249 2 => False, -- unused
10250 3 => False, -- unused
10251 4 => False, -- Library_Unit (Node4-Sem)
10252 5 => False), -- Corresponding_Body (Node5-Sem)
10255 (1 => True, -- Proper_Body (Node1)
10256 2 => True, -- Name (Node2)
10257 3 => False, -- Corresponding_Stub (Node3-Sem)
10258 4 => False, -- unused
10259 5 => False), -- unused
10261 N_Exception_Declaration =>
10262 (1 => True, -- Defining_Identifier (Node1)
10263 2 => False, -- unused
10264 3 => False, -- Expression (Node3-Sem)
10265 4 => False, -- unused
10266 5 => False), -- unused
10268 N_Handled_Sequence_Of_Statements =>
10269 (1 => True, -- At_End_Proc (Node1)
10270 2 => False, -- First_Real_Statement (Node2-Sem)
10271 3 => True, -- Statements (List3)
10272 4 => True, -- End_Label (Node4)
10273 5 => True), -- Exception_Handlers (List5)
10275 N_Exception_Handler =>
10276 (1 => False, -- Local_Raise_Statements (Elist1)
10277 2 => True, -- Choice_Parameter (Node2)
10278 3 => True, -- Statements (List3)
10279 4 => True, -- Exception_Choices (List4)
10280 5 => False), -- Exception_Label (Node5)
10282 N_Raise_Statement =>
10283 (1 => False, -- unused
10284 2 => True, -- Name (Node2)
10285 3 => True, -- Expression (Node3)
10286 4 => False, -- unused
10287 5 => False), -- unused
10289 N_Generic_Subprogram_Declaration =>
10290 (1 => True, -- Specification (Node1)
10291 2 => True, -- Generic_Formal_Declarations (List2)
10292 3 => False, -- unused
10293 4 => False, -- Parent_Spec (Node4-Sem)
10294 5 => False), -- Corresponding_Body (Node5-Sem)
10296 N_Generic_Package_Declaration =>
10297 (1 => True, -- Specification (Node1)
10298 2 => True, -- Generic_Formal_Declarations (List2)
10299 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10300 4 => False, -- Parent_Spec (Node4-Sem)
10301 5 => False), -- Corresponding_Body (Node5-Sem)
10303 N_Package_Instantiation =>
10304 (1 => True, -- Defining_Unit_Name (Node1)
10305 2 => True, -- Name (Node2)
10306 3 => True, -- Generic_Associations (List3)
10307 4 => False, -- Parent_Spec (Node4-Sem)
10308 5 => False), -- Instance_Spec (Node5-Sem)
10310 N_Procedure_Instantiation =>
10311 (1 => True, -- Defining_Unit_Name (Node1)
10312 2 => True, -- Name (Node2)
10313 3 => True, -- Generic_Associations (List3)
10314 4 => False, -- Parent_Spec (Node4-Sem)
10315 5 => False), -- Instance_Spec (Node5-Sem)
10317 N_Function_Instantiation =>
10318 (1 => True, -- Defining_Unit_Name (Node1)
10319 2 => True, -- Name (Node2)
10320 3 => True, -- Generic_Associations (List3)
10321 4 => False, -- Parent_Spec (Node4-Sem)
10322 5 => False), -- Instance_Spec (Node5-Sem)
10324 N_Generic_Association =>
10325 (1 => True, -- Explicit_Generic_Actual_Parameter (Node1)
10326 2 => True, -- Selector_Name (Node2)
10327 3 => False, -- unused
10328 4 => False, -- unused
10329 5 => False), -- unused
10331 N_Formal_Object_Declaration =>
10332 (1 => True, -- Defining_Identifier (Node1)
10333 2 => False, -- unused
10334 3 => True, -- Access_Definition (Node3)
10335 4 => True, -- Subtype_Mark (Node4)
10336 5 => True), -- Default_Expression (Node5)
10338 N_Formal_Type_Declaration =>
10339 (1 => True, -- Defining_Identifier (Node1)
10340 2 => False, -- unused
10341 3 => True, -- Formal_Type_Definition (Node3)
10342 4 => True, -- Discriminant_Specifications (List4)
10343 5 => False), -- unused
10345 N_Formal_Private_Type_Definition =>
10346 (1 => False, -- unused
10347 2 => False, -- unused
10348 3 => False, -- unused
10349 4 => False, -- unused
10350 5 => False), -- unused
10352 N_Formal_Derived_Type_Definition =>
10353 (1 => False, -- unused
10354 2 => True, -- Interface_List (List2)
10355 3 => False, -- unused
10356 4 => True, -- Subtype_Mark (Node4)
10357 5 => False), -- unused
10359 N_Formal_Discrete_Type_Definition =>
10360 (1 => False, -- unused
10361 2 => False, -- unused
10362 3 => False, -- unused
10363 4 => False, -- unused
10364 5 => False), -- unused
10366 N_Formal_Signed_Integer_Type_Definition =>
10367 (1 => False, -- unused
10368 2 => False, -- unused
10369 3 => False, -- unused
10370 4 => False, -- unused
10371 5 => False), -- unused
10373 N_Formal_Modular_Type_Definition =>
10374 (1 => False, -- unused
10375 2 => False, -- unused
10376 3 => False, -- unused
10377 4 => False, -- unused
10378 5 => False), -- unused
10380 N_Formal_Floating_Point_Definition =>
10381 (1 => False, -- unused
10382 2 => False, -- unused
10383 3 => False, -- unused
10384 4 => False, -- unused
10385 5 => False), -- unused
10387 N_Formal_Ordinary_Fixed_Point_Definition =>
10388 (1 => False, -- unused
10389 2 => False, -- unused
10390 3 => False, -- unused
10391 4 => False, -- unused
10392 5 => False), -- unused
10394 N_Formal_Decimal_Fixed_Point_Definition =>
10395 (1 => False, -- unused
10396 2 => False, -- unused
10397 3 => False, -- unused
10398 4 => False, -- unused
10399 5 => False), -- unused
10401 N_Formal_Concrete_Subprogram_Declaration =>
10402 (1 => True, -- Specification (Node1)
10403 2 => True, -- Default_Name (Node2)
10404 3 => False, -- unused
10405 4 => False, -- unused
10406 5 => False), -- unused
10408 N_Formal_Abstract_Subprogram_Declaration =>
10409 (1 => True, -- Specification (Node1)
10410 2 => True, -- Default_Name (Node2)
10411 3 => False, -- unused
10412 4 => False, -- unused
10413 5 => False), -- unused
10415 N_Formal_Package_Declaration =>
10416 (1 => True, -- Defining_Identifier (Node1)
10417 2 => True, -- Name (Node2)
10418 3 => True, -- Generic_Associations (List3)
10419 4 => False, -- unused
10420 5 => False), -- Instance_Spec (Node5-Sem)
10422 N_Attribute_Definition_Clause =>
10423 (1 => True, -- Chars (Name1)
10424 2 => True, -- Name (Node2)
10425 3 => True, -- Expression (Node3)
10426 4 => False, -- unused
10427 5 => False), -- Next_Rep_Item (Node5-Sem)
10429 N_Enumeration_Representation_Clause =>
10430 (1 => True, -- Identifier (Node1)
10431 2 => False, -- unused
10432 3 => True, -- Array_Aggregate (Node3)
10433 4 => False, -- unused
10434 5 => False), -- Next_Rep_Item (Node5-Sem)
10436 N_Record_Representation_Clause =>
10437 (1 => True, -- Identifier (Node1)
10438 2 => True, -- Mod_Clause (Node2)
10439 3 => True, -- Component_Clauses (List3)
10440 4 => False, -- unused
10441 5 => False), -- Next_Rep_Item (Node5-Sem)
10443 N_Component_Clause =>
10444 (1 => True, -- Component_Name (Node1)
10445 2 => True, -- Position (Node2)
10446 3 => True, -- First_Bit (Node3)
10447 4 => True, -- Last_Bit (Node4)
10448 5 => False), -- unused
10450 N_Code_Statement =>
10451 (1 => False, -- unused
10452 2 => False, -- unused
10453 3 => True, -- Expression (Node3)
10454 4 => False, -- unused
10455 5 => False), -- unused
10457 N_Op_Rotate_Left =>
10458 (1 => True, -- Chars (Name1)
10459 2 => True, -- Left_Opnd (Node2)
10460 3 => True, -- Right_Opnd (Node3)
10461 4 => False, -- Entity (Node4-Sem)
10462 5 => False), -- Etype (Node5-Sem)
10464 N_Op_Rotate_Right =>
10465 (1 => True, -- Chars (Name1)
10466 2 => True, -- Left_Opnd (Node2)
10467 3 => True, -- Right_Opnd (Node3)
10468 4 => False, -- Entity (Node4-Sem)
10469 5 => False), -- Etype (Node5-Sem)
10472 (1 => True, -- Chars (Name1)
10473 2 => True, -- Left_Opnd (Node2)
10474 3 => True, -- Right_Opnd (Node3)
10475 4 => False, -- Entity (Node4-Sem)
10476 5 => False), -- Etype (Node5-Sem)
10478 N_Op_Shift_Right_Arithmetic =>
10479 (1 => True, -- Chars (Name1)
10480 2 => True, -- Left_Opnd (Node2)
10481 3 => True, -- Right_Opnd (Node3)
10482 4 => False, -- Entity (Node4-Sem)
10483 5 => False), -- Etype (Node5-Sem)
10485 N_Op_Shift_Right =>
10486 (1 => True, -- Chars (Name1)
10487 2 => True, -- Left_Opnd (Node2)
10488 3 => True, -- Right_Opnd (Node3)
10489 4 => False, -- Entity (Node4-Sem)
10490 5 => False), -- Etype (Node5-Sem)
10492 N_Delta_Constraint =>
10493 (1 => False, -- unused
10494 2 => False, -- unused
10495 3 => True, -- Delta_Expression (Node3)
10496 4 => True, -- Range_Constraint (Node4)
10497 5 => False), -- unused
10500 (1 => True, -- Identifier (Node1)
10501 2 => False, -- unused
10502 3 => True, -- Expression (Node3)
10503 4 => False, -- unused
10504 5 => False), -- unused
10507 (1 => False, -- unused
10508 2 => False, -- unused
10509 3 => True, -- Expression (Node3)
10510 4 => True, -- Pragmas_Before (List4)
10511 5 => False), -- unused
10513 N_Conditional_Expression =>
10514 (1 => True, -- Expressions (List1)
10515 2 => False, -- Then_Actions (List2-Sem)
10516 3 => False, -- Else_Actions (List3-Sem)
10517 4 => False, -- unused
10518 5 => False), -- Etype (Node5-Sem)
10521 (1 => True, -- Chars (Name1)
10522 2 => True, -- Selector_Name (Node2)
10523 3 => True, -- Prefix (Node3)
10524 4 => False, -- Entity (Node4-Sem)
10525 5 => False), -- Etype (Node5-Sem)
10527 N_Free_Statement =>
10528 (1 => False, -- Storage_Pool (Node1-Sem)
10529 2 => False, -- Procedure_To_Call (Node2-Sem)
10530 3 => True, -- Expression (Node3)
10531 4 => False, -- Actual_Designated_Subtype (Node4-Sem)
10532 5 => False), -- unused
10535 (1 => True, -- Actions (List1)
10536 2 => False, -- Access_Types_To_Process (Elist2-Sem)
10537 3 => False, -- TSS_Elist (Elist3-Sem)
10538 4 => False, -- Entity (Node4-Sem)
10539 5 => False), -- First_Subtype_Link (Node5-Sem)
10541 N_Implicit_Label_Declaration =>
10542 (1 => True, -- Defining_Identifier (Node1)
10543 2 => False, -- Label_Construct (Node2-Sem)
10544 3 => False, -- unused
10545 4 => False, -- unused
10546 5 => False), -- unused
10548 N_Itype_Reference =>
10549 (1 => False, -- Itype (Node1-Sem)
10550 2 => False, -- unused
10551 3 => False, -- unused
10552 4 => False, -- unused
10553 5 => False), -- unused
10555 N_Raise_Constraint_Error =>
10556 (1 => True, -- Condition (Node1)
10557 2 => False, -- unused
10558 3 => True, -- Reason (Uint3)
10559 4 => False, -- unused
10560 5 => False), -- Etype (Node5-Sem)
10562 N_Raise_Program_Error =>
10563 (1 => True, -- Condition (Node1)
10564 2 => False, -- unused
10565 3 => True, -- Reason (Uint3)
10566 4 => False, -- unused
10567 5 => False), -- Etype (Node5-Sem)
10569 N_Raise_Storage_Error =>
10570 (1 => True, -- Condition (Node1)
10571 2 => False, -- unused
10572 3 => True, -- Reason (Uint3)
10573 4 => False, -- unused
10574 5 => False), -- Etype (Node5-Sem)
10576 N_Push_Constraint_Error_Label =>
10577 (1 => False, -- unused
10578 2 => False, -- unused
10579 3 => False, -- unused
10580 4 => False, -- unused
10581 5 => False), -- unused
10583 N_Push_Program_Error_Label =>
10584 (1 => False, -- Exception_Label
10585 2 => False, -- unused
10586 3 => False, -- unused
10587 4 => False, -- unused
10588 5 => False), -- Exception_Label
10590 N_Push_Storage_Error_Label =>
10591 (1 => False, -- Exception_Label
10592 2 => False, -- unused
10593 3 => False, -- unused
10594 4 => False, -- unused
10595 5 => False), -- Exception_Label
10597 N_Pop_Constraint_Error_Label =>
10598 (1 => False, -- unused
10599 2 => False, -- unused
10600 3 => False, -- unused
10601 4 => False, -- unused
10602 5 => False), -- unused
10604 N_Pop_Program_Error_Label =>
10605 (1 => False, -- unused
10606 2 => False, -- unused
10607 3 => False, -- unused
10608 4 => False, -- unused
10609 5 => False), -- unused
10611 N_Pop_Storage_Error_Label =>
10612 (1 => False, -- unused
10613 2 => False, -- unused
10614 3 => False, -- unused
10615 4 => False, -- unused
10616 5 => False), -- unused
10619 (1 => False, -- unused
10620 2 => False, -- unused
10621 3 => True, -- Prefix (Node3)
10622 4 => False, -- unused
10623 5 => False), -- Etype (Node5-Sem)
10625 N_Subprogram_Info =>
10626 (1 => True, -- Identifier (Node1)
10627 2 => False, -- unused
10628 3 => False, -- unused
10629 4 => False, -- unused
10630 5 => False), -- Etype (Node5-Sem)
10632 N_Unchecked_Expression =>
10633 (1 => False, -- unused
10634 2 => False, -- unused
10635 3 => True, -- Expression (Node3)
10636 4 => False, -- unused
10637 5 => False), -- Etype (Node5-Sem)
10639 N_Unchecked_Type_Conversion =>
10640 (1 => False, -- unused
10641 2 => False, -- unused
10642 3 => True, -- Expression (Node3)
10643 4 => True, -- Subtype_Mark (Node4)
10644 5 => False), -- Etype (Node5-Sem)
10646 N_Validate_Unchecked_Conversion =>
10647 (1 => False, -- Source_Type (Node1-Sem)
10648 2 => False, -- Target_Type (Node2-Sem)
10649 3 => False, -- unused
10650 4 => False, -- unused
10651 5 => False), -- unused
10653 -- End of inserted output from makeisf program
10655 -- Entries for Empty, Error and Unused. Even thought these have a Chars
10656 -- field for debugging purposes, they are not really syntactic fields, so
10657 -- we mark all fields as unused.
10660 (1 => False, -- unused
10661 2 => False, -- unused
10662 3 => False, -- unused
10663 4 => False, -- unused
10664 5 => False), -- unused
10667 (1 => False, -- unused
10668 2 => False, -- unused
10669 3 => False, -- unused
10670 4 => False, -- unused
10671 5 => False), -- unused
10673 N_Unused_At_Start =>
10674 (1 => False, -- unused
10675 2 => False, -- unused
10676 3 => False, -- unused
10677 4 => False, -- unused
10678 5 => False), -- unused
10681 (1 => False, -- unused
10682 2 => False, -- unused
10683 3 => False, -- unused
10684 4 => False, -- unused
10685 5 => False)); -- unused
10687 --------------------
10688 -- Inline Pragmas --
10689 --------------------
10691 pragma Inline (ABE_Is_Certain);
10692 pragma Inline (Abort_Present);
10693 pragma Inline (Abortable_Part);
10694 pragma Inline (Abstract_Present);
10695 pragma Inline (Accept_Handler_Records);
10696 pragma Inline (Accept_Statement);
10697 pragma Inline (Access_Definition);
10698 pragma Inline (Access_To_Subprogram_Definition);
10699 pragma Inline (Access_Types_To_Process);
10700 pragma Inline (Actions);
10701 pragma Inline (Activation_Chain_Entity);
10702 pragma Inline (Acts_As_Spec);
10703 pragma Inline (Actual_Designated_Subtype);
10704 pragma Inline (Address_Warning_Posted);
10705 pragma Inline (Aggregate_Bounds);
10706 pragma Inline (Aliased_Present);
10707 pragma Inline (All_Others);
10708 pragma Inline (All_Present);
10709 pragma Inline (Alternatives);
10710 pragma Inline (Ancestor_Part);
10711 pragma Inline (Array_Aggregate);
10712 pragma Inline (Assignment_OK);
10713 pragma Inline (Associated_Node);
10714 pragma Inline (At_End_Proc);
10715 pragma Inline (Attribute_Name);
10716 pragma Inline (Aux_Decls_Node);
10717 pragma Inline (Backwards_OK);
10718 pragma Inline (Bad_Is_Detected);
10719 pragma Inline (Body_To_Inline);
10720 pragma Inline (Body_Required);
10721 pragma Inline (By_Ref);
10722 pragma Inline (Box_Present);
10723 pragma Inline (Char_Literal_Value);
10724 pragma Inline (Chars);
10725 pragma Inline (Check_Address_Alignment);
10726 pragma Inline (Choice_Parameter);
10727 pragma Inline (Choices);
10728 pragma Inline (Coextensions);
10729 pragma Inline (Comes_From_Extended_Return_Statement);
10730 pragma Inline (Compile_Time_Known_Aggregate);
10731 pragma Inline (Component_Associations);
10732 pragma Inline (Component_Clauses);
10733 pragma Inline (Component_Definition);
10734 pragma Inline (Component_Items);
10735 pragma Inline (Component_List);
10736 pragma Inline (Component_Name);
10737 pragma Inline (Condition);
10738 pragma Inline (Condition_Actions);
10739 pragma Inline (Config_Pragmas);
10740 pragma Inline (Constant_Present);
10741 pragma Inline (Constraint);
10742 pragma Inline (Constraints);
10743 pragma Inline (Context_Installed);
10744 pragma Inline (Context_Items);
10745 pragma Inline (Controlling_Argument);
10746 pragma Inline (Conversion_OK);
10747 pragma Inline (Corresponding_Body);
10748 pragma Inline (Corresponding_Formal_Spec);
10749 pragma Inline (Corresponding_Generic_Association);
10750 pragma Inline (Corresponding_Integer_Value);
10751 pragma Inline (Corresponding_Spec);
10752 pragma Inline (Corresponding_Stub);
10753 pragma Inline (Dcheck_Function);
10754 pragma Inline (Debug_Statement);
10755 pragma Inline (Declarations);
10756 pragma Inline (Default_Expression);
10757 pragma Inline (Default_Name);
10758 pragma Inline (Defining_Identifier);
10759 pragma Inline (Defining_Unit_Name);
10760 pragma Inline (Delay_Alternative);
10761 pragma Inline (Delay_Statement);
10762 pragma Inline (Delta_Expression);
10763 pragma Inline (Digits_Expression);
10764 pragma Inline (Discr_Check_Funcs_Built);
10765 pragma Inline (Discrete_Choices);
10766 pragma Inline (Discrete_Range);
10767 pragma Inline (Discrete_Subtype_Definition);
10768 pragma Inline (Discrete_Subtype_Definitions);
10769 pragma Inline (Discriminant_Specifications);
10770 pragma Inline (Discriminant_Type);
10771 pragma Inline (Do_Accessibility_Check);
10772 pragma Inline (Do_Discriminant_Check);
10773 pragma Inline (Do_Length_Check);
10774 pragma Inline (Do_Division_Check);
10775 pragma Inline (Do_Overflow_Check);
10776 pragma Inline (Do_Range_Check);
10777 pragma Inline (Do_Storage_Check);
10778 pragma Inline (Do_Tag_Check);
10779 pragma Inline (Elaborate_Present);
10780 pragma Inline (Elaborate_All_Desirable);
10781 pragma Inline (Elaborate_All_Present);
10782 pragma Inline (Elaborate_Desirable);
10783 pragma Inline (Elaboration_Boolean);
10784 pragma Inline (Else_Actions);
10785 pragma Inline (Else_Statements);
10786 pragma Inline (Elsif_Parts);
10787 pragma Inline (Enclosing_Variant);
10788 pragma Inline (End_Label);
10789 pragma Inline (End_Span);
10790 pragma Inline (Entity);
10791 pragma Inline (Entity_Or_Associated_Node);
10792 pragma Inline (Entry_Body_Formal_Part);
10793 pragma Inline (Entry_Call_Alternative);
10794 pragma Inline (Entry_Call_Statement);
10795 pragma Inline (Entry_Direct_Name);
10796 pragma Inline (Entry_Index);
10797 pragma Inline (Entry_Index_Specification);
10798 pragma Inline (Etype);
10799 pragma Inline (Exception_Choices);
10800 pragma Inline (Exception_Handlers);
10801 pragma Inline (Exception_Junk);
10802 pragma Inline (Exception_Label);
10803 pragma Inline (Expansion_Delayed);
10804 pragma Inline (Explicit_Actual_Parameter);
10805 pragma Inline (Explicit_Generic_Actual_Parameter);
10806 pragma Inline (Expression);
10807 pragma Inline (Expressions);
10808 pragma Inline (First_Bit);
10809 pragma Inline (First_Inlined_Subprogram);
10810 pragma Inline (First_Name);
10811 pragma Inline (First_Named_Actual);
10812 pragma Inline (First_Real_Statement);
10813 pragma Inline (First_Subtype_Link);
10814 pragma Inline (Float_Truncate);
10815 pragma Inline (Formal_Type_Definition);
10816 pragma Inline (Forwards_OK);
10817 pragma Inline (From_At_Mod);
10818 pragma Inline (From_Default);
10819 pragma Inline (Generic_Associations);
10820 pragma Inline (Generic_Formal_Declarations);
10821 pragma Inline (Generic_Parent);
10822 pragma Inline (Generic_Parent_Type);
10823 pragma Inline (Handled_Statement_Sequence);
10824 pragma Inline (Handler_List_Entry);
10825 pragma Inline (Has_Created_Identifier);
10826 pragma Inline (Has_Dynamic_Length_Check);
10827 pragma Inline (Has_Dynamic_Range_Check);
10828 pragma Inline (Has_Init_Expression);
10829 pragma Inline (Has_Local_Raise);
10830 pragma Inline (Has_Self_Reference);
10831 pragma Inline (Has_No_Elaboration_Code);
10832 pragma Inline (Has_Priority_Pragma);
10833 pragma Inline (Has_Private_View);
10834 pragma Inline (Has_Storage_Size_Pragma);
10835 pragma Inline (Has_Task_Info_Pragma);
10836 pragma Inline (Has_Task_Name_Pragma);
10837 pragma Inline (Has_Wide_Character);
10838 pragma Inline (Hidden_By_Use_Clause);
10839 pragma Inline (High_Bound);
10840 pragma Inline (Identifier);
10841 pragma Inline (Implicit_With);
10842 pragma Inline (Interface_List);
10843 pragma Inline (Interface_Present);
10844 pragma Inline (Includes_Infinities);
10845 pragma Inline (In_Present);
10846 pragma Inline (Instance_Spec);
10847 pragma Inline (Intval);
10848 pragma Inline (Is_Asynchronous_Call_Block);
10849 pragma Inline (Is_Component_Left_Opnd);
10850 pragma Inline (Is_Component_Right_Opnd);
10851 pragma Inline (Is_Controlling_Actual);
10852 pragma Inline (Is_Dynamic_Coextension);
10853 pragma Inline (Is_Entry_Barrier_Function);
10854 pragma Inline (Is_Expanded_Build_In_Place_Call);
10855 pragma Inline (Is_Folded_In_Parser);
10856 pragma Inline (Is_In_Discriminant_Check);
10857 pragma Inline (Is_Machine_Number);
10858 pragma Inline (Is_Null_Loop);
10859 pragma Inline (Is_Overloaded);
10860 pragma Inline (Is_Power_Of_2_For_Shift);
10861 pragma Inline (Is_Protected_Subprogram_Body);
10862 pragma Inline (Is_Static_Coextension);
10863 pragma Inline (Is_Static_Expression);
10864 pragma Inline (Is_Subprogram_Descriptor);
10865 pragma Inline (Is_Task_Allocation_Block);
10866 pragma Inline (Is_Task_Master);
10867 pragma Inline (Iteration_Scheme);
10868 pragma Inline (Itype);
10869 pragma Inline (Kill_Range_Check);
10870 pragma Inline (Last_Bit);
10871 pragma Inline (Last_Name);
10872 pragma Inline (Library_Unit);
10873 pragma Inline (Label_Construct);
10874 pragma Inline (Left_Opnd);
10875 pragma Inline (Limited_View_Installed);
10876 pragma Inline (Limited_Present);
10877 pragma Inline (Literals);
10878 pragma Inline (Local_Raise_Not_OK);
10879 pragma Inline (Local_Raise_Statements);
10880 pragma Inline (Loop_Actions);
10881 pragma Inline (Loop_Parameter_Specification);
10882 pragma Inline (Low_Bound);
10883 pragma Inline (Mod_Clause);
10884 pragma Inline (More_Ids);
10885 pragma Inline (Must_Be_Byte_Aligned);
10886 pragma Inline (Must_Not_Freeze);
10887 pragma Inline (Must_Not_Override);
10888 pragma Inline (Must_Override);
10889 pragma Inline (Name);
10890 pragma Inline (Names);
10891 pragma Inline (Next_Entity);
10892 pragma Inline (Next_Named_Actual);
10893 pragma Inline (Next_Rep_Item);
10894 pragma Inline (Next_Use_Clause);
10895 pragma Inline (No_Ctrl_Actions);
10896 pragma Inline (No_Elaboration_Check);
10897 pragma Inline (No_Entities_Ref_In_Spec);
10898 pragma Inline (No_Initialization);
10899 pragma Inline (No_Truncation);
10900 pragma Inline (Null_Present);
10901 pragma Inline (Null_Exclusion_Present);
10902 pragma Inline (Null_Record_Present);
10903 pragma Inline (Object_Definition);
10904 pragma Inline (Original_Discriminant);
10905 pragma Inline (Original_Entity);
10906 pragma Inline (Others_Discrete_Choices);
10907 pragma Inline (Out_Present);
10908 pragma Inline (Parameter_Associations);
10909 pragma Inline (Parameter_Specifications);
10910 pragma Inline (Parameter_List_Truncated);
10911 pragma Inline (Parameter_Type);
10912 pragma Inline (Parent_Spec);
10913 pragma Inline (Position);
10914 pragma Inline (Pragma_Argument_Associations);
10915 pragma Inline (Pragmas_After);
10916 pragma Inline (Pragmas_Before);
10917 pragma Inline (Prefix);
10918 pragma Inline (Present_Expr);
10919 pragma Inline (Prev_Ids);
10920 pragma Inline (Print_In_Hex);
10921 pragma Inline (Private_Declarations);
10922 pragma Inline (Private_Present);
10923 pragma Inline (Procedure_To_Call);
10924 pragma Inline (Proper_Body);
10925 pragma Inline (Protected_Definition);
10926 pragma Inline (Protected_Present);
10927 pragma Inline (Raises_Constraint_Error);
10928 pragma Inline (Range_Constraint);
10929 pragma Inline (Range_Expression);
10930 pragma Inline (Real_Range_Specification);
10931 pragma Inline (Realval);
10932 pragma Inline (Reason);
10933 pragma Inline (Record_Extension_Part);
10934 pragma Inline (Redundant_Use);
10935 pragma Inline (Renaming_Exception);
10936 pragma Inline (Result_Definition);
10937 pragma Inline (Return_Object_Declarations);
10938 pragma Inline (Return_Statement_Entity);
10939 pragma Inline (Reverse_Present);
10940 pragma Inline (Right_Opnd);
10941 pragma Inline (Rounded_Result);
10942 pragma Inline (Scope);
10943 pragma Inline (Select_Alternatives);
10944 pragma Inline (Selector_Name);
10945 pragma Inline (Selector_Names);
10946 pragma Inline (Shift_Count_OK);
10947 pragma Inline (Source_Type);
10948 pragma Inline (Specification);
10949 pragma Inline (Statements);
10950 pragma Inline (Static_Processing_OK);
10951 pragma Inline (Storage_Pool);
10952 pragma Inline (Strval);
10953 pragma Inline (Subtype_Indication);
10954 pragma Inline (Subtype_Mark);
10955 pragma Inline (Subtype_Marks);
10956 pragma Inline (Synchronized_Present);
10957 pragma Inline (Tagged_Present);
10958 pragma Inline (Target_Type);
10959 pragma Inline (Task_Definition);
10960 pragma Inline (Task_Present);
10961 pragma Inline (Then_Actions);
10962 pragma Inline (Then_Statements);
10963 pragma Inline (Triggering_Alternative);
10964 pragma Inline (Triggering_Statement);
10965 pragma Inline (Treat_Fixed_As_Integer);
10966 pragma Inline (TSS_Elist);
10967 pragma Inline (Type_Definition);
10968 pragma Inline (Unit);
10969 pragma Inline (Unknown_Discriminants_Present);
10970 pragma Inline (Unreferenced_In_Spec);
10971 pragma Inline (Variant_Part);
10972 pragma Inline (Variants);
10973 pragma Inline (Visible_Declarations);
10974 pragma Inline (Was_Originally_Stub);
10975 pragma Inline (Zero_Cost_Handling);
10977 pragma Inline (Set_ABE_Is_Certain);
10978 pragma Inline (Set_Abort_Present);
10979 pragma Inline (Set_Abortable_Part);
10980 pragma Inline (Set_Abstract_Present);
10981 pragma Inline (Set_Accept_Handler_Records);
10982 pragma Inline (Set_Accept_Statement);
10983 pragma Inline (Set_Access_Definition);
10984 pragma Inline (Set_Access_To_Subprogram_Definition);
10985 pragma Inline (Set_Access_Types_To_Process);
10986 pragma Inline (Set_Actions);
10987 pragma Inline (Set_Activation_Chain_Entity);
10988 pragma Inline (Set_Acts_As_Spec);
10989 pragma Inline (Set_Actual_Designated_Subtype);
10990 pragma Inline (Set_Address_Warning_Posted);
10991 pragma Inline (Set_Aggregate_Bounds);
10992 pragma Inline (Set_Aliased_Present);
10993 pragma Inline (Set_All_Others);
10994 pragma Inline (Set_All_Present);
10995 pragma Inline (Set_Alternatives);
10996 pragma Inline (Set_Ancestor_Part);
10997 pragma Inline (Set_Array_Aggregate);
10998 pragma Inline (Set_Assignment_OK);
10999 pragma Inline (Set_Associated_Node);
11000 pragma Inline (Set_At_End_Proc);
11001 pragma Inline (Set_Attribute_Name);
11002 pragma Inline (Set_Aux_Decls_Node);
11003 pragma Inline (Set_Backwards_OK);
11004 pragma Inline (Set_Bad_Is_Detected);
11005 pragma Inline (Set_Body_To_Inline);
11006 pragma Inline (Set_Body_Required);
11007 pragma Inline (Set_By_Ref);
11008 pragma Inline (Set_Box_Present);
11009 pragma Inline (Set_Char_Literal_Value);
11010 pragma Inline (Set_Chars);
11011 pragma Inline (Set_Check_Address_Alignment);
11012 pragma Inline (Set_Choice_Parameter);
11013 pragma Inline (Set_Choices);
11014 pragma Inline (Set_Coextensions);
11015 pragma Inline (Set_Comes_From_Extended_Return_Statement);
11016 pragma Inline (Set_Compile_Time_Known_Aggregate);
11017 pragma Inline (Set_Component_Associations);
11018 pragma Inline (Set_Component_Clauses);
11019 pragma Inline (Set_Component_Definition);
11020 pragma Inline (Set_Component_Items);
11021 pragma Inline (Set_Component_List);
11022 pragma Inline (Set_Component_Name);
11023 pragma Inline (Set_Condition);
11024 pragma Inline (Set_Condition_Actions);
11025 pragma Inline (Set_Config_Pragmas);
11026 pragma Inline (Set_Constant_Present);
11027 pragma Inline (Set_Constraint);
11028 pragma Inline (Set_Constraints);
11029 pragma Inline (Set_Context_Installed);
11030 pragma Inline (Set_Context_Items);
11031 pragma Inline (Set_Controlling_Argument);
11032 pragma Inline (Set_Conversion_OK);
11033 pragma Inline (Set_Corresponding_Body);
11034 pragma Inline (Set_Corresponding_Formal_Spec);
11035 pragma Inline (Set_Corresponding_Generic_Association);
11036 pragma Inline (Set_Corresponding_Integer_Value);
11037 pragma Inline (Set_Corresponding_Spec);
11038 pragma Inline (Set_Corresponding_Stub);
11039 pragma Inline (Set_Dcheck_Function);
11040 pragma Inline (Set_Debug_Statement);
11041 pragma Inline (Set_Declarations);
11042 pragma Inline (Set_Default_Expression);
11043 pragma Inline (Set_Default_Name);
11044 pragma Inline (Set_Defining_Identifier);
11045 pragma Inline (Set_Defining_Unit_Name);
11046 pragma Inline (Set_Delay_Alternative);
11047 pragma Inline (Set_Delay_Statement);
11048 pragma Inline (Set_Delta_Expression);
11049 pragma Inline (Set_Digits_Expression);
11050 pragma Inline (Set_Discr_Check_Funcs_Built);
11051 pragma Inline (Set_Discrete_Choices);
11052 pragma Inline (Set_Discrete_Range);
11053 pragma Inline (Set_Discrete_Subtype_Definition);
11054 pragma Inline (Set_Discrete_Subtype_Definitions);
11055 pragma Inline (Set_Discriminant_Specifications);
11056 pragma Inline (Set_Discriminant_Type);
11057 pragma Inline (Set_Do_Accessibility_Check);
11058 pragma Inline (Set_Do_Discriminant_Check);
11059 pragma Inline (Set_Do_Length_Check);
11060 pragma Inline (Set_Do_Division_Check);
11061 pragma Inline (Set_Do_Overflow_Check);
11062 pragma Inline (Set_Do_Range_Check);
11063 pragma Inline (Set_Do_Storage_Check);
11064 pragma Inline (Set_Do_Tag_Check);
11065 pragma Inline (Set_Elaborate_Present);
11066 pragma Inline (Set_Elaborate_All_Desirable);
11067 pragma Inline (Set_Elaborate_All_Present);
11068 pragma Inline (Set_Elaborate_Desirable);
11069 pragma Inline (Set_Elaboration_Boolean);
11070 pragma Inline (Set_Else_Actions);
11071 pragma Inline (Set_Else_Statements);
11072 pragma Inline (Set_Elsif_Parts);
11073 pragma Inline (Set_Enclosing_Variant);
11074 pragma Inline (Set_End_Label);
11075 pragma Inline (Set_End_Span);
11076 pragma Inline (Set_Entity);
11077 pragma Inline (Set_Entry_Body_Formal_Part);
11078 pragma Inline (Set_Entry_Call_Alternative);
11079 pragma Inline (Set_Entry_Call_Statement);
11080 pragma Inline (Set_Entry_Direct_Name);
11081 pragma Inline (Set_Entry_Index);
11082 pragma Inline (Set_Entry_Index_Specification);
11083 pragma Inline (Set_Etype);
11084 pragma Inline (Set_Exception_Choices);
11085 pragma Inline (Set_Exception_Handlers);
11086 pragma Inline (Set_Exception_Junk);
11087 pragma Inline (Set_Exception_Label);
11088 pragma Inline (Set_Expansion_Delayed);
11089 pragma Inline (Set_Explicit_Actual_Parameter);
11090 pragma Inline (Set_Explicit_Generic_Actual_Parameter);
11091 pragma Inline (Set_Expression);
11092 pragma Inline (Set_Expressions);
11093 pragma Inline (Set_First_Bit);
11094 pragma Inline (Set_First_Inlined_Subprogram);
11095 pragma Inline (Set_First_Name);
11096 pragma Inline (Set_First_Named_Actual);
11097 pragma Inline (Set_First_Real_Statement);
11098 pragma Inline (Set_First_Subtype_Link);
11099 pragma Inline (Set_Float_Truncate);
11100 pragma Inline (Set_Formal_Type_Definition);
11101 pragma Inline (Set_Forwards_OK);
11102 pragma Inline (Set_From_At_Mod);
11103 pragma Inline (Set_From_Default);
11104 pragma Inline (Set_Generic_Associations);
11105 pragma Inline (Set_Generic_Formal_Declarations);
11106 pragma Inline (Set_Generic_Parent);
11107 pragma Inline (Set_Generic_Parent_Type);
11108 pragma Inline (Set_Handled_Statement_Sequence);
11109 pragma Inline (Set_Handler_List_Entry);
11110 pragma Inline (Set_Has_Created_Identifier);
11111 pragma Inline (Set_Has_Dynamic_Length_Check);
11112 pragma Inline (Set_Has_Init_Expression);
11113 pragma Inline (Set_Has_Local_Raise);
11114 pragma Inline (Set_Has_Dynamic_Range_Check);
11115 pragma Inline (Set_Has_No_Elaboration_Code);
11116 pragma Inline (Set_Has_Priority_Pragma);
11117 pragma Inline (Set_Has_Private_View);
11118 pragma Inline (Set_Has_Storage_Size_Pragma);
11119 pragma Inline (Set_Has_Task_Info_Pragma);
11120 pragma Inline (Set_Has_Task_Name_Pragma);
11121 pragma Inline (Set_Has_Wide_Character);
11122 pragma Inline (Set_Hidden_By_Use_Clause);
11123 pragma Inline (Set_High_Bound);
11124 pragma Inline (Set_Identifier);
11125 pragma Inline (Set_Implicit_With);
11126 pragma Inline (Set_Includes_Infinities);
11127 pragma Inline (Set_Interface_List);
11128 pragma Inline (Set_Interface_Present);
11129 pragma Inline (Set_In_Present);
11130 pragma Inline (Set_Instance_Spec);
11131 pragma Inline (Set_Intval);
11132 pragma Inline (Set_Is_Asynchronous_Call_Block);
11133 pragma Inline (Set_Is_Component_Left_Opnd);
11134 pragma Inline (Set_Is_Component_Right_Opnd);
11135 pragma Inline (Set_Is_Controlling_Actual);
11136 pragma Inline (Set_Is_Dynamic_Coextension);
11137 pragma Inline (Set_Is_Entry_Barrier_Function);
11138 pragma Inline (Set_Is_Expanded_Build_In_Place_Call);
11139 pragma Inline (Set_Is_Folded_In_Parser);
11140 pragma Inline (Set_Is_In_Discriminant_Check);
11141 pragma Inline (Set_Is_Machine_Number);
11142 pragma Inline (Set_Is_Null_Loop);
11143 pragma Inline (Set_Is_Overloaded);
11144 pragma Inline (Set_Is_Power_Of_2_For_Shift);
11145 pragma Inline (Set_Is_Protected_Subprogram_Body);
11146 pragma Inline (Set_Has_Self_Reference);
11147 pragma Inline (Set_Is_Static_Coextension);
11148 pragma Inline (Set_Is_Static_Expression);
11149 pragma Inline (Set_Is_Subprogram_Descriptor);
11150 pragma Inline (Set_Is_Task_Allocation_Block);
11151 pragma Inline (Set_Is_Task_Master);
11152 pragma Inline (Set_Iteration_Scheme);
11153 pragma Inline (Set_Itype);
11154 pragma Inline (Set_Kill_Range_Check);
11155 pragma Inline (Set_Last_Bit);
11156 pragma Inline (Set_Last_Name);
11157 pragma Inline (Set_Library_Unit);
11158 pragma Inline (Set_Label_Construct);
11159 pragma Inline (Set_Left_Opnd);
11160 pragma Inline (Set_Limited_View_Installed);
11161 pragma Inline (Set_Limited_Present);
11162 pragma Inline (Set_Literals);
11163 pragma Inline (Set_Local_Raise_Not_OK);
11164 pragma Inline (Set_Local_Raise_Statements);
11165 pragma Inline (Set_Loop_Actions);
11166 pragma Inline (Set_Loop_Parameter_Specification);
11167 pragma Inline (Set_Low_Bound);
11168 pragma Inline (Set_Mod_Clause);
11169 pragma Inline (Set_More_Ids);
11170 pragma Inline (Set_Must_Be_Byte_Aligned);
11171 pragma Inline (Set_Must_Not_Freeze);
11172 pragma Inline (Set_Must_Not_Override);
11173 pragma Inline (Set_Must_Override);
11174 pragma Inline (Set_Name);
11175 pragma Inline (Set_Names);
11176 pragma Inline (Set_Next_Entity);
11177 pragma Inline (Set_Next_Named_Actual);
11178 pragma Inline (Set_Next_Use_Clause);
11179 pragma Inline (Set_No_Ctrl_Actions);
11180 pragma Inline (Set_No_Elaboration_Check);
11181 pragma Inline (Set_No_Entities_Ref_In_Spec);
11182 pragma Inline (Set_No_Initialization);
11183 pragma Inline (Set_No_Truncation);
11184 pragma Inline (Set_Null_Present);
11185 pragma Inline (Set_Null_Exclusion_Present);
11186 pragma Inline (Set_Null_Record_Present);
11187 pragma Inline (Set_Object_Definition);
11188 pragma Inline (Set_Original_Discriminant);
11189 pragma Inline (Set_Original_Entity);
11190 pragma Inline (Set_Others_Discrete_Choices);
11191 pragma Inline (Set_Out_Present);
11192 pragma Inline (Set_Parameter_Associations);
11193 pragma Inline (Set_Parameter_Specifications);
11194 pragma Inline (Set_Parameter_List_Truncated);
11195 pragma Inline (Set_Parameter_Type);
11196 pragma Inline (Set_Parent_Spec);
11197 pragma Inline (Set_Position);
11198 pragma Inline (Set_Pragma_Argument_Associations);
11199 pragma Inline (Set_Pragmas_After);
11200 pragma Inline (Set_Pragmas_Before);
11201 pragma Inline (Set_Prefix);
11202 pragma Inline (Set_Present_Expr);
11203 pragma Inline (Set_Prev_Ids);
11204 pragma Inline (Set_Print_In_Hex);
11205 pragma Inline (Set_Private_Declarations);
11206 pragma Inline (Set_Private_Present);
11207 pragma Inline (Set_Procedure_To_Call);
11208 pragma Inline (Set_Proper_Body);
11209 pragma Inline (Set_Protected_Definition);
11210 pragma Inline (Set_Protected_Present);
11211 pragma Inline (Set_Raises_Constraint_Error);
11212 pragma Inline (Set_Range_Constraint);
11213 pragma Inline (Set_Range_Expression);
11214 pragma Inline (Set_Real_Range_Specification);
11215 pragma Inline (Set_Realval);
11216 pragma Inline (Set_Reason);
11217 pragma Inline (Set_Record_Extension_Part);
11218 pragma Inline (Set_Redundant_Use);
11219 pragma Inline (Set_Renaming_Exception);
11220 pragma Inline (Set_Result_Definition);
11221 pragma Inline (Set_Return_Object_Declarations);
11222 pragma Inline (Set_Reverse_Present);
11223 pragma Inline (Set_Right_Opnd);
11224 pragma Inline (Set_Rounded_Result);
11225 pragma Inline (Set_Scope);
11226 pragma Inline (Set_Select_Alternatives);
11227 pragma Inline (Set_Selector_Name);
11228 pragma Inline (Set_Selector_Names);
11229 pragma Inline (Set_Shift_Count_OK);
11230 pragma Inline (Set_Source_Type);
11231 pragma Inline (Set_Specification);
11232 pragma Inline (Set_Statements);
11233 pragma Inline (Set_Static_Processing_OK);
11234 pragma Inline (Set_Storage_Pool);
11235 pragma Inline (Set_Strval);
11236 pragma Inline (Set_Subtype_Indication);
11237 pragma Inline (Set_Subtype_Mark);
11238 pragma Inline (Set_Subtype_Marks);
11239 pragma Inline (Set_Synchronized_Present);
11240 pragma Inline (Set_Tagged_Present);
11241 pragma Inline (Set_Target_Type);
11242 pragma Inline (Set_Task_Definition);
11243 pragma Inline (Set_Task_Present);
11244 pragma Inline (Set_Then_Actions);
11245 pragma Inline (Set_Then_Statements);
11246 pragma Inline (Set_Triggering_Alternative);
11247 pragma Inline (Set_Triggering_Statement);
11248 pragma Inline (Set_Treat_Fixed_As_Integer);
11249 pragma Inline (Set_TSS_Elist);
11250 pragma Inline (Set_Type_Definition);
11251 pragma Inline (Set_Unit);
11252 pragma Inline (Set_Unknown_Discriminants_Present);
11253 pragma Inline (Set_Unreferenced_In_Spec);
11254 pragma Inline (Set_Variant_Part);
11255 pragma Inline (Set_Variants);
11256 pragma Inline (Set_Visible_Declarations);
11257 pragma Inline (Set_Was_Originally_Stub);
11258 pragma Inline (Set_Zero_Cost_Handling);
11260 N_Simple_Return_Statement : constant Node_Kind := N_Return_Statement;
11261 -- Rename N_Return_Statement to be N_Simple_Return_Statement. Clients
11262 -- should refer to N_Simple_Return_Statement.