[multiple changes]
[gcc.git] / gcc / ada / sinfo.ads
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT COMPILER COMPONENTS --
4 -- --
5 -- S I N F O --
6 -- --
7 -- S p e c --
8 -- --
9 -- Copyright (C) 1992-2010, Free Software Foundation, Inc. --
10 -- --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. --
17 -- --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
21 -- --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
26 -- --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
29 -- --
30 ------------------------------------------------------------------------------
31
32 -- This package defines the structure of the abstract syntax tree. The Tree
33 -- package provides a basic tree structure. Sinfo describes how this structure
34 -- is used to represent the syntax of an Ada program.
35
36 -- The grammar in the RM is followed very closely in the tree design, and is
37 -- repeated as part of this source file.
38
39 -- The tree contains not only the full syntactic representation of the
40 -- program, but also the results of semantic analysis. In particular, the
41 -- nodes for defining identifiers, defining character literals and defining
42 -- operator symbols, collectively referred to as entities, represent what
43 -- would normally be regarded as the symbol table information. In addition a
44 -- number of the tree nodes contain semantic information.
45
46 -- WARNING: Several files are automatically generated from this package.
47 -- See below for details.
48
49 with Namet; use Namet;
50 with Types; use Types;
51 with Uintp; use Uintp;
52 with Urealp; use Urealp;
53
54 package Sinfo is
55
56 ---------------------------------
57 -- Making Changes to This File --
58 ---------------------------------
59
60 -- If changes are made to this file, a number of related steps must be
61 -- carried out to ensure consistency. First, if a field access function is
62 -- added, it appears in these places:
63
64 -- In sinfo.ads:
65 -- The documentation associated with the field (if semantic)
66 -- The documentation associated with the node
67 -- The spec of the access function
68 -- The spec of the set procedure
69 -- The entries in Is_Syntactic_Field
70 -- The pragma Inline for the access function
71 -- The pragma Inline for the set procedure
72 -- In sinfo.adb:
73 -- The body of the access function
74 -- The body of the set procedure
75
76 -- The field chosen must be consistent in all places, and, for a node that
77 -- is a subexpression, must not overlap any of the standard expression
78 -- fields.
79
80 -- In addition, if any of the standard expression fields is changed, then
81 -- the utility program which creates the Treeprs spec (in file treeprs.ads)
82 -- must be updated appropriately, since it special cases expression fields.
83
84 -- If a new tree node is added, then the following changes are made
85
86 -- Add it to the documentation in the appropriate place
87 -- Add its fields to this documentation section
88 -- Define it in the appropriate classification in Node_Kind
89 -- In the body (sinfo), add entries to the access functions for all
90 -- its fields (except standard expression fields) to include the new
91 -- node in the checks.
92 -- Add an appropriate section to the case statement in sprint.adb
93 -- Add an appropriate section to the case statement in sem.adb
94 -- Add an appropriate section to the case statement in exp_util.adb
95 -- (Insert_Actions procedure)
96 -- For a subexpression, add an appropriate section to the case
97 -- statement in sem_eval.adb
98 -- For a subexpression, add an appropriate section to the case
99 -- statement in sem_res.adb
100
101 -- Finally, four utility programs must be run:
102
103 -- (Optional.) Run CSinfo to check that you have made the changes
104 -- consistently. It checks most of the rules given above. This utility
105 -- reads sinfo.ads and sinfo.adb and generates a report to standard
106 -- output. This step is optional because XSinfo runs CSinfo.
107
108 -- Run XSinfo to create sinfo.h, the corresponding C header. This
109 -- utility reads sinfo.ads and generates sinfo.h. Note that it does
110 -- not need to read sinfo.adb, since the contents of the body are
111 -- algorithmically determinable from the spec.
112
113 -- Run XTreeprs to create treeprs.ads, an updated version of the module
114 -- that is used to drive the tree print routine. This utility reads (but
115 -- does not modify) treeprs.adt, the template that provides the basic
116 -- structure of the file, and then fills in the data from the comments
117 -- in sinfo.ads.
118
119 -- Run XNmake to create nmake.ads and nmake.adb, the package body and
120 -- spec of the Nmake package which contains functions for constructing
121 -- nodes.
122
123 -- The above steps are done automatically by the build scripts when you do
124 -- a full bootstrap.
125
126 -- Note: sometime we could write a utility that actually generated the body
127 -- of sinfo from the spec instead of simply checking it, since, as noted
128 -- above, the contents of the body can be determined from the spec.
129
130 --------------------------------
131 -- Implicit Nodes in the Tree --
132 --------------------------------
133
134 -- Generally the structure of the tree very closely follows the grammar as
135 -- defined in the RM. However, certain nodes are omitted to save space and
136 -- simplify semantic processing. Two general classes of such omitted nodes
137 -- are as follows:
138
139 -- If the only possibilities for a non-terminal are one or more other
140 -- non-terminals (i.e. the rule is a "skinny" rule), then usually the
141 -- corresponding node is omitted from the tree, and the target construct
142 -- appears directly. For example, a real type definition is either
143 -- floating point definition or a fixed point definition. No explicit node
144 -- appears for real type definition. Instead either the floating point
145 -- definition or fixed point definition appears directly.
146
147 -- If a non-terminal corresponds to a list of some other non-terminal
148 -- (possibly with separating punctuation), then usually it is omitted from
149 -- the tree, and a list of components appears instead. For example,
150 -- sequence of statements does not appear explicitly in the tree. Instead
151 -- a list of statements appears directly.
152
153 -- Some additional cases of omitted nodes occur and are documented
154 -- individually. In particular, many nodes are omitted in the tree
155 -- generated for an expression.
156
157 -------------------------------------------
158 -- Handling of Defining Identifier Lists --
159 -------------------------------------------
160
161 -- In several declarative forms in the syntax, lists of defining
162 -- identifiers appear (object declarations, component declarations, number
163 -- declarations etc.)
164
165 -- The semantics of such statements are equivalent to a series of identical
166 -- declarations of single defining identifiers (except that conformance
167 -- checks require the same grouping of identifiers in the parameter case).
168
169 -- To simplify semantic processing, the parser breaks down such multiple
170 -- declaration cases into sequences of single declarations, duplicating
171 -- type and initialization information as required. The flags More_Ids and
172 -- Prev_Ids are used to record the original form of the source in the case
173 -- where the original source used a list of names, More_Ids being set on
174 -- all but the last name and Prev_Ids being set on all but the first name.
175 -- These flags are used to reconstruct the original source (e.g. in the
176 -- Sprint package), and also are included in the conformance checks, but
177 -- otherwise have no semantic significance.
178
179 -- Note: the reason that we use More_Ids and Prev_Ids rather than
180 -- First_Name and Last_Name flags is so that the flags are off in the
181 -- normal one identifier case, which minimizes tree print output.
182
183 -----------------------
184 -- Use of Node Lists --
185 -----------------------
186
187 -- With a few exceptions, if a construction of the form {non-terminal}
188 -- appears in the tree, lists are used in the corresponding tree node (see
189 -- package Nlists for handling of node lists). In this case a field of the
190 -- parent node points to a list of nodes for the non-terminal. The field
191 -- name for such fields has a plural name which always ends in "s". For
192 -- example, a case statement has a field Alternatives pointing to list of
193 -- case statement alternative nodes.
194
195 -- Only fields pointing to lists have names ending in "s", so generally the
196 -- structure is strongly typed, fields not ending in s point to single
197 -- nodes, and fields ending in s point to lists.
198
199 -- The following example shows how a traversal of a list is written. We
200 -- suppose here that Stmt points to a N_Case_Statement node which has a
201 -- list field called Alternatives:
202
203 -- Alt := First (Alternatives (Stmt));
204 -- while Present (Alt) loop
205 -- ..
206 -- -- processing for case statement alternative Alt
207 -- ..
208 -- Alt := Next (Alt);
209 -- end loop;
210
211 -- The Present function tests for Empty, which in this case signals the end
212 -- of the list. First returns Empty immediately if the list is empty.
213 -- Present is defined in Atree, First and Next are defined in Nlists.
214
215 -- The exceptions to this rule occur with {DEFINING_IDENTIFIERS} in all
216 -- contexts, which is handled as described in the previous section, and
217 -- with {,library_unit_NAME} in the N_With_Clause mode, which is handled
218 -- using the First_Name and Last_Name flags, as further detailed in the
219 -- description of the N_With_Clause node.
220
221 -------------
222 -- Pragmas --
223 -------------
224
225 -- Pragmas can appear in many different context, but are not included in
226 -- the grammar. Still they must appear in the tree, so they can be properly
227 -- processed.
228
229 -- Two approaches are used. In some cases, an extra field is defined in an
230 -- appropriate node that contains a list of pragmas appearing in the
231 -- expected context. For example pragmas can appear before an
232 -- Accept_Alternative in a Selective_Accept_Statement, and these pragmas
233 -- appear in the Pragmas_Before field of the N_Accept_Alternative node.
234
235 -- The other approach is to simply allow pragmas to appear in syntactic
236 -- lists where the grammar (of course) does not include the possibility.
237 -- For example, the Variants field of an N_Variant_Part node points to a
238 -- list that can contain both N_Pragma and N_Variant nodes.
239
240 -- To make processing easier in the latter case, the Nlists package
241 -- provides a set of routines (First_Non_Pragma, Last_Non_Pragma,
242 -- Next_Non_Pragma, Prev_Non_Pragma) that allow such lists to be handled
243 -- ignoring all pragmas.
244
245 -- In the case of the variants list, we can either write:
246
247 -- Variant := First (Variants (N));
248 -- while Present (Variant) loop
249 -- ...
250 -- Variant := Next (Variant);
251 -- end loop;
252
253 -- or
254
255 -- Variant := First_Non_Pragma (Variants (N));
256 -- while Present (Variant) loop
257 -- ...
258 -- Variant := Next_Non_Pragma (Variant);
259 -- end loop;
260
261 -- In the first form of the loop, Variant can either be an N_Pragma or an
262 -- N_Variant node. In the second form, Variant can only be N_Variant since
263 -- all pragmas are skipped.
264
265 ---------------------
266 -- Optional Fields --
267 ---------------------
268
269 -- Fields which correspond to a section of the syntax enclosed in square
270 -- brackets are generally omitted (and the corresponding field set to Empty
271 -- for a node, or No_List for a list). The documentation of such fields
272 -- notes these cases. One exception to this rule occurs in the case of
273 -- possibly empty statement sequences (such as the sequence of statements
274 -- in an entry call alternative). Such cases appear in the syntax rules as
275 -- [SEQUENCE_OF_STATEMENTS] and the fields corresponding to such optional
276 -- statement sequences always contain an empty list (not No_List) if no
277 -- statements are present.
278
279 -- Note: the utility program that constructs the body and spec of the Nmake
280 -- package relies on the format of the comments to determine if a field
281 -- should have a default value in the corresponding make routine. The rule
282 -- is that if the first line of the description of the field contains the
283 -- string "(set to xxx if", then a default value of xxx is provided for
284 -- this field in the corresponding Make_yyy routine.
285
286 -----------------------------------
287 -- Note on Body/Spec Terminology --
288 -----------------------------------
289
290 -- In informal discussions about Ada, it is customary to refer to package
291 -- and subprogram specs and bodies. However, this is not technically
292 -- correct, what is normally referred to as a spec or specification is in
293 -- fact a package declaration or subprogram declaration. We are careful in
294 -- GNAT to use the correct terminology and in particular, the full word
295 -- specification is never used as an incorrect substitute for declaration.
296 -- The structure and terminology used in the tree also reflects the grammar
297 -- and thus uses declaration and specification in the technically correct
298 -- manner.
299
300 -- However, there are contexts in which the informal terminology is useful.
301 -- We have the word "body" to refer to the Interp_Etype declared by the
302 -- declaration of a unit body, and in some contexts we need similar term to
303 -- refer to the entity declared by the package or subprogram declaration,
304 -- and simply using declaration can be confusing since the body also has a
305 -- declaration.
306
307 -- An example of such a context is the link between the package body and
308 -- its declaration. With_Declaration is confusing, since the package body
309 -- itself is a declaration.
310
311 -- To deal with this problem, we reserve the informal term Spec, i.e. the
312 -- popular abbreviation used in this context, to refer to the entity
313 -- declared by the package or subprogram declaration. So in the above
314 -- example case, the field in the body is called With_Spec.
315
316 -- Another important context for the use of the word Spec is in error
317 -- messages, where a hyper-correct use of declaration would be confusing to
318 -- a typical Ada programmer, and even for an expert programmer can cause
319 -- confusion since the body has a declaration as well.
320
321 -- So, to summarize:
322
323 -- Declaration always refers to the syntactic entity that is called
324 -- a declaration. In particular, subprogram declaration
325 -- and package declaration are used to describe the
326 -- syntactic entity that includes the semicolon.
327
328 -- Specification always refers to the syntactic entity that is called
329 -- a specification. In particular, the terms procedure
330 -- specification, function specification, package
331 -- specification, subprogram specification always refer
332 -- to the syntactic entity that has no semicolon.
333
334 -- Spec is an informal term, used to refer to the entity
335 -- that is declared by a task declaration, protected
336 -- declaration, generic declaration, subprogram
337 -- declaration or package declaration.
338
339 -- This convention is followed throughout the GNAT documentation
340 -- both internal and external, and in all error message text.
341
342 ------------------------
343 -- Internal Use Nodes --
344 ------------------------
345
346 -- These are Node_Kind settings used in the internal implementation which
347 -- are not logically part of the specification.
348
349 -- N_Unused_At_Start
350 -- Completely unused entry at the start of the enumeration type. This
351 -- is inserted so that no legitimate value is zero, which helps to get
352 -- better debugging behavior, since zero is a likely uninitialized value).
353
354 -- N_Unused_At_End
355 -- Completely unused entry at the end of the enumeration type. This is
356 -- handy so that arrays with Node_Kind as the index type have an extra
357 -- entry at the end (see for example the use of the Pchar_Pos_Array in
358 -- Treepr, where the extra entry provides the limit value when dealing with
359 -- the last used entry in the array).
360
361 -----------------------------------------
362 -- Note on the settings of Sloc fields --
363 -----------------------------------------
364
365 -- The Sloc field of nodes that come from the source is set by the parser.
366 -- For internal nodes, and nodes generated during expansion the Sloc is
367 -- usually set in the call to the constructor for the node. In general the
368 -- Sloc value chosen for an internal node is the Sloc of the source node
369 -- whose processing is responsible for the expansion. For example, the Sloc
370 -- of an inherited primitive operation is the Sloc of the corresponding
371 -- derived type declaration.
372
373 -- For the nodes of a generic instantiation, the Sloc value is encoded to
374 -- represent both the original Sloc in the generic unit, and the Sloc of
375 -- the instantiation itself. See Sinput.ads for details.
376
377 -- Subprogram instances create two callable entities: one is the visible
378 -- subprogram instance, and the other is an anonymous subprogram nested
379 -- within a wrapper package that contains the renamings for the actuals.
380 -- Both of these entities have the Sloc of the defining entity in the
381 -- instantiation node. This simplifies some ASIS queries.
382
383 -----------------------
384 -- Field Definitions --
385 -----------------------
386
387 -- In the following node definitions, all fields, both syntactic and
388 -- semantic, are documented. The one exception is in the case of entities
389 -- (defining identifiers, character literals and operator symbols), where
390 -- the usage of the fields depends on the entity kind. Entity fields are
391 -- fully documented in the separate package Einfo.
392
393 -- In the node definitions, three common sets of fields are abbreviated to
394 -- save both space in the documentation, and also space in the string
395 -- (defined in Tree_Print_Strings) used to print trees. The following
396 -- abbreviations are used:
397
398 -- Note: the utility program that creates the Treeprs spec (in the file
399 -- xtreeprs.adb) knows about the special fields here, so it must be
400 -- modified if any change is made to these fields.
401
402 -- "plus fields for binary operator"
403 -- Chars (Name1) Name_Id for the operator
404 -- Left_Opnd (Node2) left operand expression
405 -- Right_Opnd (Node3) right operand expression
406 -- Entity (Node4-Sem) defining entity for operator
407 -- Associated_Node (Node4-Sem) for generic processing
408 -- Do_Overflow_Check (Flag17-Sem) set if overflow check needed
409 -- Has_Private_View (Flag11-Sem) set in generic units.
410
411 -- "plus fields for unary operator"
412 -- Chars (Name1) Name_Id for the operator
413 -- Right_Opnd (Node3) right operand expression
414 -- Entity (Node4-Sem) defining entity for operator
415 -- Associated_Node (Node4-Sem) for generic processing
416 -- Do_Overflow_Check (Flag17-Sem) set if overflow check needed
417 -- Has_Private_View (Flag11-Sem) set in generic units.
418
419 -- "plus fields for expression"
420 -- Paren_Count number of parentheses levels
421 -- Etype (Node5-Sem) type of the expression
422 -- Is_Overloaded (Flag5-Sem) >1 type interpretation exists
423 -- Is_Static_Expression (Flag6-Sem) set for static expression
424 -- Raises_Constraint_Error (Flag7-Sem) evaluation raises CE
425 -- Must_Not_Freeze (Flag8-Sem) set if must not freeze
426 -- Do_Range_Check (Flag9-Sem) set if a range check needed
427 -- Assignment_OK (Flag15-Sem) set if modification is OK
428 -- Is_Controlling_Actual (Flag16-Sem) set for controlling argument
429
430 -- Note: see under (EXPRESSION) for further details on the use of
431 -- the Paren_Count field to record the number of parentheses levels.
432
433 -- Node_Kind is the type used in the Nkind field to indicate the node kind.
434 -- The actual definition of this type is given later (the reason for this
435 -- is that we want the descriptions ordered by logical chapter in the RM,
436 -- but the type definition is reordered to facilitate the definition of
437 -- some subtype ranges. The individual descriptions of the nodes show how
438 -- the various fields are used in each node kind, as well as providing
439 -- logical names for the fields. Functions and procedures are provided for
440 -- accessing and setting these fields using these logical names.
441
442 -----------------------
443 -- Gigi Restrictions --
444 -----------------------
445
446 -- The tree passed to Gigi is more restricted than the general tree form.
447 -- For example, as a result of expansion, most of the tasking nodes can
448 -- never appear. For each node to which either a complete or partial
449 -- restriction applies, a note entitled "Gigi restriction" appears which
450 -- documents the restriction.
451
452 -- Note that most of these restrictions apply only to trees generated when
453 -- code is being generated, since they involved expander actions that
454 -- destroy the tree.
455
456 ------------------------
457 -- Common Flag Fields --
458 ------------------------
459
460 -- The following flag fields appear in all nodes
461
462 -- Analyzed
463 -- This flag is used to indicate that a node (and all its children have
464 -- been analyzed. It is used to avoid reanalysis of a node that has
465 -- already been analyzed, both for efficiency and functional correctness
466 -- reasons.
467
468 -- Comes_From_Source
469 -- This flag is set if the node comes directly from an explicit construct
470 -- in the source. It is normally on for any nodes built by the scanner or
471 -- parser from the source program, with the exception that in a few cases
472 -- the parser adds nodes to normalize the representation (in particular
473 -- a null statement is added to a package body if there is no begin/end
474 -- initialization section.
475 --
476 -- Most nodes inserted by the analyzer or expander are not considered
477 -- as coming from source, so the flag is off for such nodes. In a few
478 -- cases, the expander constructs nodes closely equivalent to nodes
479 -- from the source program (e.g. the allocator built for build-in-place
480 -- case), and the Comes_From_Source flag is deliberately set.
481
482 -- Error_Posted
483 -- This flag is used to avoid multiple error messages being posted on or
484 -- referring to the same node. This flag is set if an error message
485 -- refers to a node or is posted on its source location, and has the
486 -- effect of inhibiting further messages involving this same node.
487
488 -- Has_Dynamic_Length_Check (Flag10-Sem)
489 -- This flag is present on all nodes. It is set to indicate that one of
490 -- the routines in unit Checks has generated a length check action which
491 -- has been inserted at the flagged node. This is used to avoid the
492 -- generation of duplicate checks.
493
494 -- Has_Dynamic_Range_Check (Flag12-Sem)
495 -- This flag is present on all nodes. It is set to indicate that one of
496 -- the routines in unit Checks has generated a range check action which
497 -- has been inserted at the flagged node. This is used to avoid the
498 -- generation of duplicate checks.
499
500 -- Has_Local_Raise (Flag8-Sem)
501 -- Present in exception handler nodes. Set if the handler can be entered
502 -- via a local raise that gets transformed to a goto statement. This will
503 -- always be set if Local_Raise_Statements is non-empty, but can also be
504 -- set as a result of generation of N_Raise_xxx nodes, or flags set in
505 -- nodes requiring generation of back end checks.
506
507 ------------------------------------
508 -- Description of Semantic Fields --
509 ------------------------------------
510
511 -- The meaning of the syntactic fields is generally clear from their names
512 -- without any further description, since the names are chosen to
513 -- correspond very closely to the syntax in the reference manual. This
514 -- section describes the usage of the semantic fields, which are used to
515 -- contain additional information determined during semantic analysis.
516
517 -- ABE_Is_Certain (Flag18-Sem)
518 -- This flag is set in an instantiation node or a call node is determined
519 -- to be sure to raise an ABE. This is used to trigger special handling
520 -- of such cases, particularly in the instantiation case where we avoid
521 -- instantiating the body if this flag is set. This flag is also present
522 -- in an N_Formal_Package_Declaration_Node since formal package
523 -- declarations are treated like instantiations, but it is always set to
524 -- False in this context.
525
526 -- Accept_Handler_Records (List5-Sem)
527 -- This field is present only in an N_Accept_Alternative node. It is used
528 -- to temporarily hold the exception handler records from an accept
529 -- statement in a selective accept. These exception handlers will
530 -- eventually be placed in the Handler_Records list of the procedure
531 -- built for this accept (see Expand_N_Selective_Accept procedure in
532 -- Exp_Ch9 for further details).
533
534 -- Access_Types_To_Process (Elist2-Sem)
535 -- Present in N_Freeze_Entity nodes for Incomplete or private types.
536 -- Contains the list of access types which may require specific treatment
537 -- when the nature of the type completion is completely known. An example
538 -- of such treatment is the generation of the associated_final_chain.
539
540 -- Actions (List1-Sem)
541 -- This field contains a sequence of actions that are associated with the
542 -- node holding the field. See the individual node types for details of
543 -- how this field is used, as well as the description of the specific use
544 -- for a particular node type.
545
546 -- Activation_Chain_Entity (Node3-Sem)
547 -- This is used in tree nodes representing task activators (blocks,
548 -- subprogram bodies, package declarations, and task bodies). It is
549 -- initially Empty, and then gets set to point to the entity for the
550 -- declared Activation_Chain variable when the first task is declared.
551 -- When tasks are declared in the corresponding declarative region this
552 -- entity is located by name (its name is always _Chain) and the declared
553 -- tasks are added to the chain. Note that N_Extended_Return_Statement
554 -- does not have this attribute, although it does have an activation
555 -- chain. This chain is used to store the tasks temporarily, and is not
556 -- used for activating them. On successful completion of the return
557 -- statement, the tasks are moved to the caller's chain, and the caller
558 -- activates them.
559
560 -- Acts_As_Spec (Flag4-Sem)
561 -- A flag set in the N_Subprogram_Body node for a subprogram body which
562 -- is acting as its own spec, except in the case of a library level
563 -- subprogram, in which case the flag is set on the parent compilation
564 -- unit node instead (see further description in spec of Lib package).
565 -- ??? Above note about Lib is dubious since lib.ads does not mention
566 -- Acts_As_Spec at all.
567
568 -- Actual_Designated_Subtype (Node4-Sem)
569 -- Present in N_Free_Statement and N_Explicit_Dereference nodes. If gigi
570 -- needs to known the dynamic constrained subtype of the designated
571 -- object, this attribute is set to that type. This is done for
572 -- N_Free_Statements for access-to-classwide types and access to
573 -- unconstrained packed array types, and for N_Explicit_Dereference when
574 -- the designated type is an unconstrained packed array and the
575 -- dereference is the prefix of a 'Size attribute reference.
576
577 -- Address_Warning_Posted (Flag18-Sem)
578 -- Present in N_Attribute_Definition nodes. Set to indicate that we have
579 -- posted a warning for the address clause regarding size or alignment
580 -- issues. Used to inhibit multiple redundant messages.
581
582 -- Aggregate_Bounds (Node3-Sem)
583 -- Present in array N_Aggregate nodes. If the bounds of the aggregate are
584 -- known at compile time, this field points to an N_Range node with those
585 -- bounds. Otherwise Empty.
586
587 -- All_Others (Flag11-Sem)
588 -- Present in an N_Others_Choice node. This flag is set for an others
589 -- exception where all exceptions are to be caught, even those that are
590 -- not normally handled (in particular the tasking abort signal). This
591 -- is used for translation of the at end handler into a normal exception
592 -- handler.
593
594 -- Aspect_Cancel (Flag11-Sem)
595 -- Processing of aspect specifications typically generates pragmas and
596 -- attribute definition clauses that are inserted into the tree after
597 -- the declaration node to get the desired aspect effect. In the case
598 -- of Boolean aspects that use "=> False" to cancel the effect of an
599 -- aspect (i.e. turn if off), the generated pragma has the Aspect_Cancel
600 -- flag set to indicate that the pragma operates in the opposite sense.
601
602 -- Aspect_Rep_Item (Node2-Sem)
603 -- Present in N_Aspect_Specification nodes. Points to the corresponding
604 -- pragma/attribute definition node used to process the aspect.
605
606 -- Assignment_OK (Flag15-Sem)
607 -- This flag is set in a subexpression node for an object, indicating
608 -- that the associated object can be modified, even if this would not
609 -- normally be permissible (either by direct assignment, or by being
610 -- passed as an out or in-out parameter). This is used by the expander
611 -- for a number of purposes, including initialization of constants and
612 -- limited type objects (such as tasks), setting discriminant fields,
613 -- setting tag values, etc. N_Object_Declaration nodes also have this
614 -- flag defined. Here it is used to indicate that an initialization
615 -- expression is valid, even where it would normally not be allowed
616 -- (e.g. where the type involved is limited).
617
618 -- Associated_Node (Node4-Sem)
619 -- Present in nodes that can denote an entity: identifiers, character
620 -- literals, operator symbols, expanded names, operator nodes, and
621 -- attribute reference nodes (all these nodes have an Entity field).
622 -- This field is also present in N_Aggregate, N_Selected_Component, and
623 -- N_Extension_Aggregate nodes. This field is used in generic processing
624 -- to create links between the generic template and the generic copy.
625 -- See Sem_Ch12.Get_Associated_Node for full details. Note that this
626 -- field overlaps Entity, which is fine, since, as explained in Sem_Ch12,
627 -- the normal function of Entity is not required at the point where the
628 -- Associated_Node is set. Note also, that in generic templates, this
629 -- means that the Entity field does not necessarily point to an Entity.
630 -- Since the back end is expected to ignore generic templates, this is
631 -- harmless.
632
633 -- At_End_Proc (Node1)
634 -- This field is present in an N_Handled_Sequence_Of_Statements node.
635 -- It contains an identifier reference for the cleanup procedure to be
636 -- called. See description of this node for further details.
637
638 -- Backwards_OK (Flag6-Sem)
639 -- A flag present in the N_Assignment_Statement node. It is used only
640 -- if the type being assigned is an array type, and is set if analysis
641 -- determines that it is definitely safe to do the copy backwards, i.e.
642 -- starting at the highest addressed element. This is the case if either
643 -- the operands do not overlap, or they may overlap, but if they do,
644 -- then the left operand is at a higher address than the right operand.
645 --
646 -- Note: If neither of the flags Forwards_OK or Backwards_OK is set, it
647 -- means that the front end could not determine that either direction is
648 -- definitely safe, and a runtime check may be required if the backend
649 -- cannot figure it out. If both flags Forwards_OK and Backwards_OK are
650 -- set, it means that the front end can assure no overlap of operands.
651
652 -- Body_To_Inline (Node3-Sem)
653 -- present in subprogram declarations. Denotes analyzed but unexpanded
654 -- body of subprogram, to be used when inlining calls. Present when the
655 -- subprogram has an Inline pragma and inlining is enabled. If the
656 -- declaration is completed by a renaming_as_body, and the renamed en-
657 -- tity is a subprogram, the Body_To_Inline is the name of that entity,
658 -- which is used directly in later calls to the original subprogram.
659
660 -- Body_Required (Flag13-Sem)
661 -- A flag that appears in the N_Compilation_Unit node indicating that
662 -- the corresponding unit requires a body. For the package case, this
663 -- indicates that a completion is required. In Ada 95, if the flag is not
664 -- set for the package case, then a body may not be present. In Ada 83,
665 -- if the flag is not set for the package case, then body is optional.
666 -- For a subprogram declaration, the flag is set except in the case where
667 -- a pragma Import or Interface applies, in which case no body is
668 -- permitted (in Ada 83 or Ada 95).
669
670 -- By_Ref (Flag5-Sem)
671 -- Present in N_Simple_Return_Statement and N_Extended_Return_Statement,
672 -- this flag is set when the returned expression is already allocated on
673 -- the secondary stack and thus the result is passed by reference rather
674 -- than copied another time.
675
676 -- Check_Address_Alignment (Flag11-Sem)
677 -- A flag present in N_Attribute_Definition clause for a 'Address
678 -- attribute definition. This flag is set if a dynamic check should be
679 -- generated at the freeze point for the entity to which this address
680 -- clause applies. The reason that we need this flag is that we want to
681 -- check for range checks being suppressed at the point where the
682 -- attribute definition clause is given, rather than testing this at the
683 -- freeze point.
684
685 -- Coextensions (Elist4-Sem)
686 -- Present in allocators nodes. Points to list of allocators for the
687 -- access discriminants of the allocated object.
688
689 -- Comes_From_Extended_Return_Statement (Flag18-Sem)
690 -- Present in N_Simple_Return_Statement nodes. True if this node was
691 -- constructed as part of the N_Extended_Return_Statement expansion.
692
693 -- Compile_Time_Known_Aggregate (Flag18-Sem)
694 -- Present in N_Aggregate nodes. Set for aggregates which can be fully
695 -- evaluated at compile time without raising constraint error. Such
696 -- aggregates can be passed as is to Gigi without any expansion. See
697 -- Sem_Aggr for the specific conditions under which an aggregate has this
698 -- flag set. See also the flag Static_Processing_OK.
699
700 -- Componentwise_Assignment (Flag14-Sem)
701 -- Present in N_Assignment_Statement nodes. Set for a record assignment
702 -- where all that needs doing is to expand it into component-by-component
703 -- assignments. This is used internally for the case of tagged types with
704 -- rep clauses, where we need to avoid recursion (we don't want to try to
705 -- generate a call to the primitive operation, because this is the case
706 -- where we are compiling the primitive operation). Note that when we are
707 -- expanding component assignments in this case, we never assign the _tag
708 -- field, but we recursively assign components of the parent type.
709
710 -- Condition_Actions (List3-Sem)
711 -- This field appears in else-if nodes and in the iteration scheme node
712 -- for while loops. This field is only used during semantic processing to
713 -- temporarily hold actions inserted into the tree. In the tree passed
714 -- to gigi, the condition actions field is always set to No_List. For
715 -- details on how this field is used, see the routine Insert_Actions in
716 -- package Exp_Util, and also the expansion routines for the relevant
717 -- nodes.
718
719 -- Context_Pending (Flag16-Sem)
720 -- This field appears in Compilation_Unit nodes, to indicate that the
721 -- context of the unit is being compiled. Used to detect circularities
722 -- that are not otherwise detected by the loading mechanism. Such
723 -- circularities can occur in the presence of limited and non-limited
724 -- with_clauses that mention the same units.
725
726 -- Controlling_Argument (Node1-Sem)
727 -- This field is set in procedure and function call nodes if the call
728 -- is a dispatching call (it is Empty for a non-dispatching call). It
729 -- indicates the source of the call's controlling tag. For procedure
730 -- calls, the Controlling_Argument is one of the actuals. For function
731 -- that has a dispatching result, it is an entity in the context of the
732 -- call that can provide a tag, or else it is the tag of the root type
733 -- of the class. It can also specify a tag directly rather than being a
734 -- tagged object. The latter is needed by the implementations of AI-239
735 -- and AI-260.
736
737 -- Conversion_OK (Flag14-Sem)
738 -- A flag set on type conversion nodes to indicate that the conversion
739 -- is to be considered as being valid, even though it is the case that
740 -- the conversion is not valid Ada. This is used for attributes Enum_Rep,
741 -- Fixed_Value and Integer_Value, for internal conversions done for
742 -- fixed-point operations, and for certain conversions for calls to
743 -- initialization procedures. If Conversion_OK is set, then Etype must be
744 -- set (the analyzer assumes that Etype has been set). For the case of
745 -- fixed-point operands, it also indicates that the conversion is to be
746 -- direct conversion of the underlying integer result, with no regard to
747 -- the small operand.
748
749 -- Corresponding_Body (Node5-Sem)
750 -- This field is set in subprogram declarations, package declarations,
751 -- entry declarations of protected types, and in generic units. It
752 -- points to the defining entity for the corresponding body (NOT the
753 -- node for the body itself).
754
755 -- Corresponding_Formal_Spec (Node3-Sem)
756 -- This field is set in subprogram renaming declarations, where it points
757 -- to the defining entity for a formal subprogram in the case where the
758 -- renaming corresponds to a generic formal subprogram association in an
759 -- instantiation. The field is Empty if the renaming does not correspond
760 -- to such a formal association.
761
762 -- Corresponding_Generic_Association (Node5-Sem)
763 -- This field is defined for object declarations and object renaming
764 -- declarations. It is set for the declarations within an instance that
765 -- map generic formals to their actuals. If set, the field points to
766 -- a generic_association which is the original parent of the expression
767 -- or name appearing in the declaration. This simplifies ASIS queries.
768
769 -- Corresponding_Integer_Value (Uint4-Sem)
770 -- This field is set in real literals of fixed-point types (it is not
771 -- used for floating-point types). It contains the integer value used
772 -- to represent the fixed-point value. It is also set on the universal
773 -- real literals used to represent bounds of fixed-point base types
774 -- and their first named subtypes.
775
776 -- Corresponding_Spec (Node5-Sem)
777 -- This field is set in subprogram, package, task, and protected body
778 -- nodes, where it points to the defining entity in the corresponding
779 -- spec. The attribute is also set in N_With_Clause nodes where it points
780 -- to the defining entity for the with'ed spec, and in a subprogram
781 -- renaming declaration when it is a Renaming_As_Body. The field is Empty
782 -- if there is no corresponding spec, as in the case of a subprogram body
783 -- that serves as its own spec.
784
785 -- Corresponding_Stub (Node3-Sem)
786 -- This field is present in an N_Subunit node. It holds the node in
787 -- the parent unit that is the stub declaration for the subunit. It is
788 -- set when analysis of the stub forces loading of the proper body. If
789 -- expansion of the proper body creates new declarative nodes, they are
790 -- inserted at the point of the corresponding_stub.
791
792 -- Dcheck_Function (Node5-Sem)
793 -- This field is present in an N_Variant node, It references the entity
794 -- for the discriminant checking function for the variant.
795
796 -- Debug_Statement (Node3)
797 -- This field is present in an N_Pragma node. It is used only for a Debug
798 -- pragma. The parameter is of the form of an expression, as required by
799 -- the pragma syntax, but is actually a procedure call. To simplify
800 -- semantic processing, the parser creates a copy of the argument
801 -- rearranged into a procedure call statement and places it in the
802 -- Debug_Statement field. Note that this field is considered syntactic
803 -- field, since it is created by the parser.
804
805 -- Default_Expression (Node5-Sem)
806 -- This field is Empty if there is no default expression. If there is a
807 -- simple default expression (one with no side effects), then this field
808 -- simply contains a copy of the Expression field (both point to the tree
809 -- for the default expression). Default_Expression is used for
810 -- conformance checking.
811
812 -- Default_Storage_Pool (Node3-Sem)
813 -- This field is present in N_Compilation_Unit_Aux nodes. It is set to a
814 -- copy of Opt.Default_Pool at the end of the compilation unit. See
815 -- package Opt for details. This is used for inheriting the
816 -- Default_Storage_Pool in child units.
817
818 -- Discr_Check_Funcs_Built (Flag11-Sem)
819 -- This flag is present in N_Full_Type_Declaration nodes. It is set when
820 -- discriminant checking functions are constructed. The purpose is to
821 -- avoid attempting to set these functions more than once.
822
823 -- Do_Accessibility_Check (Flag13-Sem)
824 -- This flag is set on N_Parameter_Specification nodes to indicate
825 -- that an accessibility check is required for the parameter. It is
826 -- not yet decided who takes care of this check (TBD ???).
827
828 -- Do_Discriminant_Check (Flag13-Sem)
829 -- This flag is set on N_Selected_Component nodes to indicate that a
830 -- discriminant check is required using the discriminant check routine
831 -- associated with the selector. The actual check is generated by the
832 -- expander when processing selected components.
833
834 -- Do_Division_Check (Flag13-Sem)
835 -- This flag is set on a division operator (/ mod rem) to indicate
836 -- that a zero divide check is required. The actual check is dealt
837 -- with by the backend (all the front end does is to set the flag).
838
839 -- Do_Length_Check (Flag4-Sem)
840 -- This flag is set in an N_Assignment_Statement, N_Op_And, N_Op_Or,
841 -- N_Op_Xor, or N_Type_Conversion node to indicate that a length check
842 -- is required. It is not determined who deals with this flag (???).
843
844 -- Do_Overflow_Check (Flag17-Sem)
845 -- This flag is set on an operator where an overflow check is required on
846 -- the operation. The actual check is dealt with by the backend (all the
847 -- front end does is to set the flag). The other cases where this flag is
848 -- used is on a Type_Conversion node and for attribute reference nodes.
849 -- For a type conversion, it means that the conversion is from one base
850 -- type to another, and the value may not fit in the target base type.
851 -- See also the description of Do_Range_Check for this case. The only
852 -- attribute references which use this flag are Pred and Succ, where it
853 -- means that the result should be checked for going outside the base
854 -- range. Note that this flag is not set for modular types.
855
856 -- Do_Range_Check (Flag9-Sem)
857 -- This flag is set on an expression which appears in a context where a
858 -- range check is required. The target type is clear from the context.
859 -- The contexts in which this flag can appear are the following:
860
861 -- Right side of an assignment. In this case the target type is
862 -- taken from the left side of the assignment, which is referenced
863 -- by the Name of the N_Assignment_Statement node.
864
865 -- Subscript expressions in an indexed component. In this case the
866 -- target type is determined from the type of the array, which is
867 -- referenced by the Prefix of the N_Indexed_Component node.
868
869 -- Argument expression for a parameter, appearing either directly in
870 -- the Parameter_Associations list of a call or as the Expression of an
871 -- N_Parameter_Association node that appears in this list. In either
872 -- case, the check is against the type of the formal. Note that the
873 -- flag is relevant only in IN and IN OUT parameters, and will be
874 -- ignored for OUT parameters, where no check is required in the call,
875 -- and if a check is required on the return, it is generated explicitly
876 -- with a type conversion.
877
878 -- Initialization expression for the initial value in an object
879 -- declaration. In this case the Do_Range_Check flag is set on
880 -- the initialization expression, and the check is against the
881 -- range of the type of the object being declared.
882
883 -- The expression of a type conversion. In this case the range check is
884 -- against the target type of the conversion. See also the use of
885 -- Do_Overflow_Check on a type conversion. The distinction is that the
886 -- overflow check protects against a value that is outside the range of
887 -- the target base type, whereas a range check checks that the
888 -- resulting value (which is a value of the base type of the target
889 -- type), satisfies the range constraint of the target type.
890
891 -- Note: when a range check is required in contexts other than those
892 -- listed above (e.g. in a return statement), an additional type
893 -- conversion node is introduced to represent the required check.
894
895 -- Do_Storage_Check (Flag17-Sem)
896 -- This flag is set in an N_Allocator node to indicate that a storage
897 -- check is required for the allocation, or in an N_Subprogram_Body node
898 -- to indicate that a stack check is required in the subprogram prolog.
899 -- The N_Allocator case is handled by the routine that expands the call
900 -- to the runtime routine. The N_Subprogram_Body case is handled by the
901 -- backend, and all the semantics does is set the flag.
902
903 -- Do_Tag_Check (Flag13-Sem)
904 -- This flag is set on an N_Assignment_Statement, N_Function_Call,
905 -- N_Procedure_Call_Statement, N_Type_Conversion,
906 -- N_Simple_Return_Statement, or N_Extended_Return_Statement
907 -- node to indicate that the tag check can be suppressed. It is not
908 -- yet decided how this flag is used (TBD ???).
909
910 -- Elaborate_Present (Flag4-Sem)
911 -- This flag is set in the N_With_Clause node to indicate that pragma
912 -- Elaborate pragma appears for the with'ed units.
913
914 -- Elaborate_All_Desirable (Flag9-Sem)
915 -- This flag is set in the N_With_Clause mode to indicate that the static
916 -- elaboration processing has determined that an Elaborate_All pragma is
917 -- desirable for correct elaboration for this unit.
918
919 -- Elaborate_All_Present (Flag14-Sem)
920 -- This flag is set in the N_With_Clause node to indicate that a
921 -- pragma Elaborate_All pragma appears for the with'ed units.
922
923 -- Elaborate_Desirable (Flag11-Sem)
924 -- This flag is set in the N_With_Clause mode to indicate that the static
925 -- elaboration processing has determined that an Elaborate pragma is
926 -- desirable for correct elaboration for this unit.
927
928 -- Elaboration_Boolean (Node2-Sem)
929 -- This field is present in function and procedure specification nodes.
930 -- If set, it points to the entity for a Boolean flag that must be tested
931 -- for certain calls to check for access before elaboration. See body of
932 -- Sem_Elab for further details. This field is Empty if no elaboration
933 -- boolean is required.
934
935 -- Else_Actions (List3-Sem)
936 -- This field is present in conditional expression nodes. During code
937 -- expansion we use the Insert_Actions procedure (in Exp_Util) to insert
938 -- actions at an appropriate place in the tree to get elaborated at the
939 -- right time. For conditional expressions, we have to be sure that the
940 -- actions for the Else branch are only elaborated if the condition is
941 -- False. The Else_Actions field is used as a temporary parking place for
942 -- these actions. The final tree is always rewritten to eliminate the
943 -- need for this field, so in the tree passed to Gigi, this field is
944 -- always set to No_List.
945
946 -- Enclosing_Variant (Node2-Sem)
947 -- This field is present in the N_Variant node and identifies the Node_Id
948 -- corresponding to the immediately enclosing variant when the variant is
949 -- nested, and N_Empty otherwise. Set during semantic processing of the
950 -- variant part of a record type.
951
952 -- Entity (Node4-Sem)
953 -- Appears in all direct names (identifiers, character literals, and
954 -- operator symbols), as well as expanded names, and attributes that
955 -- denote entities, such as 'Class. Points to entity for corresponding
956 -- defining occurrence. Set after name resolution. For identifiers in a
957 -- WITH list, the corresponding defining occurrence is in a separately
958 -- compiled file, and Entity must be set by the library Load procedure.
959 --
960 -- Note: During name resolution, the value in Entity may be temporarily
961 -- incorrect (e.g. during overload resolution, Entity is initially set to
962 -- the first possible correct interpretation, and then later modified if
963 -- necessary to contain the correct value after resolution).
964 --
965 -- Note: This field overlaps Associated_Node, which is used during
966 -- generic processing (see Sem_Ch12 for details). Note also that in
967 -- generic templates, this means that the Entity field does not always
968 -- point to an Entity. Since the back end is expected to ignore generic
969 -- templates, this is harmless.
970 --
971 -- Note: This field also appears in N_Attribute_Definition_Clause nodes.
972 -- It is used only for stream attributes definition clauses. In this
973 -- case, it denotes a (possibly dummy) subprogram entity that is declared
974 -- conceptually at the point of the clause. Thus the visibility of the
975 -- attribute definition clause (in the sense of 8.3(23) as amended by
976 -- AI-195) can be checked by testing the visibility of that subprogram.
977 --
978 -- Note: Normally the Entity field of an identifier points to the entity
979 -- for the corresponding defining identifier, and hence the Chars field
980 -- of an identifier will match the Chars field of the entity. However,
981 -- there is no requirement that these match, and there are obscure cases
982 -- of generated code where they do not match.
983
984 -- Entity_Or_Associated_Node (Node4-Sem)
985 -- A synonym for both Entity and Associated_Node. Used by convention in
986 -- the code when referencing this field in cases where it is not known
987 -- whether the field contains an Entity or an Associated_Node.
988
989 -- Etype (Node5-Sem)
990 -- Appears in all expression nodes, all direct names, and all entities.
991 -- Points to the entity for the related type. Set after type resolution.
992 -- Normally this is the actual subtype of the expression. However, in
993 -- certain contexts such as the right side of an assignment, subscripts,
994 -- arguments to calls, returned value in a function, initial value etc.
995 -- it is the desired target type. In the event that this is different
996 -- from the actual type, the Do_Range_Check flag will be set if a range
997 -- check is required. Note: if the Is_Overloaded flag is set, then Etype
998 -- points to an essentially arbitrary choice from the possible set of
999 -- types.
1000
1001 -- Exception_Junk (Flag8-Sem)
1002 -- This flag is set in a various nodes appearing in a statement sequence
1003 -- to indicate that the corresponding node is an artifact of the
1004 -- generated code for exception handling, and should be ignored when
1005 -- analyzing the control flow of the relevant sequence of statements
1006 -- (e.g. to check that it does not end with a bad return statement).
1007
1008 -- Exception_Label (Node5-Sem)
1009 -- Appears in N_Push_xxx_Label nodes. Points to the entity of the label
1010 -- to be used for transforming the corresponding exception into a goto,
1011 -- or contains Empty, if this exception is not to be transformed. Also
1012 -- appears in N_Exception_Handler nodes, where, if set, it indicates
1013 -- that there may be a local raise for the handler, so that expansion
1014 -- to allow a goto is required (and this field contains the label for
1015 -- this goto). See Exp_Ch11.Expand_Local_Exception_Handlers for details.
1016
1017 -- Expansion_Delayed (Flag11-Sem)
1018 -- Set on aggregates and extension aggregates that need a top-down rather
1019 -- than bottom-up expansion. Typically aggregate expansion happens bottom
1020 -- up. For nested aggregates the expansion is delayed until the enclosing
1021 -- aggregate itself is expanded, e.g. in the context of a declaration. To
1022 -- delay it we set this flag. This is done to avoid creating a temporary
1023 -- for each level of a nested aggregates, and also to prevent the
1024 -- premature generation of constraint checks. This is also a requirement
1025 -- if we want to generate the proper attachment to the internal
1026 -- finalization lists (for record with controlled components). Top down
1027 -- expansion of aggregates is also used for in-place array aggregate
1028 -- assignment or initialization. When the full context is known, the
1029 -- target of the assignment or initialization is used to generate the
1030 -- left-hand side of individual assignment to each sub-component.
1031
1032 -- First_Inlined_Subprogram (Node3-Sem)
1033 -- Present in the N_Compilation_Unit node for the main program. Points
1034 -- to a chain of entities for subprograms that are to be inlined. The
1035 -- Next_Inlined_Subprogram field of these entities is used as a link
1036 -- pointer with Empty marking the end of the list. This field is Empty
1037 -- if there are no inlined subprograms or inlining is not active.
1038
1039 -- First_Named_Actual (Node4-Sem)
1040 -- Present in procedure call statement and function call nodes, and also
1041 -- in Intrinsic nodes. Set during semantic analysis to point to the first
1042 -- named parameter where parameters are ordered by declaration order (as
1043 -- opposed to the actual order in the call which may be different due to
1044 -- named associations). Note: this field points to the explicit actual
1045 -- parameter itself, not the N_Parameter_Association node (its parent).
1046
1047 -- First_Real_Statement (Node2-Sem)
1048 -- Present in N_Handled_Sequence_Of_Statements node. Normally set to
1049 -- Empty. Used only when declarations are moved into the statement part
1050 -- of a construct as a result of wrapping an AT END handler that is
1051 -- required to cover the declarations. In this case, this field is used
1052 -- to remember the location in the statements list of the first real
1053 -- statement, i.e. the statement that used to be first in the statement
1054 -- list before the declarations were prepended.
1055
1056 -- First_Subtype_Link (Node5-Sem)
1057 -- Present in N_Freeze_Entity node for an anonymous base type that is
1058 -- implicitly created by the declaration of a first subtype. It points
1059 -- to the entity for the first subtype.
1060
1061 -- Float_Truncate (Flag11-Sem)
1062 -- A flag present in type conversion nodes. This is used for float to
1063 -- integer conversions where truncation is required rather than rounding.
1064 -- Note that Gigi does not handle type conversions from real to integer
1065 -- with rounding (see Expand_N_Type_Conversion).
1066
1067 -- Forwards_OK (Flag5-Sem)
1068 -- A flag present in the N_Assignment_Statement node. It is used only
1069 -- if the type being assigned is an array type, and is set if analysis
1070 -- determines that it is definitely safe to do the copy forwards, i.e.
1071 -- starting at the lowest addressed element. This is the case if either
1072 -- the operands do not overlap, or they may overlap, but if they do,
1073 -- then the left operand is at a lower address than the right operand.
1074 --
1075 -- Note: If neither of the flags Forwards_OK or Backwards_OK is set, it
1076 -- means that the front end could not determine that either direction is
1077 -- definitely safe, and a runtime check may be required if the backend
1078 -- cannot figure it out. If both flags Forwards_OK and Backwards_OK are
1079 -- set, it means that the front end can assure no overlap of operands.
1080
1081 -- From_Aspect_Specification (Flag13-Sem)
1082 -- Processing of aspect specifications typically results in insertion in
1083 -- the tree of corresponding pragma or attribute definition clause nodes.
1084 -- These generated nodes have the From_Aspect_Specification flag set to
1085 -- indicate that they came from aspect specifications originally.
1086
1087 -- From_At_End (Flag4-Sem)
1088 -- This flag is set on an N_Raise_Statement node if it corresponds to
1089 -- the reraise statement generated as the last statement of an AT END
1090 -- handler when SJLJ exception handling is active. It is used to stop
1091 -- a bogus violation of restriction (No_Exception_Propagation), bogus
1092 -- because if the restriction is set, the reraise is not generated.
1093
1094 -- From_At_Mod (Flag4-Sem)
1095 -- This flag is set on the attribute definition clause node that is
1096 -- generated by a transformation of an at mod phrase in a record
1097 -- representation clause. This is used to give slightly different (Ada 83
1098 -- compatible) semantics to such a clause, namely it is used to specify a
1099 -- minimum acceptable alignment for the base type and all subtypes. In
1100 -- Ada 95 terms, the actual alignment of the base type and all subtypes
1101 -- must be a multiple of the given value, and the representation clause
1102 -- is considered to be type specific instead of subtype specific.
1103
1104 -- From_Default (Flag6-Sem)
1105 -- This flag is set on the subprogram renaming declaration created in an
1106 -- instance for a formal subprogram, when the formal is declared with a
1107 -- box, and there is no explicit actual. If the flag is present, the
1108 -- declaration is treated as an implicit reference to the formal in the
1109 -- ali file.
1110
1111 -- Generic_Parent (Node5-Sem)
1112 -- Generic_Parent is defined on declaration nodes that are instances. The
1113 -- value of Generic_Parent is the generic entity from which the instance
1114 -- is obtained. Generic_Parent is also defined for the renaming
1115 -- declarations and object declarations created for the actuals in an
1116 -- instantiation. The generic parent of such a declaration is the
1117 -- corresponding generic association in the Instantiation node.
1118
1119 -- Generic_Parent_Type (Node4-Sem)
1120 -- Generic_Parent_Type is defined on Subtype_Declaration nodes for the
1121 -- actuals of formal private and derived types. Within the instance, the
1122 -- operations on the actual are those inherited from the parent. For a
1123 -- formal private type, the parent type is the generic type itself. The
1124 -- Generic_Parent_Type is also used in an instance to determine whether a
1125 -- private operation overrides an inherited one.
1126
1127 -- Handler_List_Entry (Node2-Sem)
1128 -- This field is present in N_Object_Declaration nodes. It is set only
1129 -- for the Handler_Record entry generated for an exception in zero cost
1130 -- exception handling mode. It references the corresponding item in the
1131 -- handler list, and is used to delete this entry if the corresponding
1132 -- handler is deleted during optimization. For further details on why
1133 -- this is required, see Exp_Ch11.Remove_Handler_Entries.
1134
1135 -- Has_No_Elaboration_Code (Flag17-Sem)
1136 -- A flag that appears in the N_Compilation_Unit node to indicate whether
1137 -- or not elaboration code is present for this unit. It is initially set
1138 -- true for subprogram specs and bodies and for all generic units and
1139 -- false for non-generic package specs and bodies. Gigi may set the flag
1140 -- in the non-generic package case if it determines that no elaboration
1141 -- code is generated. Note that this flag is not related to the
1142 -- Is_Preelaborated status, there can be preelaborated packages that
1143 -- generate elaboration code, and non-preelaborated packages which do
1144 -- not generate elaboration code.
1145
1146 -- Has_Pragma_CPU (Flag14-Sem)
1147 -- A flag present in N_Subprogram_Body and N_Task_Definition nodes to
1148 -- flag the presence of a CPU pragma in the declaration sequence (public
1149 -- or private in the task case).
1150
1151 -- Has_Pragma_Suppress_All (Flag14-Sem)
1152 -- This flag is set in an N_Compilation_Unit node if the Suppress_All
1153 -- pragma appears anywhere in the unit. This accomodates the rather
1154 -- strange placement rules of other compilers (DEC permits it at the
1155 -- end of a unit, and Rational allows it as a program unit pragma). We
1156 -- allow it anywhere at all, and consider it equivalent to a pragma
1157 -- Suppress (All_Checks) appearing at the start of the configuration
1158 -- pragmas for the unit.
1159
1160 -- Has_Pragma_Priority (Flag6-Sem)
1161 -- A flag present in N_Subprogram_Body, N_Task_Definition and
1162 -- N_Protected_Definition nodes to flag the presence of either a Priority
1163 -- or Interrupt_Priority pragma in the declaration sequence (public or
1164 -- private in the task and protected cases)
1165
1166 -- Has_Private_View (Flag11-Sem)
1167 -- A flag present in generic nodes that have an entity, to indicate that
1168 -- the node has a private type. Used to exchange private and full
1169 -- declarations if the visibility at instantiation is different from the
1170 -- visibility at generic definition.
1171
1172 -- Has_Relative_Deadline_Pragma (Flag9-Sem)
1173 -- A flag present in N_Subprogram_Body and N_Task_Definition nodes to
1174 -- flag the presence of a pragma Relative_Deadline.
1175
1176 -- Has_Self_Reference (Flag13-Sem)
1177 -- Present in N_Aggregate and N_Extension_Aggregate. Indicates that one
1178 -- of the expressions contains an access attribute reference to the
1179 -- enclosing type. Such a self-reference can only appear in default-
1180 -- initialized aggregate for a record type.
1181
1182 -- Has_Storage_Size_Pragma (Flag5-Sem)
1183 -- A flag present in an N_Task_Definition node to flag the presence of a
1184 -- Storage_Size pragma.
1185
1186 -- Has_Task_Info_Pragma (Flag7-Sem)
1187 -- A flag present in an N_Task_Definition node to flag the presence of a
1188 -- Task_Info pragma. Used to detect duplicate pragmas.
1189
1190 -- Has_Task_Name_Pragma (Flag8-Sem)
1191 -- A flag present in N_Task_Definition nodes to flag the presence of a
1192 -- Task_Name pragma in the declaration sequence for the task.
1193
1194 -- Has_Wide_Character (Flag11-Sem)
1195 -- Present in string literals, set if any wide character (i.e. character
1196 -- code outside the Character range but within Wide_Character range)
1197 -- appears in the string. Used to implement pragma preference rules.
1198
1199 -- Has_Wide_Wide_Character (Flag13-Sem)
1200 -- Present in string literals, set if any wide character (i.e. character
1201 -- code outside the Wide_Character range) appears in the string. Used to
1202 -- implement pragma preference rules.
1203
1204 -- Hidden_By_Use_Clause (Elist4-Sem)
1205 -- An entity list present in use clauses that appear within
1206 -- instantiations. For the resolution of local entities, entities
1207 -- introduced by these use clauses have priority over global ones, and
1208 -- outer entities must be explicitly hidden/restored on exit.
1209
1210 -- Implicit_With (Flag16-Sem)
1211 -- This flag is set in the N_With_Clause node that is implicitly
1212 -- generated for runtime units that are loaded by the expander, and also
1213 -- for package System, if it is loaded implicitly by a use of the
1214 -- 'Address or 'Tag attribute. ???There are other implicit with clauses
1215 -- as well.
1216
1217 -- Import_Interface_Present (Flag16-Sem)
1218 -- This flag is set in an Interface or Import pragma if a matching
1219 -- pragma of the other kind is also present. This is used to avoid
1220 -- generating some unwanted error messages.
1221
1222 -- Includes_Infinities (Flag11-Sem)
1223 -- This flag is present in N_Range nodes. It is set for the range of
1224 -- unconstrained float types defined in Standard, which include not only
1225 -- the given range of values, but also legitimately can include infinite
1226 -- values. This flag is false for any float type for which an explicit
1227 -- range is given by the programmer, even if that range is identical to
1228 -- the range for Float.
1229
1230 -- Inherited_Discriminant (Flag13-Sem)
1231 -- This flag is present in N_Component_Association nodes. It indicates
1232 -- that a given component association in an extension aggregate is the
1233 -- value obtained from a constraint on an ancestor. Used to prevent
1234 -- double expansion when the aggregate has expansion delayed.
1235
1236 -- Instance_Spec (Node5-Sem)
1237 -- This field is present in generic instantiation nodes, and also in
1238 -- formal package declaration nodes (formal package declarations are
1239 -- treated in a manner very similar to package instantiations). It points
1240 -- to the node for the spec of the instance, inserted as part of the
1241 -- semantic processing for instantiations in Sem_Ch12.
1242
1243 -- Is_Accessibility_Actual (Flag12-Sem)
1244 -- Present in N_Parameter_Association nodes. True if the parameter is
1245 -- an extra actual that carries the accessibility level of the actual
1246 -- for an access parameter, in a function that dispatches on result and
1247 -- is called in a dispatching context. Used to prevent a formal/actual
1248 -- mismatch when the call is rewritten as a dispatching call.
1249
1250 -- Is_Asynchronous_Call_Block (Flag7-Sem)
1251 -- A flag set in a Block_Statement node to indicate that it is the
1252 -- expansion of an asynchronous entry call. Such a block needs cleanup
1253 -- handler to assure that the call is cancelled.
1254
1255 -- Is_Component_Left_Opnd (Flag13-Sem)
1256 -- Is_Component_Right_Opnd (Flag14-Sem)
1257 -- Present in concatenation nodes, to indicate that the corresponding
1258 -- operand is of the component type of the result. Used in resolving
1259 -- concatenation nodes in instances.
1260
1261 -- Is_Delayed_Aspect (Flag14-Sem)
1262 -- Present in N_Pragma and N_Attribute_Definition_Clause nodes which
1263 -- come from aspect specifications, where the evaluation of the aspect
1264 -- must be delayed to the freeze point.
1265
1266 -- Is_Controlling_Actual (Flag16-Sem)
1267 -- This flag is set on in an expression that is a controlling argument in
1268 -- a dispatching call. It is off in all other cases. See Sem_Disp for
1269 -- details of its use.
1270
1271 -- Is_Dynamic_Coextension (Flag18-Sem)
1272 -- Present in allocator nodes, to indicate that this is an allocator
1273 -- for an access discriminant of a dynamically allocated object. The
1274 -- coextension must be deallocated and finalized at the same time as
1275 -- the enclosing object.
1276
1277 -- Is_Entry_Barrier_Function (Flag8-Sem)
1278 -- This flag is set in an N_Subprogram_Body node which is the expansion
1279 -- of an entry barrier from a protected entry body. It is used for the
1280 -- circuitry checking for incorrect use of Current_Task.
1281
1282 -- Is_Expanded_Build_In_Place_Call (Flag11-Sem)
1283 -- This flag is set in an N_Function_Call node to indicate that the extra
1284 -- actuals to support a build-in-place style of call have been added to
1285 -- the call.
1286
1287 -- Is_In_Discriminant_Check (Flag11-Sem)
1288 -- This flag is present in a selected component, and is used to indicate
1289 -- that the reference occurs within a discriminant check. The
1290 -- significance is that optimizations based on assuming that the
1291 -- discriminant check has a correct value cannot be performed in this
1292 -- case (or the discriminant check may be optimized away!)
1293
1294 -- Is_Machine_Number (Flag11-Sem)
1295 -- This flag is set in an N_Real_Literal node to indicate that the value
1296 -- is a machine number. This avoids some unnecessary cases of converting
1297 -- real literals to machine numbers.
1298
1299 -- Is_Null_Loop (Flag16-Sem)
1300 -- This flag is set in an N_Loop_Statement node if the corresponding loop
1301 -- can be determined to be null at compile time. This is used to remove
1302 -- the loop entirely at expansion time.
1303
1304 -- Is_Overloaded (Flag5-Sem)
1305 -- A flag present in all expression nodes. Used temporarily during
1306 -- overloading determination. The setting of this flag is not relevant
1307 -- once overloading analysis is complete.
1308
1309 -- Is_Power_Of_2_For_Shift (Flag13-Sem)
1310 -- A flag present only in N_Op_Expon nodes. It is set when the
1311 -- exponentiation is of the form 2 ** N, where the type of N is an
1312 -- unsigned integral subtype whose size does not exceed the size of
1313 -- Standard_Integer (i.e. a type that can be safely converted to
1314 -- Natural), and the exponentiation appears as the right operand of an
1315 -- integer multiplication or an integer division where the dividend is
1316 -- unsigned. It is also required that overflow checking is off for both
1317 -- the exponentiation and the multiply/divide node. If this set of
1318 -- conditions holds, and the flag is set, then the division or
1319 -- multiplication can be (and is) converted to a shift.
1320
1321 -- Is_Protected_Subprogram_Body (Flag7-Sem)
1322 -- A flag set in a Subprogram_Body block to indicate that it is the
1323 -- implementation of a protected subprogram. Such a body needs cleanup
1324 -- handler to make sure that the associated protected object is unlocked
1325 -- when the subprogram completes.
1326
1327 -- Is_Static_Coextension (Flag14-Sem)
1328 -- Present in N_Allocator nodes. Set if the allocator is a coextension
1329 -- of an object allocated on the stack rather than the heap.
1330
1331 -- Is_Static_Expression (Flag6-Sem)
1332 -- Indicates that an expression is a static expression (RM 4.9). See spec
1333 -- of package Sem_Eval for full details on the use of this flag.
1334
1335 -- Is_Subprogram_Descriptor (Flag16-Sem)
1336 -- Present in N_Object_Declaration, and set only for the object
1337 -- declaration generated for a subprogram descriptor in fast exception
1338 -- mode. See Exp_Ch11 for details of use.
1339
1340 -- Is_Task_Allocation_Block (Flag6-Sem)
1341 -- A flag set in a Block_Statement node to indicate that it is the
1342 -- expansion of a task allocator, or the allocator of an object
1343 -- containing tasks. Such a block requires a cleanup handler to call
1344 -- Expunge_Unactivated_Tasks to complete any tasks that have been
1345 -- allocated but not activated when the allocator completes abnormally.
1346
1347 -- Is_Task_Master (Flag5-Sem)
1348 -- A flag set in a Subprogram_Body, Block_Statement or Task_Body node to
1349 -- indicate that the construct is a task master (i.e. has declared tasks
1350 -- or declares an access to a task type).
1351
1352 -- Itype (Node1-Sem)
1353 -- Used in N_Itype_Reference node to reference an itype for which it is
1354 -- important to ensure that it is defined. See description of this node
1355 -- for further details.
1356
1357 -- Kill_Range_Check (Flag11-Sem)
1358 -- Used in an N_Unchecked_Type_Conversion node to indicate that the
1359 -- result should not be subjected to range checks. This is used for the
1360 -- implementation of Normalize_Scalars.
1361
1362 -- Label_Construct (Node2-Sem)
1363 -- Used in an N_Implicit_Label_Declaration node. Refers to an N_Label,
1364 -- N_Block_Statement or N_Loop_Statement node to which the label
1365 -- declaration applies. This is not currently used in the compiler
1366 -- itself, but it is useful in the implementation of ASIS queries.
1367 -- This field is left empty for the special labels generated as part
1368 -- of expanding raise statements with a local exception handler.
1369
1370 -- Library_Unit (Node4-Sem)
1371 -- In a stub node, Library_Unit points to the compilation unit node of
1372 -- the corresponding subunit.
1373 --
1374 -- In a with clause node, Library_Unit points to the spec of the with'ed
1375 -- unit.
1376 --
1377 -- In a compilation unit node, the usage depends on the unit type:
1378 --
1379 -- For a library unit body, Library_Unit points to the compilation unit
1380 -- node of the corresponding spec, unless it's a subprogram body with
1381 -- Acts_As_Spec set, in which case it points to itself.
1382 --
1383 -- For a spec, Library_Unit points to the compilation unit node of the
1384 -- corresponding body, if present. The body will be present if the spec
1385 -- is or contains generics that we needed to instantiate. Similarly, the
1386 -- body will be present if we needed it for inlining purposes. Thus, if
1387 -- we have a spec/body pair, both of which are present, they point to
1388 -- each other via Library_Unit.
1389 --
1390 -- For a subunit, Library_Unit points to the compilation unit node of
1391 -- the parent body.
1392 --
1393 -- Note that this field is not used to hold the parent pointer for child
1394 -- unit (which might in any case need to use it for some other purpose as
1395 -- described above). Instead for a child unit, implicit with's are
1396 -- generated for all parents.
1397
1398 -- Local_Raise_Statements (Elist1)
1399 -- This field is present in exception handler nodes. It is set to
1400 -- No_Elist in the normal case. If there is at least one raise statement
1401 -- which can potentially be handled as a local raise, then this field
1402 -- points to a list of raise nodes, which are calls to a routine to raise
1403 -- an exception. These are raise nodes which can be optimized into gotos
1404 -- if the handler turns out to meet the conditions which permit this
1405 -- transformation. Note that this does NOT include instances of the
1406 -- N_Raise_xxx_Error nodes since the transformation of these nodes is
1407 -- handled by the back end (using the N_Push/N_Pop mechanism).
1408
1409 -- Loop_Actions (List2-Sem)
1410 -- A list present in Component_Association nodes in array aggregates.
1411 -- Used to collect actions that must be executed within the loop because
1412 -- they may need to be evaluated anew each time through.
1413
1414 -- Limited_View_Installed (Flag18-Sem)
1415 -- Present in With_Clauses and in package specifications. If set on
1416 -- with_clause, it indicates that this clause has created the current
1417 -- limited view of the designated package. On a package specification, it
1418 -- indicates that the limited view has already been created because the
1419 -- package is mentioned in a limited_with_clause in the closure of the
1420 -- unit being compiled.
1421
1422 -- Local_Raise_Not_OK (Flag7-Sem)
1423 -- Present in N_Exception_Handler nodes. Set if the handler contains
1424 -- a construct (reraise statement, or call to subprogram in package
1425 -- GNAT.Current_Exception) that makes the handler unsuitable as a target
1426 -- for a local raise (one that could otherwise be converted to a goto).
1427
1428 -- Must_Be_Byte_Aligned (Flag14-Sem)
1429 -- This flag is present in N_Attribute_Reference nodes. It can be set
1430 -- only for the Address and Unrestricted_Access attributes. If set it
1431 -- means that the object for which the address/access is given must be on
1432 -- a byte (more accurately a storage unit) boundary. If necessary, a copy
1433 -- of the object is to be made before taking the address (this copy is in
1434 -- the current scope on the stack frame). This is used for certain cases
1435 -- of code generated by the expander that passes parameters by address.
1436 --
1437 -- The reason the copy is not made by the front end is that the back end
1438 -- has more information about type layout and may be able to (but is not
1439 -- guaranteed to) prevent making unnecessary copies.
1440
1441 -- Must_Not_Freeze (Flag8-Sem)
1442 -- A flag present in all expression nodes. Normally expressions cause
1443 -- freezing as described in the RM. If this flag is set, then this is
1444 -- inhibited. This is used by the analyzer and expander to label nodes
1445 -- that are created by semantic analysis or expansion and which must not
1446 -- cause freezing even though they normally would. This flag is also
1447 -- present in an N_Subtype_Indication node, since we also use these in
1448 -- calls to Freeze_Expression.
1449
1450 -- Next_Entity (Node2-Sem)
1451 -- Present in defining identifiers, defining character literals and
1452 -- defining operator symbols (i.e. in all entities). The entities of a
1453 -- scope are chained, and this field is used as the forward pointer for
1454 -- this list. See Einfo for further details.
1455
1456 -- Next_Exit_Statement (Node3-Sem)
1457 -- Present in N_Exit_Statement nodes. The exit statements for a loop are
1458 -- chained (in reverse order of appearence) from the First_Exit_Statement
1459 -- field of the E_Loop entity for the loop. Next_Exit_Statement points to
1460 -- the next entry on this chain (Empty = end of list).
1461
1462 -- Next_Implicit_With (Node3-Sem)
1463 -- Present in N_With_Clause. Part of a chain of with_clauses generated
1464 -- in rtsfind to indicate implicit dependencies on predefined units. Used
1465 -- to prevent multiple with_clauses for the same unit in a given context.
1466 -- A postorder traversal of the tree whose nodes are units and whose
1467 -- links are with_clauses defines the order in which Inspector must
1468 -- examine a compiled unit and its full context. This ordering ensures
1469 -- that any subprogram call is examined after the subprogram declartion
1470 -- has been seen.
1471
1472 -- Next_Named_Actual (Node4-Sem)
1473 -- Present in parameter association node. Set during semantic analysis to
1474 -- point to the next named parameter, where parameters are ordered by
1475 -- declaration order (as opposed to the actual order in the call, which
1476 -- may be different due to named associations). Not that this field
1477 -- points to the explicit actual parameter itself, not to the
1478 -- N_Parameter_Association node (its parent).
1479
1480 -- Next_Pragma (Node1-Sem)
1481 -- Present in N_Pragma nodes. Used to create a linked list of pragma
1482 -- nodes. Currently used for two purposes:
1483 --
1484 -- Create a list of linked Check_Policy pragmas. The head of this list
1485 -- is stored in Opt.Check_Policy_List (which has further details).
1486 --
1487 -- Used by processing for Pre/Postcondition pragmas to store a list of
1488 -- pragmas associated with the spec of a subprogram (see Sem_Prag for
1489 -- details).
1490
1491 -- Next_Rep_Item (Node5-Sem)
1492 -- Present in pragma nodes, attribute definition nodes, enumeration rep
1493 -- clauses, record rep clauses, aspect specification nodes. Used to link
1494 -- representation items that apply to an entity. See full description of
1495 -- First_Rep_Item field in Einfo for further details.
1496
1497 -- Next_Use_Clause (Node3-Sem)
1498 -- While use clauses are active during semantic processing, they are
1499 -- chained from the scope stack entry, using Next_Use_Clause as a link
1500 -- pointer, with Empty marking the end of the list. The head pointer is
1501 -- in the scope stack entry (First_Use_Clause). At the end of semantic
1502 -- processing (i.e. when Gigi sees the tree, the contents of this field
1503 -- is undefined and should not be read).
1504
1505 -- No_Ctrl_Actions (Flag7-Sem)
1506 -- Present in N_Assignment_Statement to indicate that no finalize nor
1507 -- adjust should take place on this assignment even though the rhs is
1508 -- controlled. This is used in init procs and aggregate expansions where
1509 -- the generated assignments are more initialisations than real
1510 -- assignments.
1511
1512 -- No_Elaboration_Check (Flag14-Sem)
1513 -- Present in N_Function_Call and N_Procedure_Call_Statement. Indicates
1514 -- that no elaboration check is needed on the call, because it appears in
1515 -- the context of a local Suppress pragma. This is used on calls within
1516 -- task bodies, where the actual elaboration checks are applied after
1517 -- analysis, when the local scope stack is not present.
1518
1519 -- No_Entities_Ref_In_Spec (Flag8-Sem)
1520 -- Present in N_With_Clause nodes. Set if the with clause is on the
1521 -- package or subprogram spec where the main unit is the corresponding
1522 -- body, and no entities of the with'ed unit are referenced by the spec
1523 -- (an entity may still be referenced in the body, so this flag is used
1524 -- to generate the proper message (see Sem_Util.Check_Unused_Withs for
1525 -- full details)
1526
1527 -- No_Initialization (Flag13-Sem)
1528 -- Present in N_Object_Declaration and N_Allocator to indicate that the
1529 -- object must not be initialized (by Initialize or call to an init
1530 -- proc). This is needed for controlled aggregates. When the Object
1531 -- declaration has an expression, this flag means that this expression
1532 -- should not be taken into account (needed for in place initialization
1533 -- with aggregates).
1534
1535 -- No_Truncation (Flag17-Sem)
1536 -- Present in N_Unchecked_Type_Conversion node. This flag has an effect
1537 -- only if the RM_Size of the source is greater than the RM_Size of the
1538 -- target for scalar operands. Normally in such a case we truncate some
1539 -- higher order bits of the source, and then sign/zero extend the result
1540 -- to form the output value. But if this flag is set, then we do not do
1541 -- any truncation, so for example, if an 8 bit input is converted to 5
1542 -- bit result which is in fact stored in 8 bits, then the high order
1543 -- three bits of the target result will be copied from the source. This
1544 -- is used for properly setting out of range values for use by pragmas
1545 -- Initialize_Scalars and Normalize_Scalars.
1546
1547 -- Original_Discriminant (Node2-Sem)
1548 -- Present in identifiers. Used in references to discriminants that
1549 -- appear in generic units. Because the names of the discriminants may be
1550 -- different in an instance, we use this field to recover the position of
1551 -- the discriminant in the original type, and replace it with the
1552 -- discriminant at the same position in the instantiated type.
1553
1554 -- Original_Entity (Node2-Sem)
1555 -- Present in numeric literals. Used to denote the named number that has
1556 -- been constant-folded into the given literal. If literal is from
1557 -- source, or the result of some other constant-folding operation, then
1558 -- Original_Entity is empty. This field is needed to handle properly
1559 -- named numbers in generic units, where the Associated_Node field
1560 -- interferes with the Entity field, making it impossible to preserve the
1561 -- original entity at the point of instantiation (ASIS problem).
1562
1563 -- Others_Discrete_Choices (List1-Sem)
1564 -- When a case statement or variant is analyzed, the semantic checks
1565 -- determine the actual list of choices that correspond to an others
1566 -- choice. This list is materialized for later use by the expander and
1567 -- the Others_Discrete_Choices field of an N_Others_Choice node points to
1568 -- this materialized list of choices, which is in standard format for a
1569 -- list of discrete choices, except that of course it cannot contain an
1570 -- N_Others_Choice entry.
1571
1572 -- Parameter_List_Truncated (Flag17-Sem)
1573 -- Present in N_Function_Call and N_Procedure_Call_Statement nodes. Set
1574 -- (for OpenVMS ports of GNAT only) if the parameter list is truncated as
1575 -- a result of a First_Optional_Parameter specification in an
1576 -- Import_Function, Import_Procedure, or Import_Valued_Procedure pragma.
1577 -- The truncation is done by the expander by removing trailing parameters
1578 -- from the argument list, in accordance with the set of rules allowing
1579 -- such parameter removal. In particular, parameters can be removed
1580 -- working from the end of the parameter list backwards up to and
1581 -- including the entry designated by First_Optional_Parameter in the
1582 -- Import pragma. Parameters can be removed if they are implicit and the
1583 -- default value is a known-at-compile-time value, including the use of
1584 -- the Null_Parameter attribute, or if explicit parameter values are
1585 -- present that match the corresponding defaults.
1586
1587 -- Parent_Spec (Node4-Sem)
1588 -- For a library unit that is a child unit spec (package or subprogram
1589 -- declaration, generic declaration or instantiation, or library level
1590 -- rename, this field points to the compilation unit node for the parent
1591 -- package specification. This field is Empty for library bodies (the
1592 -- parent spec in this case can be found from the corresponding spec).
1593
1594 -- Pragma_Enabled (Flag5-Sem)
1595 -- Present in N_Pragma nodes. This flag is relevant only for pragmas
1596 -- Assert, Check, Precondition, and Postcondition. It is true if the
1597 -- check corresponding to the pragma type is enabled at the point where
1598 -- the pragma appears.
1599
1600 -- Present_Expr (Uint3-Sem)
1601 -- Present in an N_Variant node. This has a meaningful value only after
1602 -- Gigi has back annotated the tree with representation information. At
1603 -- this point, it contains a reference to a gcc expression that depends
1604 -- on the values of one or more discriminants. Give a set of discriminant
1605 -- values, this expression evaluates to False (zero) if variant is not
1606 -- present, and True (non-zero) if it is present. See unit Repinfo for
1607 -- further details on gigi back annotation. This field is used during
1608 -- ASIS processing (data decomposition annex) to determine if a field is
1609 -- present or not.
1610
1611 -- Print_In_Hex (Flag13-Sem)
1612 -- Set on an N_Integer_Literal node to indicate that the value should be
1613 -- printed in hexadecimal in the sprint listing. Has no effect on
1614 -- legality or semantics of program, only on the displayed output. This
1615 -- is used to clarify output from the packed array cases.
1616
1617 -- Procedure_To_Call (Node2-Sem)
1618 -- Present in N_Allocator, N_Free_Statement, N_Simple_Return_Statement,
1619 -- and N_Extended_Return_Statement nodes. References the entity for the
1620 -- declaration of the procedure to be called to accomplish the required
1621 -- operation (i.e. for the Allocate procedure in the case of N_Allocator
1622 -- and N_Simple_Return_Statement and N_Extended_Return_Statement (for
1623 -- allocating the return value), and for the Deallocate procedure in the
1624 -- case of N_Free_Statement.
1625
1626 -- Raises_Constraint_Error (Flag7-Sem)
1627 -- Set on an expression whose evaluation will definitely fail constraint
1628 -- error check. In the case of static expressions, this flag must be set
1629 -- accurately (and if it is set, the expression is typically illegal
1630 -- unless it appears as a non-elaborated branch of a short-circuit form).
1631 -- For a non-static expression, this flag may be set whenever an
1632 -- expression (e.g. an aggregate) is known to raise constraint error. If
1633 -- set, the expression definitely will raise CE if elaborated at runtime.
1634 -- If not set, the expression may or may not raise CE. In other words, on
1635 -- static expressions, the flag is set accurately, on non-static
1636 -- expressions it is set conservatively.
1637
1638 -- Redundant_Use (Flag13-Sem)
1639 -- Present in nodes that can appear as an operand in a use clause or use
1640 -- type clause (identifiers, expanded names, attribute references). Set
1641 -- to indicate that a use is redundant (and therefore need not be undone
1642 -- on scope exit).
1643
1644 -- Renaming_Exception (Node2-Sem)
1645 -- Present in N_Exception_Declaration node. Used to point back to the
1646 -- exception renaming for an exception declared within a subprogram.
1647 -- What happens is that an exception declared in a subprogram is moved
1648 -- to the library level with a unique name, and the original exception
1649 -- becomes a renaming. This link from the library level exception to the
1650 -- renaming declaration allows registering of the proper exception name.
1651
1652 -- Return_Statement_Entity (Node5-Sem)
1653 -- Present in N_Simple_Return_Statement and N_Extended_Return_Statement.
1654 -- Points to an E_Return_Statement representing the return statement.
1655
1656 -- Return_Object_Declarations (List3)
1657 -- Present in N_Extended_Return_Statement.
1658 -- Points to a list initially containing a single
1659 -- N_Object_Declaration representing the return object.
1660 -- We use a list (instead of just a pointer to the object decl)
1661 -- because Analyze wants to insert extra actions on this list.
1662
1663 -- Rounded_Result (Flag18-Sem)
1664 -- Present in N_Type_Conversion, N_Op_Divide and N_Op_Multiply nodes.
1665 -- Used in the fixed-point cases to indicate that the result must be
1666 -- rounded as a result of the use of the 'Round attribute. Also used for
1667 -- integer N_Op_Divide nodes to indicate that the result should be
1668 -- rounded to the nearest integer (breaking ties away from zero), rather
1669 -- than truncated towards zero as usual. These rounded integer operations
1670 -- are the result of expansion of rounded fixed-point divide, conversion
1671 -- and multiplication operations.
1672
1673 -- SCIL_Entity (Node4-Sem)
1674 -- Present in SCIL nodes. Used to reference the tagged type associated
1675 -- with the SCIL node.
1676
1677 -- SCIL_Controlling_Tag (Node5-Sem)
1678 -- Present in N_SCIL_Dispatching_Call nodes. Used to reference the
1679 -- controlling tag of a dispatching call.
1680
1681 -- SCIL_Tag_Value (Node5-Sem)
1682 -- Present in N_SCIL_Membership_Test nodes. Used to reference the tag
1683 -- value that is being tested.
1684
1685 -- SCIL_Target_Prim (Node2-Sem)
1686 -- Present in N_SCIL_Dispatching_Call nodes. Used to reference the tagged
1687 -- type primitive associated with the SCIL node.
1688
1689 -- Scope (Node3-Sem)
1690 -- Present in defining identifiers, defining character literals and
1691 -- defining operator symbols (i.e. in all entities). The entities of a
1692 -- scope all use this field to reference the corresponding scope entity.
1693 -- See Einfo for further details.
1694
1695 -- Shift_Count_OK (Flag4-Sem)
1696 -- A flag present in shift nodes to indicate that the shift count is
1697 -- known to be in range, i.e. is in the range from zero to word length
1698 -- minus one. If this flag is not set, then the shift count may be
1699 -- outside this range, i.e. larger than the word length, and the code
1700 -- must ensure that such shift counts give the appropriate result.
1701
1702 -- Source_Type (Node1-Sem)
1703 -- Used in an N_Validate_Unchecked_Conversion node to point to the
1704 -- source type entity for the unchecked conversion instantiation
1705 -- which gigi must do size validation for.
1706
1707 -- Split_PPC (Flag17)
1708 -- When a Pre or Postaspect specification is processed, it is broken
1709 -- into AND THEN sections. The left most section has Split_PPC set to
1710 -- False, indicating that it is the original specification (e.g. for
1711 -- posting errors). For other sections, Split_PPC is set to True.
1712 -- This flag is set in both the N_Aspect_Specification node itself,
1713 -- and in the pragma which is generated from this node.
1714
1715 -- Static_Processing_OK (Flag4-Sem)
1716 -- Present in N_Aggregate nodes. When the Compile_Time_Known_Aggregate
1717 -- flag is set, the full value of the aggregate can be determined at
1718 -- compile time and the aggregate can be passed as is to the back-end.
1719 -- In this event it is irrelevant whether this flag is set or not.
1720 -- However, if the flag Compile_Time_Known_Aggregate is not set but
1721 -- Static_Processing_OK is set, the aggregate can (but need not) be
1722 -- converted into a compile time known aggregate by the expander. See
1723 -- Sem_Aggr for the specific conditions under which an aggregate has its
1724 -- Static_Processing_OK flag set.
1725
1726 -- Storage_Pool (Node1-Sem)
1727 -- Present in N_Allocator, N_Free_Statement, N_Simple_Return_Statement,
1728 -- and N_Extended_Return_Statement nodes. References the entity for the
1729 -- storage pool to be used for the allocate or free call or for the
1730 -- allocation of the returned value from function. Empty indicates that
1731 -- the global default pool is to be used. Note that in the case
1732 -- of a return statement, this field is set only if the function returns
1733 -- value of a type whose size is not known at compile time on the
1734 -- secondary stack.
1735
1736 -- Suppress_Assignment_Checks (Flag18-Sem)
1737 -- Used in genererated N_Assignment_Statement nodes to suppress predicate
1738 -- and range checks in cases where the generated code knows that the
1739 -- value being assigned is in range and satisifies any predicate. Also
1740 -- can be set in N_Object_Declaration nodes, to similarly suppress any
1741 -- checks on the initializing value.
1742
1743 -- Suppress_Loop_Warnings (Flag17-Sem)
1744 -- Used in N_Loop_Statement node to indicate that warnings within the
1745 -- body of the loop should be suppressed. This is set when the range
1746 -- of a FOR loop is known to be null, or is probably null (loop would
1747 -- only execute if invalid values are present).
1748
1749 -- Target_Type (Node2-Sem)
1750 -- Used in an N_Validate_Unchecked_Conversion node to point to the target
1751 -- type entity for the unchecked conversion instantiation which gigi must
1752 -- do size validation for.
1753
1754 -- Then_Actions (List3-Sem)
1755 -- This field is present in conditional expression nodes. During code
1756 -- expansion we use the Insert_Actions procedure (in Exp_Util) to insert
1757 -- actions at an appropriate place in the tree to get elaborated at the
1758 -- right time. For conditional expressions, we have to be sure that the
1759 -- actions for the Then branch are only elaborated if the condition is
1760 -- True. The Then_Actions field is used as a temporary parking place for
1761 -- these actions. The final tree is always rewritten to eliminate the
1762 -- need for this field, so in the tree passed to Gigi, this field is
1763 -- always set to No_List.
1764
1765 -- Treat_Fixed_As_Integer (Flag14-Sem)
1766 -- This flag appears in operator nodes for divide, multiply, mod and rem
1767 -- on fixed-point operands. It indicates that the operands are to be
1768 -- treated as integer values, ignoring small values. This flag is only
1769 -- set as a result of expansion of fixed-point operations. Typically a
1770 -- fixed-point multiplication in the source generates subsidiary
1771 -- multiplication and division operations that work with the underlying
1772 -- integer values and have this flag set. Note that this flag is not
1773 -- needed on other arithmetic operations (add, neg, subtract etc.) since
1774 -- in these cases it is always the case that fixed is treated as integer.
1775 -- The Etype field MUST be set if this flag is set. The analyzer knows to
1776 -- leave such nodes alone, and whoever makes them must set the correct
1777 -- Etype value.
1778
1779 -- TSS_Elist (Elist3-Sem)
1780 -- Present in N_Freeze_Entity nodes. Holds an element list containing
1781 -- entries for each TSS (type support subprogram) associated with the
1782 -- frozen type. The elements of the list are the entities for the
1783 -- subprograms (see package Exp_TSS for further details). Set to No_Elist
1784 -- if there are no type support subprograms for the type or if the freeze
1785 -- node is not for a type.
1786
1787 -- Unreferenced_In_Spec (Flag7-Sem)
1788 -- Present in N_With_Clause nodes. Set if the with clause is on the
1789 -- package or subprogram spec where the main unit is the corresponding
1790 -- body, and is not referenced by the spec (it may still be referenced by
1791 -- the body, so this flag is used to generate the proper message (see
1792 -- Sem_Util.Check_Unused_Withs for details)
1793
1794 -- Was_Originally_Stub (Flag13-Sem)
1795 -- This flag is set in the node for a proper body that replaces stub.
1796 -- During the analysis procedure, stubs in some situations get rewritten
1797 -- by the corresponding bodies, and we set this flag to remember that
1798 -- this happened. Note that it is not good enough to rely on the use of
1799 -- Original_Node here because of the case of nested instantiations where
1800 -- the substituted node can be copied.
1801
1802 -- Withed_Body (Node1-Sem)
1803 -- Present in N_With_Clause nodes. Set if the unit in whose context
1804 -- the with_clause appears instantiates a generic contained in the
1805 -- library unit of the with_clause and as a result loads its body.
1806 -- Used for a more precise unit traversal for CodePeer.
1807
1808 -- Zero_Cost_Handling (Flag5-Sem)
1809 -- This flag is set in all handled sequence of statement and exception
1810 -- handler nodes if exceptions are to be handled using the zero-cost
1811 -- mechanism (see Ada.Exceptions and System.Exceptions in files
1812 -- a-except.ads/adb and s-except.ads for full details). What gigi needs
1813 -- to do for such a handler is simply to put the code in the handler
1814 -- somewhere. The front end has generated all necessary labels.
1815
1816 --------------------------------------------------
1817 -- Note on Use of End_Label and End_Span Fields --
1818 --------------------------------------------------
1819
1820 -- Several constructs have end lines:
1821
1822 -- Loop Statement end loop [loop_IDENTIFIER];
1823 -- Package Specification end [[PARENT_UNIT_NAME .] IDENTIFIER]
1824 -- Task Definition end [task_IDENTIFIER]
1825 -- Protected Definition end [protected_IDENTIFIER]
1826 -- Protected Body end [protected_IDENTIFIER]
1827
1828 -- Block Statement end [block_IDENTIFIER];
1829 -- Subprogram Body end [DESIGNATOR];
1830 -- Package Body end [[PARENT_UNIT_NAME .] IDENTIFIER];
1831 -- Task Body end [task_IDENTIFIER];
1832 -- Accept Statement end [entry_IDENTIFIER]];
1833 -- Entry Body end [entry_IDENTIFIER];
1834
1835 -- If Statement end if;
1836 -- Case Statement end case;
1837
1838 -- Record Definition end record;
1839 -- Enumeration Definition );
1840
1841 -- The End_Label and End_Span fields are used to mark the locations of
1842 -- these lines, and also keep track of the label in the case where a label
1843 -- is present.
1844
1845 -- For the first group above, the End_Label field of the corresponding node
1846 -- is used to point to the label identifier. In the case where there is no
1847 -- label in the source, the parser supplies a dummy identifier (with
1848 -- Comes_From_Source set to False), and the Sloc of this dummy identifier
1849 -- marks the location of the token following the END token.
1850
1851 -- For the second group, the use of End_Label is similar, but the End_Label
1852 -- is found in the N_Handled_Sequence_Of_Statements node. This is done
1853 -- simply because in some cases there is no room in the parent node.
1854
1855 -- For the third group, there is never any label, and instead of using
1856 -- End_Label, we use the End_Span field which gives the location of the
1857 -- token following END, relative to the starting Sloc of the construct,
1858 -- i.e. add Sloc (Node) + End_Span (Node) to get the Sloc of the IF or CASE
1859 -- following the End_Label.
1860
1861 -- The record definition case is handled specially, we treat it as though
1862 -- it required an optional label which is never present, and so the parser
1863 -- always builds a dummy identifier with Comes From Source set False. The
1864 -- reason we do this, rather than using End_Span in this case, is that we
1865 -- want to generate a cross-ref entry for the end of a record, since it
1866 -- represents a scope for name declaration purposes.
1867
1868 -- The enumeration definition case is handled in an exactly similar manner,
1869 -- building a dummy identifier to get a cross-reference.
1870
1871 -- Note: the reason we store the difference as a Uint, instead of storing
1872 -- the Source_Ptr value directly, is that Source_Ptr values cannot be
1873 -- distinguished from other types of values, and we count on all general
1874 -- use fields being self describing. To make things easier for clients,
1875 -- note that we provide function End_Location, and procedure
1876 -- Set_End_Location to allow access to the logical value (which is the
1877 -- Source_Ptr value for the end token).
1878
1879 ---------------------
1880 -- Syntactic Nodes --
1881 ---------------------
1882
1883 ---------------------
1884 -- 2.3 Identifier --
1885 ---------------------
1886
1887 -- IDENTIFIER ::= IDENTIFIER_LETTER {[UNDERLINE] LETTER_OR_DIGIT}
1888 -- LETTER_OR_DIGIT ::= IDENTIFIER_LETTER | DIGIT
1889
1890 -- An IDENTIFIER shall not be a reserved word
1891
1892 -- In the Ada grammar identifiers are the bottom level tokens which have
1893 -- very few semantics. Actual program identifiers are direct names. If
1894 -- we were being 100% honest with the grammar, then we would have a node
1895 -- called N_Direct_Name which would point to an identifier. However,
1896 -- that's too many extra nodes, so we just use the N_Identifier node
1897 -- directly as a direct name, and it contains the expression fields and
1898 -- Entity field that correspond to its use as a direct name. In those
1899 -- few cases where identifiers appear in contexts where they are not
1900 -- direct names (pragmas, pragma argument associations, attribute
1901 -- references and attribute definition clauses), the Chars field of the
1902 -- node contains the Name_Id for the identifier name.
1903
1904 -- Note: in GNAT, a reserved word can be treated as an identifier in two
1905 -- cases. First, an incorrect use of a reserved word as an identifier is
1906 -- diagnosed and then treated as a normal identifier. Second, an
1907 -- attribute designator of the form of a reserved word (access, delta,
1908 -- digits, range) is treated as an identifier.
1909
1910 -- Note: The set of letters that is permitted in an identifier depends
1911 -- on the character set in use. See package Csets for full details.
1912
1913 -- N_Identifier
1914 -- Sloc points to identifier
1915 -- Chars (Name1) contains the Name_Id for the identifier
1916 -- Entity (Node4-Sem)
1917 -- Associated_Node (Node4-Sem)
1918 -- Original_Discriminant (Node2-Sem)
1919 -- Redundant_Use (Flag13-Sem)
1920 -- Has_Private_View (Flag11-Sem) (set in generic units)
1921 -- plus fields for expression
1922
1923 --------------------------
1924 -- 2.4 Numeric Literal --
1925 --------------------------
1926
1927 -- NUMERIC_LITERAL ::= DECIMAL_LITERAL | BASED_LITERAL
1928
1929 ----------------------------
1930 -- 2.4.1 Decimal Literal --
1931 ----------------------------
1932
1933 -- DECIMAL_LITERAL ::= NUMERAL [.NUMERAL] [EXPONENT]
1934
1935 -- NUMERAL ::= DIGIT {[UNDERLINE] DIGIT}
1936
1937 -- EXPONENT ::= E [+] NUMERAL | E - NUMERAL
1938
1939 -- Decimal literals appear in the tree as either integer literal nodes
1940 -- or real literal nodes, depending on whether a period is present.
1941
1942 -- Note: literal nodes appear as a result of direct use of literals
1943 -- in the source program, and also as the result of evaluating
1944 -- expressions at compile time. In the latter case, it is possible
1945 -- to construct real literals that have no syntactic representation
1946 -- using the standard literal format. Such literals are listed by
1947 -- Sprint using the notation [numerator / denominator].
1948
1949 -- Note: the value of an integer literal node created by the front end
1950 -- is never outside the range of values of the base type. However, it
1951 -- can be the case that the created value is outside the range of the
1952 -- particular subtype. This happens in the case of integer overflows
1953 -- with checks suppressed.
1954
1955 -- N_Integer_Literal
1956 -- Sloc points to literal
1957 -- Original_Entity (Node2-Sem) If not Empty, holds Named_Number that
1958 -- has been constant-folded into its literal value.
1959 -- Intval (Uint3) contains integer value of literal
1960 -- plus fields for expression
1961 -- Print_In_Hex (Flag13-Sem)
1962
1963 -- N_Real_Literal
1964 -- Sloc points to literal
1965 -- Original_Entity (Node2-Sem) If not Empty, holds Named_Number that
1966 -- has been constant-folded into its literal value.
1967 -- Realval (Ureal3) contains real value of literal
1968 -- Corresponding_Integer_Value (Uint4-Sem)
1969 -- Is_Machine_Number (Flag11-Sem)
1970 -- plus fields for expression
1971
1972 --------------------------
1973 -- 2.4.2 Based Literal --
1974 --------------------------
1975
1976 -- BASED_LITERAL ::=
1977 -- BASE # BASED_NUMERAL [.BASED_NUMERAL] # [EXPONENT]
1978
1979 -- BASE ::= NUMERAL
1980
1981 -- BASED_NUMERAL ::=
1982 -- EXTENDED_DIGIT {[UNDERLINE] EXTENDED_DIGIT}
1983
1984 -- EXTENDED_DIGIT ::= DIGIT | A | B | C | D | E | F
1985
1986 -- Based literals appear in the tree as either integer literal nodes
1987 -- or real literal nodes, depending on whether a period is present.
1988
1989 ----------------------------
1990 -- 2.5 Character Literal --
1991 ----------------------------
1992
1993 -- CHARACTER_LITERAL ::= ' GRAPHIC_CHARACTER '
1994
1995 -- N_Character_Literal
1996 -- Sloc points to literal
1997 -- Chars (Name1) contains the Name_Id for the identifier
1998 -- Char_Literal_Value (Uint2) contains the literal value
1999 -- Entity (Node4-Sem)
2000 -- Associated_Node (Node4-Sem)
2001 -- Has_Private_View (Flag11-Sem) set in generic units.
2002 -- plus fields for expression
2003
2004 -- Note: the Entity field will be missing (set to Empty) for character
2005 -- literals whose type is Standard.Wide_Character or Standard.Character
2006 -- or a type derived from one of these two. In this case the character
2007 -- literal stands for its own coding. The reason we take this irregular
2008 -- short cut is to avoid the need to build lots of junk defining
2009 -- character literal nodes.
2010
2011 -------------------------
2012 -- 2.6 String Literal --
2013 -------------------------
2014
2015 -- STRING LITERAL ::= "{STRING_ELEMENT}"
2016
2017 -- A STRING_ELEMENT is either a pair of quotation marks ("), or a
2018 -- single GRAPHIC_CHARACTER other than a quotation mark.
2019 --
2020 -- Is_Folded_In_Parser is True if the parser created this literal by
2021 -- folding a sequence of "&" operators. For example, if the source code
2022 -- says "aaa" & "bbb" & "ccc", and this produces "aaabbbccc", the flag
2023 -- is set. This flag is needed because the parser doesn't know about
2024 -- visibility, so the folded result might be wrong, and semantic
2025 -- analysis needs to check for that.
2026
2027 -- N_String_Literal
2028 -- Sloc points to literal
2029 -- Strval (Str3) contains Id of string value
2030 -- Has_Wide_Character (Flag11-Sem)
2031 -- Has_Wide_Wide_Character (Flag13-Sem)
2032 -- Is_Folded_In_Parser (Flag4)
2033 -- plus fields for expression
2034
2035 ------------------
2036 -- 2.7 Comment --
2037 ------------------
2038
2039 -- A COMMENT starts with two adjacent hyphens and extends up to the
2040 -- end of the line. A COMMENT may appear on any line of a program.
2041
2042 -- Comments are skipped by the scanner and do not appear in the tree.
2043 -- It is possible to reconstruct the position of comments with respect
2044 -- to the elements of the tree by using the source position (Sloc)
2045 -- pointers that appear in every tree node.
2046
2047 -----------------
2048 -- 2.8 Pragma --
2049 -----------------
2050
2051 -- PRAGMA ::= pragma IDENTIFIER
2052 -- [(PRAGMA_ARGUMENT_ASSOCIATION {, PRAGMA_ARGUMENT_ASSOCIATION})];
2053
2054 -- Note that a pragma may appear in the tree anywhere a declaration
2055 -- or a statement may appear, as well as in some other situations
2056 -- which are explicitly documented.
2057
2058 -- N_Pragma
2059 -- Sloc points to PRAGMA
2060 -- Next_Pragma (Node1-Sem)
2061 -- Pragma_Argument_Associations (List2) (set to No_List if none)
2062 -- Debug_Statement (Node3) (set to Empty if not Debug)
2063 -- Pragma_Identifier (Node4)
2064 -- Next_Rep_Item (Node5-Sem)
2065 -- Pragma_Enabled (Flag5-Sem)
2066 -- From_Aspect_Specification (Flag13-Sem)
2067 -- Is_Delayed_Aspect (Flag14-Sem)
2068 -- Import_Interface_Present (Flag16-Sem)
2069 -- Aspect_Cancel (Flag11-Sem)
2070 -- Split_PPC (Flag17) set if corresponding aspect had Split_PPC set
2071 -- Class_Present (Flag6) set if from Aspect with 'Class
2072
2073 -- Note: we should have a section on what pragmas are passed on to
2074 -- the back end to be processed. This section should note that pragma
2075 -- Psect_Object is always converted to Common_Object, but there are
2076 -- undoubtedly many other similar notes required ???
2077
2078 -- Note: a utility function Pragma_Name may be applied to pragma nodes
2079 -- to conveniently obtain the Chars field of the Pragma_Identifier.
2080
2081 -- Note: if From_Aspect_Specification is set, then Sloc points to the
2082 -- aspect name, as does the Pragma_Identifier. In this case if the
2083 -- pragma has a local name argument (such as pragma Inline), it is
2084 -- resolved to point to the specific entity affected by the pragma.
2085
2086 --------------------------------------
2087 -- 2.8 Pragma Argument Association --
2088 --------------------------------------
2089
2090 -- PRAGMA_ARGUMENT_ASSOCIATION ::=
2091 -- [pragma_argument_IDENTIFIER =>] NAME
2092 -- | [pragma_argument_IDENTIFIER =>] EXPRESSION
2093
2094 -- N_Pragma_Argument_Association
2095 -- Sloc points to first token in association
2096 -- Chars (Name1) (set to No_Name if no pragma argument identifier)
2097 -- Expression (Node3)
2098
2099 ------------------------
2100 -- 2.9 Reserved Word --
2101 ------------------------
2102
2103 -- Reserved words are parsed by the scanner, and returned as the
2104 -- corresponding token types (e.g. PACKAGE is returned as Tok_Package)
2105
2106 ----------------------------
2107 -- 3.1 Basic Declaration --
2108 ----------------------------
2109
2110 -- BASIC_DECLARATION ::=
2111 -- TYPE_DECLARATION | SUBTYPE_DECLARATION
2112 -- | OBJECT_DECLARATION | NUMBER_DECLARATION
2113 -- | SUBPROGRAM_DECLARATION | ABSTRACT_SUBPROGRAM_DECLARATION
2114 -- | PACKAGE_DECLARATION | RENAMING_DECLARATION
2115 -- | EXCEPTION_DECLARATION | GENERIC_DECLARATION
2116 -- | GENERIC_INSTANTIATION
2117
2118 -- Basic declaration also includes IMPLICIT_LABEL_DECLARATION
2119 -- see further description in section on semantic nodes.
2120
2121 -- Also, in the tree that is constructed, a pragma may appear
2122 -- anywhere that a declaration may appear.
2123
2124 ------------------------------
2125 -- 3.1 Defining Identifier --
2126 ------------------------------
2127
2128 -- DEFINING_IDENTIFIER ::= IDENTIFIER
2129
2130 -- A defining identifier is an entity, which has additional fields
2131 -- depending on the setting of the Ekind field. These additional
2132 -- fields are defined (and access subprograms declared) in package
2133 -- Einfo.
2134
2135 -- Note: N_Defining_Identifier is an extended node whose fields are
2136 -- deliberate layed out to match the layout of fields in an ordinary
2137 -- N_Identifier node allowing for easy alteration of an identifier
2138 -- node into a defining identifier node. For details, see procedure
2139 -- Sinfo.CN.Change_Identifier_To_Defining_Identifier.
2140
2141 -- N_Defining_Identifier
2142 -- Sloc points to identifier
2143 -- Chars (Name1) contains the Name_Id for the identifier
2144 -- Next_Entity (Node2-Sem)
2145 -- Scope (Node3-Sem)
2146 -- Etype (Node5-Sem)
2147
2148 -----------------------------
2149 -- 3.2.1 Type Declaration --
2150 -----------------------------
2151
2152 -- TYPE_DECLARATION ::=
2153 -- FULL_TYPE_DECLARATION
2154 -- | INCOMPLETE_TYPE_DECLARATION
2155 -- | PRIVATE_TYPE_DECLARATION
2156 -- | PRIVATE_EXTENSION_DECLARATION
2157
2158 ----------------------------------
2159 -- 3.2.1 Full Type Declaration --
2160 ----------------------------------
2161
2162 -- FULL_TYPE_DECLARATION ::=
2163 -- type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
2164 -- is TYPE_DEFINITION
2165 -- [ASPECT_SPECIFICATIONS];
2166
2167 -- | TASK_TYPE_DECLARATION
2168 -- | PROTECTED_TYPE_DECLARATION
2169
2170 -- The full type declaration node is used only for the first case. The
2171 -- second case (concurrent type declaration), is represented directly
2172 -- by a task type declaration or a protected type declaration.
2173
2174 -- N_Full_Type_Declaration
2175 -- Sloc points to TYPE
2176 -- Defining_Identifier (Node1)
2177 -- Discriminant_Specifications (List4) (set to No_List if none)
2178 -- Type_Definition (Node3)
2179 -- Discr_Check_Funcs_Built (Flag11-Sem)
2180
2181 ----------------------------
2182 -- 3.2.1 Type Definition --
2183 ----------------------------
2184
2185 -- TYPE_DEFINITION ::=
2186 -- ENUMERATION_TYPE_DEFINITION | INTEGER_TYPE_DEFINITION
2187 -- | REAL_TYPE_DEFINITION | ARRAY_TYPE_DEFINITION
2188 -- | RECORD_TYPE_DEFINITION | ACCESS_TYPE_DEFINITION
2189 -- | DERIVED_TYPE_DEFINITION | INTERFACE_TYPE_DEFINITION
2190
2191 --------------------------------
2192 -- 3.2.2 Subtype Declaration --
2193 --------------------------------
2194
2195 -- SUBTYPE_DECLARATION ::=
2196 -- subtype DEFINING_IDENTIFIER is [NULL_EXCLUSION] SUBTYPE_INDICATION;
2197
2198 -- The subtype indication field is set to Empty for subtypes
2199 -- declared in package Standard (Positive, Natural).
2200
2201 -- N_Subtype_Declaration
2202 -- Sloc points to SUBTYPE
2203 -- Defining_Identifier (Node1)
2204 -- Null_Exclusion_Present (Flag11)
2205 -- Subtype_Indication (Node5)
2206 -- Generic_Parent_Type (Node4-Sem) (set for an actual derived type).
2207 -- Exception_Junk (Flag8-Sem)
2208
2209 -------------------------------
2210 -- 3.2.2 Subtype Indication --
2211 -------------------------------
2212
2213 -- SUBTYPE_INDICATION ::= SUBTYPE_MARK [CONSTRAINT]
2214
2215 -- Note: if no constraint is present, the subtype indication appears
2216 -- directly in the tree as a subtype mark. The N_Subtype_Indication
2217 -- node is used only if a constraint is present.
2218
2219 -- Note: [For Ada 2005 (AI-231)]: Because Ada 2005 extends this rule
2220 -- with the null-exclusion part (see AI-231), we had to introduce a new
2221 -- attribute in all the parents of subtype_indication nodes to indicate
2222 -- if the null-exclusion is present.
2223
2224 -- Note: the reason that this node has expression fields is that a
2225 -- subtype indication can appear as an operand of a membership test.
2226
2227 -- N_Subtype_Indication
2228 -- Sloc points to first token of subtype mark
2229 -- Subtype_Mark (Node4)
2230 -- Constraint (Node3)
2231 -- Etype (Node5-Sem)
2232 -- Must_Not_Freeze (Flag8-Sem)
2233
2234 -- Note: Etype is a copy of the Etype field of the Subtype_Mark. The
2235 -- reason for this redundancy is so that in a list of array index types,
2236 -- the Etype can be uniformly accessed to determine the subscript type.
2237 -- This means that no Itype is constructed for the actual subtype that
2238 -- is created by the subtype indication. If such an Itype is required,
2239 -- it is constructed in the context in which the indication appears.
2240
2241 -------------------------
2242 -- 3.2.2 Subtype Mark --
2243 -------------------------
2244
2245 -- SUBTYPE_MARK ::= subtype_NAME
2246
2247 -----------------------
2248 -- 3.2.2 Constraint --
2249 -----------------------
2250
2251 -- CONSTRAINT ::= SCALAR_CONSTRAINT | COMPOSITE_CONSTRAINT
2252
2253 ------------------------------
2254 -- 3.2.2 Scalar Constraint --
2255 ------------------------------
2256
2257 -- SCALAR_CONSTRAINT ::=
2258 -- RANGE_CONSTRAINT | DIGITS_CONSTRAINT | DELTA_CONSTRAINT
2259
2260 ---------------------------------
2261 -- 3.2.2 Composite Constraint --
2262 ---------------------------------
2263
2264 -- COMPOSITE_CONSTRAINT ::=
2265 -- INDEX_CONSTRAINT | DISCRIMINANT_CONSTRAINT
2266
2267 -------------------------------
2268 -- 3.3.1 Object Declaration --
2269 -------------------------------
2270
2271 -- OBJECT_DECLARATION ::=
2272 -- DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2273 -- [NULL_EXCLUSION] SUBTYPE_INDICATION [:= EXPRESSION]
2274 -- [ASPECT_SPECIFICATIONS];
2275 -- | DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2276 -- ACCESS_DEFINITION [:= EXPRESSION]
2277 -- [ASPECT_SPECIFICATIONS];
2278 -- | DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2279 -- ARRAY_TYPE_DEFINITION [:= EXPRESSION]
2280 -- [ASPECT_SPECIFICATIONS];
2281 -- | SINGLE_TASK_DECLARATION
2282 -- | SINGLE_PROTECTED_DECLARATION
2283
2284 -- Note: aliased is not permitted in Ada 83 mode
2285
2286 -- The N_Object_Declaration node is only for the first two cases.
2287 -- Single task declaration is handled by P_Task (9.1)
2288 -- Single protected declaration is handled by P_protected (9.5)
2289
2290 -- Although the syntax allows multiple identifiers in the list, the
2291 -- semantics is as though successive declarations were given with
2292 -- identical type definition and expression components. To simplify
2293 -- semantic processing, the parser represents a multiple declaration
2294 -- case as a sequence of single declarations, using the More_Ids and
2295 -- Prev_Ids flags to preserve the original source form as described
2296 -- in the section on "Handling of Defining Identifier Lists".
2297
2298 -- The flag Has_Init_Expression is set if an initializing expression
2299 -- is present. Normally it is set if and only if Expression contains
2300 -- a non-empty value, but there is an exception to this. When the
2301 -- initializing expression is an aggregate which requires explicit
2302 -- assignments, the Expression field gets set to Empty, but this flag
2303 -- is still set, so we don't forget we had an initializing expression.
2304
2305 -- Note: if a range check is required for the initialization
2306 -- expression then the Do_Range_Check flag is set in the Expression,
2307 -- with the check being done against the type given by the object
2308 -- definition, which is also the Etype of the defining identifier.
2309
2310 -- Note: the contents of the Expression field must be ignored (i.e.
2311 -- treated as though it were Empty) if No_Initialization is set True.
2312
2313 -- Note: the back end places some restrictions on the form of the
2314 -- Expression field. If the object being declared is Atomic, then
2315 -- the Expression may not have the form of an aggregate (since this
2316 -- might cause the back end to generate separate assignments). In this
2317 -- case the front end must generate an extra temporary and initialize
2318 -- this temporary as required (the temporary itself is not atomic).
2319
2320 -- Note: there is not node kind for object definition. Instead, the
2321 -- corresponding field holds a subtype indication, an array type
2322 -- definition, or (Ada 2005, AI-406) an access definition.
2323
2324 -- N_Object_Declaration
2325 -- Sloc points to first identifier
2326 -- Defining_Identifier (Node1)
2327 -- Aliased_Present (Flag4) set if ALIASED appears
2328 -- Constant_Present (Flag17) set if CONSTANT appears
2329 -- Null_Exclusion_Present (Flag11)
2330 -- Object_Definition (Node4) subtype indic./array type def./access def.
2331 -- Expression (Node3) (set to Empty if not present)
2332 -- Handler_List_Entry (Node2-Sem)
2333 -- Corresponding_Generic_Association (Node5-Sem)
2334 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2335 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2336 -- No_Initialization (Flag13-Sem)
2337 -- Assignment_OK (Flag15-Sem)
2338 -- Exception_Junk (Flag8-Sem)
2339 -- Is_Subprogram_Descriptor (Flag16-Sem)
2340 -- Has_Init_Expression (Flag14)
2341 -- Suppress_Assignment_Checks (Flag18-Sem)
2342
2343 -------------------------------------
2344 -- 3.3.1 Defining Identifier List --
2345 -------------------------------------
2346
2347 -- DEFINING_IDENTIFIER_LIST ::=
2348 -- DEFINING_IDENTIFIER {, DEFINING_IDENTIFIER}
2349
2350 -------------------------------
2351 -- 3.3.2 Number Declaration --
2352 -------------------------------
2353
2354 -- NUMBER_DECLARATION ::=
2355 -- DEFINING_IDENTIFIER_LIST : constant := static_EXPRESSION;
2356
2357 -- Although the syntax allows multiple identifiers in the list, the
2358 -- semantics is as though successive declarations were given with
2359 -- identical expressions. To simplify semantic processing, the parser
2360 -- represents a multiple declaration case as a sequence of single
2361 -- declarations, using the More_Ids and Prev_Ids flags to preserve
2362 -- the original source form as described in the section on "Handling
2363 -- of Defining Identifier Lists".
2364
2365 -- N_Number_Declaration
2366 -- Sloc points to first identifier
2367 -- Defining_Identifier (Node1)
2368 -- Expression (Node3)
2369 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2370 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2371
2372 ----------------------------------
2373 -- 3.4 Derived Type Definition --
2374 ----------------------------------
2375
2376 -- DERIVED_TYPE_DEFINITION ::=
2377 -- [abstract] [limited] new [NULL_EXCLUSION] parent_SUBTYPE_INDICATION
2378 -- [[and INTERFACE_LIST] RECORD_EXTENSION_PART]
2379
2380 -- Note: ABSTRACT, LIMITED and record extension part are not permitted
2381 -- in Ada 83 mode
2382
2383 -- Note: a record extension part is required if ABSTRACT is present
2384
2385 -- N_Derived_Type_Definition
2386 -- Sloc points to NEW
2387 -- Abstract_Present (Flag4)
2388 -- Null_Exclusion_Present (Flag11) (set to False if not present)
2389 -- Subtype_Indication (Node5)
2390 -- Record_Extension_Part (Node3) (set to Empty if not present)
2391 -- Limited_Present (Flag17)
2392 -- Task_Present (Flag5) set in task interfaces
2393 -- Protected_Present (Flag6) set in protected interfaces
2394 -- Synchronized_Present (Flag7) set in interfaces
2395 -- Interface_List (List2) (set to No_List if none)
2396 -- Interface_Present (Flag16) set in abstract interfaces
2397
2398 -- Note: Task_Present, Protected_Present, Synchronized_Present,
2399 -- Interface_List, and Interface_Present are used for abstract
2400 -- interfaces (see comments for INTERFACE_TYPE_DEFINITION).
2401
2402 ---------------------------
2403 -- 3.5 Range Constraint --
2404 ---------------------------
2405
2406 -- RANGE_CONSTRAINT ::= range RANGE
2407
2408 -- N_Range_Constraint
2409 -- Sloc points to RANGE
2410 -- Range_Expression (Node4)
2411
2412 ----------------
2413 -- 3.5 Range --
2414 ----------------
2415
2416 -- RANGE ::=
2417 -- RANGE_ATTRIBUTE_REFERENCE
2418 -- | SIMPLE_EXPRESSION .. SIMPLE_EXPRESSION
2419
2420 -- Note: the case of a range given as a range attribute reference
2421 -- appears directly in the tree as an attribute reference.
2422
2423 -- Note: the field name for a reference to a range is Range_Expression
2424 -- rather than Range, because range is a reserved keyword in Ada!
2425
2426 -- Note: the reason that this node has expression fields is that a
2427 -- range can appear as an operand of a membership test. The Etype
2428 -- field is the type of the range (we do NOT construct an implicit
2429 -- subtype to represent the range exactly).
2430
2431 -- N_Range
2432 -- Sloc points to ..
2433 -- Low_Bound (Node1)
2434 -- High_Bound (Node2)
2435 -- Includes_Infinities (Flag11)
2436 -- plus fields for expression
2437
2438 -- Note: if the range appears in a context, such as a subtype
2439 -- declaration, where range checks are required on one or both of
2440 -- the expression fields, then type conversion nodes are inserted
2441 -- to represent the required checks.
2442
2443 ----------------------------------------
2444 -- 3.5.1 Enumeration Type Definition --
2445 ----------------------------------------
2446
2447 -- ENUMERATION_TYPE_DEFINITION ::=
2448 -- (ENUMERATION_LITERAL_SPECIFICATION
2449 -- {, ENUMERATION_LITERAL_SPECIFICATION})
2450
2451 -- Note: the Literals field in the node described below is null for
2452 -- the case of the standard types CHARACTER and WIDE_CHARACTER, for
2453 -- which special processing handles these types as special cases.
2454
2455 -- N_Enumeration_Type_Definition
2456 -- Sloc points to left parenthesis
2457 -- Literals (List1) (Empty for CHARACTER or WIDE_CHARACTER)
2458 -- End_Label (Node4) (set to Empty if internally generated record)
2459
2460 ----------------------------------------------
2461 -- 3.5.1 Enumeration Literal Specification --
2462 ----------------------------------------------
2463
2464 -- ENUMERATION_LITERAL_SPECIFICATION ::=
2465 -- DEFINING_IDENTIFIER | DEFINING_CHARACTER_LITERAL
2466
2467 ---------------------------------------
2468 -- 3.5.1 Defining Character Literal --
2469 ---------------------------------------
2470
2471 -- DEFINING_CHARACTER_LITERAL ::= CHARACTER_LITERAL
2472
2473 -- A defining character literal is an entity, which has additional
2474 -- fields depending on the setting of the Ekind field. These
2475 -- additional fields are defined (and access subprograms declared)
2476 -- in package Einfo.
2477
2478 -- Note: N_Defining_Character_Literal is an extended node whose fields
2479 -- are deliberate layed out to match the layout of fields in an ordinary
2480 -- N_Character_Literal node allowing for easy alteration of a character
2481 -- literal node into a defining character literal node. For details, see
2482 -- Sinfo.CN.Change_Character_Literal_To_Defining_Character_Literal.
2483
2484 -- N_Defining_Character_Literal
2485 -- Sloc points to literal
2486 -- Chars (Name1) contains the Name_Id for the identifier
2487 -- Next_Entity (Node2-Sem)
2488 -- Scope (Node3-Sem)
2489 -- Etype (Node5-Sem)
2490
2491 ------------------------------------
2492 -- 3.5.4 Integer Type Definition --
2493 ------------------------------------
2494
2495 -- Note: there is an error in this rule in the latest version of the
2496 -- grammar, so we have retained the old rule pending clarification.
2497
2498 -- INTEGER_TYPE_DEFINITION ::=
2499 -- SIGNED_INTEGER_TYPE_DEFINITION
2500 -- | MODULAR_TYPE_DEFINITION
2501
2502 -------------------------------------------
2503 -- 3.5.4 Signed Integer Type Definition --
2504 -------------------------------------------
2505
2506 -- SIGNED_INTEGER_TYPE_DEFINITION ::=
2507 -- range static_SIMPLE_EXPRESSION .. static_SIMPLE_EXPRESSION
2508
2509 -- Note: the Low_Bound and High_Bound fields are set to Empty
2510 -- for integer types defined in package Standard.
2511
2512 -- N_Signed_Integer_Type_Definition
2513 -- Sloc points to RANGE
2514 -- Low_Bound (Node1)
2515 -- High_Bound (Node2)
2516
2517 ------------------------------------
2518 -- 3.5.4 Modular Type Definition --
2519 ------------------------------------
2520
2521 -- MODULAR_TYPE_DEFINITION ::= mod static_EXPRESSION
2522
2523 -- N_Modular_Type_Definition
2524 -- Sloc points to MOD
2525 -- Expression (Node3)
2526
2527 ---------------------------------
2528 -- 3.5.6 Real Type Definition --
2529 ---------------------------------
2530
2531 -- REAL_TYPE_DEFINITION ::=
2532 -- FLOATING_POINT_DEFINITION | FIXED_POINT_DEFINITION
2533
2534 --------------------------------------
2535 -- 3.5.7 Floating Point Definition --
2536 --------------------------------------
2537
2538 -- FLOATING_POINT_DEFINITION ::=
2539 -- digits static_SIMPLE_EXPRESSION [REAL_RANGE_SPECIFICATION]
2540
2541 -- Note: The Digits_Expression and Real_Range_Specifications fields
2542 -- are set to Empty for floating-point types declared in Standard.
2543
2544 -- N_Floating_Point_Definition
2545 -- Sloc points to DIGITS
2546 -- Digits_Expression (Node2)
2547 -- Real_Range_Specification (Node4) (set to Empty if not present)
2548
2549 -------------------------------------
2550 -- 3.5.7 Real Range Specification --
2551 -------------------------------------
2552
2553 -- REAL_RANGE_SPECIFICATION ::=
2554 -- range static_SIMPLE_EXPRESSION .. static_SIMPLE_EXPRESSION
2555
2556 -- N_Real_Range_Specification
2557 -- Sloc points to RANGE
2558 -- Low_Bound (Node1)
2559 -- High_Bound (Node2)
2560
2561 -----------------------------------
2562 -- 3.5.9 Fixed Point Definition --
2563 -----------------------------------
2564
2565 -- FIXED_POINT_DEFINITION ::=
2566 -- ORDINARY_FIXED_POINT_DEFINITION | DECIMAL_FIXED_POINT_DEFINITION
2567
2568 --------------------------------------------
2569 -- 3.5.9 Ordinary Fixed Point Definition --
2570 --------------------------------------------
2571
2572 -- ORDINARY_FIXED_POINT_DEFINITION ::=
2573 -- delta static_EXPRESSION REAL_RANGE_SPECIFICATION
2574
2575 -- Note: In Ada 83, the EXPRESSION must be a SIMPLE_EXPRESSION
2576
2577 -- N_Ordinary_Fixed_Point_Definition
2578 -- Sloc points to DELTA
2579 -- Delta_Expression (Node3)
2580 -- Real_Range_Specification (Node4)
2581
2582 -------------------------------------------
2583 -- 3.5.9 Decimal Fixed Point Definition --
2584 -------------------------------------------
2585
2586 -- DECIMAL_FIXED_POINT_DEFINITION ::=
2587 -- delta static_EXPRESSION
2588 -- digits static_EXPRESSION [REAL_RANGE_SPECIFICATION]
2589
2590 -- Note: decimal types are not permitted in Ada 83 mode
2591
2592 -- N_Decimal_Fixed_Point_Definition
2593 -- Sloc points to DELTA
2594 -- Delta_Expression (Node3)
2595 -- Digits_Expression (Node2)
2596 -- Real_Range_Specification (Node4) (set to Empty if not present)
2597
2598 ------------------------------
2599 -- 3.5.9 Digits Constraint --
2600 ------------------------------
2601
2602 -- DIGITS_CONSTRAINT ::=
2603 -- digits static_EXPRESSION [RANGE_CONSTRAINT]
2604
2605 -- Note: in Ada 83, the EXPRESSION must be a SIMPLE_EXPRESSION
2606 -- Note: in Ada 95, reduced accuracy subtypes are obsolescent
2607
2608 -- N_Digits_Constraint
2609 -- Sloc points to DIGITS
2610 -- Digits_Expression (Node2)
2611 -- Range_Constraint (Node4) (set to Empty if not present)
2612
2613 --------------------------------
2614 -- 3.6 Array Type Definition --
2615 --------------------------------
2616
2617 -- ARRAY_TYPE_DEFINITION ::=
2618 -- UNCONSTRAINED_ARRAY_DEFINITION | CONSTRAINED_ARRAY_DEFINITION
2619
2620 -----------------------------------------
2621 -- 3.6 Unconstrained Array Definition --
2622 -----------------------------------------
2623
2624 -- UNCONSTRAINED_ARRAY_DEFINITION ::=
2625 -- array (INDEX_SUBTYPE_DEFINITION {, INDEX_SUBTYPE_DEFINITION}) of
2626 -- COMPONENT_DEFINITION
2627
2628 -- Note: dimensionality of array is indicated by number of entries in
2629 -- the Subtype_Marks list, which has one entry for each dimension.
2630
2631 -- N_Unconstrained_Array_Definition
2632 -- Sloc points to ARRAY
2633 -- Subtype_Marks (List2)
2634 -- Component_Definition (Node4)
2635
2636 -----------------------------------
2637 -- 3.6 Index Subtype Definition --
2638 -----------------------------------
2639
2640 -- INDEX_SUBTYPE_DEFINITION ::= SUBTYPE_MARK range <>
2641
2642 -- There is no explicit node in the tree for an index subtype
2643 -- definition since the N_Unconstrained_Array_Definition node
2644 -- incorporates the type marks which appear in this context.
2645
2646 ---------------------------------------
2647 -- 3.6 Constrained Array Definition --
2648 ---------------------------------------
2649
2650 -- CONSTRAINED_ARRAY_DEFINITION ::=
2651 -- array (DISCRETE_SUBTYPE_DEFINITION
2652 -- {, DISCRETE_SUBTYPE_DEFINITION})
2653 -- of COMPONENT_DEFINITION
2654
2655 -- Note: dimensionality of array is indicated by number of entries
2656 -- in the Discrete_Subtype_Definitions list, which has one entry
2657 -- for each dimension.
2658
2659 -- N_Constrained_Array_Definition
2660 -- Sloc points to ARRAY
2661 -- Discrete_Subtype_Definitions (List2)
2662 -- Component_Definition (Node4)
2663
2664 --------------------------------------
2665 -- 3.6 Discrete Subtype Definition --
2666 --------------------------------------
2667
2668 -- DISCRETE_SUBTYPE_DEFINITION ::=
2669 -- discrete_SUBTYPE_INDICATION | RANGE
2670
2671 -------------------------------
2672 -- 3.6 Component Definition --
2673 -------------------------------
2674
2675 -- COMPONENT_DEFINITION ::=
2676 -- [aliased] [NULL_EXCLUSION] SUBTYPE_INDICATION | ACCESS_DEFINITION
2677
2678 -- Note: although the syntax does not permit a component definition to
2679 -- be an anonymous array (and the parser will diagnose such an attempt
2680 -- with an appropriate message), it is possible for anonymous arrays
2681 -- to appear as component definitions. The semantics and back end handle
2682 -- this case properly, and the expander in fact generates such cases.
2683 -- Access_Definition is an optional field that gives support to
2684 -- Ada 2005 (AI-230). The parser generates nodes that have either the
2685 -- Subtype_Indication field or else the Access_Definition field.
2686
2687 -- N_Component_Definition
2688 -- Sloc points to ALIASED, ACCESS or to first token of subtype mark
2689 -- Aliased_Present (Flag4)
2690 -- Null_Exclusion_Present (Flag11)
2691 -- Subtype_Indication (Node5) (set to Empty if not present)
2692 -- Access_Definition (Node3) (set to Empty if not present)
2693
2694 -----------------------------
2695 -- 3.6.1 Index Constraint --
2696 -----------------------------
2697
2698 -- INDEX_CONSTRAINT ::= (DISCRETE_RANGE {, DISCRETE_RANGE})
2699
2700 -- It is not in general possible to distinguish between discriminant
2701 -- constraints and index constraints at parse time, since a simple
2702 -- name could be either the subtype mark of a discrete range, or an
2703 -- expression in a discriminant association with no name. Either
2704 -- entry appears simply as the name, and the semantic parse must
2705 -- distinguish between the two cases. Thus we use a common tree
2706 -- node format for both of these constraint types.
2707
2708 -- See Discriminant_Constraint for format of node
2709
2710 ---------------------------
2711 -- 3.6.1 Discrete Range --
2712 ---------------------------
2713
2714 -- DISCRETE_RANGE ::= discrete_SUBTYPE_INDICATION | RANGE
2715
2716 ----------------------------
2717 -- 3.7 Discriminant Part --
2718 ----------------------------
2719
2720 -- DISCRIMINANT_PART ::=
2721 -- UNKNOWN_DISCRIMINANT_PART | KNOWN_DISCRIMINANT_PART
2722
2723 ------------------------------------
2724 -- 3.7 Unknown Discriminant Part --
2725 ------------------------------------
2726
2727 -- UNKNOWN_DISCRIMINANT_PART ::= (<>)
2728
2729 -- Note: unknown discriminant parts are not permitted in Ada 83 mode
2730
2731 -- There is no explicit node in the tree for an unknown discriminant
2732 -- part. Instead the Unknown_Discriminants_Present flag is set in the
2733 -- parent node.
2734
2735 ----------------------------------
2736 -- 3.7 Known Discriminant Part --
2737 ----------------------------------
2738
2739 -- KNOWN_DISCRIMINANT_PART ::=
2740 -- (DISCRIMINANT_SPECIFICATION {; DISCRIMINANT_SPECIFICATION})
2741
2742 -------------------------------------
2743 -- 3.7 Discriminant Specification --
2744 -------------------------------------
2745
2746 -- DISCRIMINANT_SPECIFICATION ::=
2747 -- DEFINING_IDENTIFIER_LIST : [NULL_EXCLUSION] SUBTYPE_MARK
2748 -- [:= DEFAULT_EXPRESSION]
2749 -- | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
2750 -- [:= DEFAULT_EXPRESSION]
2751
2752 -- Although the syntax allows multiple identifiers in the list, the
2753 -- semantics is as though successive specifications were given with
2754 -- identical type definition and expression components. To simplify
2755 -- semantic processing, the parser represents a multiple declaration
2756 -- case as a sequence of single specifications, using the More_Ids and
2757 -- Prev_Ids flags to preserve the original source form as described
2758 -- in the section on "Handling of Defining Identifier Lists".
2759
2760 -- N_Discriminant_Specification
2761 -- Sloc points to first identifier
2762 -- Defining_Identifier (Node1)
2763 -- Null_Exclusion_Present (Flag11)
2764 -- Discriminant_Type (Node5) subtype mark or access parameter definition
2765 -- Expression (Node3) (set to Empty if no default expression)
2766 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2767 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2768
2769 -----------------------------
2770 -- 3.7 Default Expression --
2771 -----------------------------
2772
2773 -- DEFAULT_EXPRESSION ::= EXPRESSION
2774
2775 ------------------------------------
2776 -- 3.7.1 Discriminant Constraint --
2777 ------------------------------------
2778
2779 -- DISCRIMINANT_CONSTRAINT ::=
2780 -- (DISCRIMINANT_ASSOCIATION {, DISCRIMINANT_ASSOCIATION})
2781
2782 -- It is not in general possible to distinguish between discriminant
2783 -- constraints and index constraints at parse time, since a simple
2784 -- name could be either the subtype mark of a discrete range, or an
2785 -- expression in a discriminant association with no name. Either
2786 -- entry appears simply as the name, and the semantic parse must
2787 -- distinguish between the two cases. Thus we use a common tree
2788 -- node format for both of these constraint types.
2789
2790 -- N_Index_Or_Discriminant_Constraint
2791 -- Sloc points to left paren
2792 -- Constraints (List1) points to list of discrete ranges or
2793 -- discriminant associations
2794
2795 -------------------------------------
2796 -- 3.7.1 Discriminant Association --
2797 -------------------------------------
2798
2799 -- DISCRIMINANT_ASSOCIATION ::=
2800 -- [discriminant_SELECTOR_NAME
2801 -- {| discriminant_SELECTOR_NAME} =>] EXPRESSION
2802
2803 -- Note: a discriminant association that has no selector name list
2804 -- appears directly as an expression in the tree.
2805
2806 -- N_Discriminant_Association
2807 -- Sloc points to first token of discriminant association
2808 -- Selector_Names (List1) (always non-empty, since if no selector
2809 -- names are present, this node is not used, see comment above)
2810 -- Expression (Node3)
2811
2812 ---------------------------------
2813 -- 3.8 Record Type Definition --
2814 ---------------------------------
2815
2816 -- RECORD_TYPE_DEFINITION ::=
2817 -- [[abstract] tagged] [limited] RECORD_DEFINITION
2818
2819 -- Note: ABSTRACT, TAGGED, LIMITED are not permitted in Ada 83 mode
2820
2821 -- There is no explicit node in the tree for a record type definition.
2822 -- Instead the flags for Tagged_Present and Limited_Present appear in
2823 -- the N_Record_Definition node for a record definition appearing in
2824 -- the context of a record type definition.
2825
2826 ----------------------------
2827 -- 3.8 Record Definition --
2828 ----------------------------
2829
2830 -- RECORD_DEFINITION ::=
2831 -- record
2832 -- COMPONENT_LIST
2833 -- end record
2834 -- | null record
2835
2836 -- Note: the Abstract_Present, Tagged_Present and Limited_Present
2837 -- flags appear only for a record definition appearing in a record
2838 -- type definition.
2839
2840 -- Note: the NULL RECORD case is not permitted in Ada 83
2841
2842 -- N_Record_Definition
2843 -- Sloc points to RECORD or NULL
2844 -- End_Label (Node4) (set to Empty if internally generated record)
2845 -- Abstract_Present (Flag4)
2846 -- Tagged_Present (Flag15)
2847 -- Limited_Present (Flag17)
2848 -- Component_List (Node1) empty in null record case
2849 -- Null_Present (Flag13) set in null record case
2850 -- Task_Present (Flag5) set in task interfaces
2851 -- Protected_Present (Flag6) set in protected interfaces
2852 -- Synchronized_Present (Flag7) set in interfaces
2853 -- Interface_Present (Flag16) set in abstract interfaces
2854 -- Interface_List (List2) (set to No_List if none)
2855
2856 -- Note: Task_Present, Protected_Present, Synchronized _Present,
2857 -- Interface_List and Interface_Present are used for abstract
2858 -- interfaces (see comments for INTERFACE_TYPE_DEFINITION).
2859
2860 -------------------------
2861 -- 3.8 Component List --
2862 -------------------------
2863
2864 -- COMPONENT_LIST ::=
2865 -- COMPONENT_ITEM {COMPONENT_ITEM}
2866 -- | {COMPONENT_ITEM} VARIANT_PART
2867 -- | null;
2868
2869 -- N_Component_List
2870 -- Sloc points to first token of component list
2871 -- Component_Items (List3)
2872 -- Variant_Part (Node4) (set to Empty if no variant part)
2873 -- Null_Present (Flag13)
2874
2875 -------------------------
2876 -- 3.8 Component Item --
2877 -------------------------
2878
2879 -- COMPONENT_ITEM ::= COMPONENT_DECLARATION | REPRESENTATION_CLAUSE
2880
2881 -- Note: A component item can also be a pragma, and in the tree
2882 -- that is obtained after semantic processing, a component item
2883 -- can be an N_Null node resulting from a non-recognized pragma.
2884
2885 --------------------------------
2886 -- 3.8 Component Declaration --
2887 --------------------------------
2888
2889 -- COMPONENT_DECLARATION ::=
2890 -- DEFINING_IDENTIFIER_LIST : COMPONENT_DEFINITION
2891 -- [:= DEFAULT_EXPRESSION]
2892 -- [ASPECT_SPECIFICATIONS];
2893
2894 -- Note: although the syntax does not permit a component definition to
2895 -- be an anonymous array (and the parser will diagnose such an attempt
2896 -- with an appropriate message), it is possible for anonymous arrays
2897 -- to appear as component definitions. The semantics and back end handle
2898 -- this case properly, and the expander in fact generates such cases.
2899
2900 -- Although the syntax allows multiple identifiers in the list, the
2901 -- semantics is as though successive declarations were given with the
2902 -- same component definition and expression components. To simplify
2903 -- semantic processing, the parser represents a multiple declaration
2904 -- case as a sequence of single declarations, using the More_Ids and
2905 -- Prev_Ids flags to preserve the original source form as described
2906 -- in the section on "Handling of Defining Identifier Lists".
2907
2908 -- N_Component_Declaration
2909 -- Sloc points to first identifier
2910 -- Defining_Identifier (Node1)
2911 -- Component_Definition (Node4)
2912 -- Expression (Node3) (set to Empty if no default expression)
2913 -- More_Ids (Flag5) (set to False if no more identifiers in list)
2914 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2915
2916 -------------------------
2917 -- 3.8.1 Variant Part --
2918 -------------------------
2919
2920 -- VARIANT_PART ::=
2921 -- case discriminant_DIRECT_NAME is
2922 -- VARIANT
2923 -- {VARIANT}
2924 -- end case;
2925
2926 -- Note: the variants list can contain pragmas as well as variants.
2927 -- In a properly formed program there is at least one variant.
2928
2929 -- N_Variant_Part
2930 -- Sloc points to CASE
2931 -- Name (Node2)
2932 -- Variants (List1)
2933
2934 --------------------
2935 -- 3.8.1 Variant --
2936 --------------------
2937
2938 -- VARIANT ::=
2939 -- when DISCRETE_CHOICE_LIST =>
2940 -- COMPONENT_LIST
2941
2942 -- N_Variant
2943 -- Sloc points to WHEN
2944 -- Discrete_Choices (List4)
2945 -- Component_List (Node1)
2946 -- Enclosing_Variant (Node2-Sem)
2947 -- Present_Expr (Uint3-Sem)
2948 -- Dcheck_Function (Node5-Sem)
2949
2950 ---------------------------------
2951 -- 3.8.1 Discrete Choice List --
2952 ---------------------------------
2953
2954 -- DISCRETE_CHOICE_LIST ::= DISCRETE_CHOICE {| DISCRETE_CHOICE}
2955
2956 ----------------------------
2957 -- 3.8.1 Discrete Choice --
2958 ----------------------------
2959
2960 -- DISCRETE_CHOICE ::= EXPRESSION | DISCRETE_RANGE | others
2961
2962 -- Note: in Ada 83 mode, the expression must be a simple expression
2963
2964 -- The only choice that appears explicitly is the OTHERS choice, as
2965 -- defined here. Other cases of discrete choice (expression and
2966 -- discrete range) appear directly. This production is also used
2967 -- for the OTHERS possibility of an exception choice.
2968
2969 -- Note: in accordance with the syntax, the parser does not check that
2970 -- OTHERS appears at the end on its own in a choice list context. This
2971 -- is a semantic check.
2972
2973 -- N_Others_Choice
2974 -- Sloc points to OTHERS
2975 -- Others_Discrete_Choices (List1-Sem)
2976 -- All_Others (Flag11-Sem)
2977
2978 ----------------------------------
2979 -- 3.9.1 Record Extension Part --
2980 ----------------------------------
2981
2982 -- RECORD_EXTENSION_PART ::= with RECORD_DEFINITION
2983
2984 -- Note: record extension parts are not permitted in Ada 83 mode
2985
2986 --------------------------------------
2987 -- 3.9.4 Interface Type Definition --
2988 --------------------------------------
2989
2990 -- INTERFACE_TYPE_DEFINITION ::=
2991 -- [limited | task | protected | synchronized]
2992 -- interface [interface_list]
2993
2994 -- Note: Interfaces are implemented with N_Record_Definition and
2995 -- N_Derived_Type_Definition nodes because most of the support
2996 -- for the analysis of abstract types has been reused to
2997 -- analyze abstract interfaces.
2998
2999 ----------------------------------
3000 -- 3.10 Access Type Definition --
3001 ----------------------------------
3002
3003 -- ACCESS_TYPE_DEFINITION ::=
3004 -- ACCESS_TO_OBJECT_DEFINITION
3005 -- | ACCESS_TO_SUBPROGRAM_DEFINITION
3006
3007 --------------------------
3008 -- 3.10 Null Exclusion --
3009 --------------------------
3010
3011 -- NULL_EXCLUSION ::= not null
3012
3013 ---------------------------------------
3014 -- 3.10 Access To Object Definition --
3015 ---------------------------------------
3016
3017 -- ACCESS_TO_OBJECT_DEFINITION ::=
3018 -- [NULL_EXCLUSION] access [GENERAL_ACCESS_MODIFIER]
3019 -- SUBTYPE_INDICATION
3020
3021 -- N_Access_To_Object_Definition
3022 -- Sloc points to ACCESS
3023 -- All_Present (Flag15)
3024 -- Null_Exclusion_Present (Flag11)
3025 -- Subtype_Indication (Node5)
3026 -- Constant_Present (Flag17)
3027
3028 -----------------------------------
3029 -- 3.10 General Access Modifier --
3030 -----------------------------------
3031
3032 -- GENERAL_ACCESS_MODIFIER ::= all | constant
3033
3034 -- Note: general access modifiers are not permitted in Ada 83 mode
3035
3036 -- There is no explicit node in the tree for general access modifier.
3037 -- Instead the All_Present or Constant_Present flags are set in the
3038 -- parent node.
3039
3040 -------------------------------------------
3041 -- 3.10 Access To Subprogram Definition --
3042 -------------------------------------------
3043
3044 -- ACCESS_TO_SUBPROGRAM_DEFINITION
3045 -- [NULL_EXCLUSION] access [protected] procedure PARAMETER_PROFILE
3046 -- | [NULL_EXCLUSION] access [protected] function
3047 -- PARAMETER_AND_RESULT_PROFILE
3048
3049 -- Note: access to subprograms are not permitted in Ada 83 mode
3050
3051 -- N_Access_Function_Definition
3052 -- Sloc points to ACCESS
3053 -- Null_Exclusion_Present (Flag11)
3054 -- Null_Exclusion_In_Return_Present (Flag14)
3055 -- Protected_Present (Flag6)
3056 -- Parameter_Specifications (List3) (set to No_List if no formal part)
3057 -- Result_Definition (Node4) result subtype (subtype mark or access def)
3058
3059 -- N_Access_Procedure_Definition
3060 -- Sloc points to ACCESS
3061 -- Null_Exclusion_Present (Flag11)
3062 -- Protected_Present (Flag6)
3063 -- Parameter_Specifications (List3) (set to No_List if no formal part)
3064
3065 -----------------------------
3066 -- 3.10 Access Definition --
3067 -----------------------------
3068
3069 -- ACCESS_DEFINITION ::=
3070 -- [NULL_EXCLUSION] access [GENERAL_ACCESS_MODIFIER] SUBTYPE_MARK
3071 -- | ACCESS_TO_SUBPROGRAM_DEFINITION
3072
3073 -- Note: access to subprograms are an Ada 2005 (AI-254) extension
3074
3075 -- N_Access_Definition
3076 -- Sloc points to ACCESS
3077 -- Null_Exclusion_Present (Flag11)
3078 -- All_Present (Flag15)
3079 -- Constant_Present (Flag17)
3080 -- Subtype_Mark (Node4)
3081 -- Access_To_Subprogram_Definition (Node3) (set to Empty if not present)
3082
3083 -----------------------------------------
3084 -- 3.10.1 Incomplete Type Declaration --
3085 -----------------------------------------
3086
3087 -- INCOMPLETE_TYPE_DECLARATION ::=
3088 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART] [IS TAGGED];
3089
3090 -- N_Incomplete_Type_Declaration
3091 -- Sloc points to TYPE
3092 -- Defining_Identifier (Node1)
3093 -- Discriminant_Specifications (List4) (set to No_List if no
3094 -- discriminant part, or if the discriminant part is an
3095 -- unknown discriminant part)
3096 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
3097 -- Tagged_Present (Flag15)
3098
3099 ----------------------------
3100 -- 3.11 Declarative Part --
3101 ----------------------------
3102
3103 -- DECLARATIVE_PART ::= {DECLARATIVE_ITEM}
3104
3105 -- Note: although the parser enforces the syntactic requirement that
3106 -- a declarative part can contain only declarations, the semantic
3107 -- processing may add statements to the list of actions in a
3108 -- declarative part, so the code generator should be prepared
3109 -- to accept a statement in this position.
3110
3111 ----------------------------
3112 -- 3.11 Declarative Item --
3113 ----------------------------
3114
3115 -- DECLARATIVE_ITEM ::= BASIC_DECLARATIVE_ITEM | BODY
3116
3117 ----------------------------------
3118 -- 3.11 Basic Declarative Item --
3119 ----------------------------------
3120
3121 -- BASIC_DECLARATIVE_ITEM ::=
3122 -- BASIC_DECLARATION | REPRESENTATION_CLAUSE | USE_CLAUSE
3123
3124 ----------------
3125 -- 3.11 Body --
3126 ----------------
3127
3128 -- BODY ::= PROPER_BODY | BODY_STUB
3129
3130 -----------------------
3131 -- 3.11 Proper Body --
3132 -----------------------
3133
3134 -- PROPER_BODY ::=
3135 -- SUBPROGRAM_BODY | PACKAGE_BODY | TASK_BODY | PROTECTED_BODY
3136
3137 ---------------
3138 -- 4.1 Name --
3139 ---------------
3140
3141 -- NAME ::=
3142 -- DIRECT_NAME | EXPLICIT_DEREFERENCE
3143 -- | INDEXED_COMPONENT | SLICE
3144 -- | SELECTED_COMPONENT | ATTRIBUTE_REFERENCE
3145 -- | TYPE_CONVERSION | FUNCTION_CALL
3146 -- | CHARACTER_LITERAL
3147
3148 ----------------------
3149 -- 4.1 Direct Name --
3150 ----------------------
3151
3152 -- DIRECT_NAME ::= IDENTIFIER | OPERATOR_SYMBOL
3153
3154 -----------------
3155 -- 4.1 Prefix --
3156 -----------------
3157
3158 -- PREFIX ::= NAME | IMPLICIT_DEREFERENCE
3159
3160 -------------------------------
3161 -- 4.1 Explicit Dereference --
3162 -------------------------------
3163
3164 -- EXPLICIT_DEREFERENCE ::= NAME . all
3165
3166 -- N_Explicit_Dereference
3167 -- Sloc points to ALL
3168 -- Prefix (Node3)
3169 -- Actual_Designated_Subtype (Node4-Sem)
3170 -- plus fields for expression
3171
3172 -------------------------------
3173 -- 4.1 Implicit Dereference --
3174 -------------------------------
3175
3176 -- IMPLICIT_DEREFERENCE ::= NAME
3177
3178 ------------------------------
3179 -- 4.1.1 Indexed Component --
3180 ------------------------------
3181
3182 -- INDEXED_COMPONENT ::= PREFIX (EXPRESSION {, EXPRESSION})
3183
3184 -- Note: the parser may generate this node in some situations where it
3185 -- should be a function call. The semantic pass must correct this
3186 -- misidentification (which is inevitable at the parser level).
3187
3188 -- N_Indexed_Component
3189 -- Sloc contains a copy of the Sloc value of the Prefix
3190 -- Prefix (Node3)
3191 -- Expressions (List1)
3192 -- plus fields for expression
3193
3194 -- Note: if any of the subscripts requires a range check, then the
3195 -- Do_Range_Check flag is set on the corresponding expression, with
3196 -- the index type being determined from the type of the Prefix, which
3197 -- references the array being indexed.
3198
3199 -- Note: in a fully analyzed and expanded indexed component node, and
3200 -- hence in any such node that gigi sees, if the prefix is an access
3201 -- type, then an explicit dereference operation has been inserted.
3202
3203 ------------------
3204 -- 4.1.2 Slice --
3205 ------------------
3206
3207 -- SLICE ::= PREFIX (DISCRETE_RANGE)
3208
3209 -- Note: an implicit subtype is created to describe the resulting
3210 -- type, so that the bounds of this type are the bounds of the slice.
3211
3212 -- N_Slice
3213 -- Sloc points to first token of prefix
3214 -- Prefix (Node3)
3215 -- Discrete_Range (Node4)
3216 -- plus fields for expression
3217
3218 -------------------------------
3219 -- 4.1.3 Selected Component --
3220 -------------------------------
3221
3222 -- SELECTED_COMPONENT ::= PREFIX . SELECTOR_NAME
3223
3224 -- Note: selected components that are semantically expanded names get
3225 -- changed during semantic processing into the separate N_Expanded_Name
3226 -- node. See description of this node in the section on semantic nodes.
3227
3228 -- N_Selected_Component
3229 -- Sloc points to period
3230 -- Prefix (Node3)
3231 -- Selector_Name (Node2)
3232 -- Associated_Node (Node4-Sem)
3233 -- Do_Discriminant_Check (Flag13-Sem)
3234 -- Is_In_Discriminant_Check (Flag11-Sem)
3235 -- plus fields for expression
3236
3237 --------------------------
3238 -- 4.1.3 Selector Name --
3239 --------------------------
3240
3241 -- SELECTOR_NAME ::= IDENTIFIER | CHARACTER_LITERAL | OPERATOR_SYMBOL
3242
3243 --------------------------------
3244 -- 4.1.4 Attribute Reference --
3245 --------------------------------
3246
3247 -- ATTRIBUTE_REFERENCE ::= PREFIX ' ATTRIBUTE_DESIGNATOR
3248
3249 -- Note: the syntax is quite ambiguous at this point. Consider:
3250
3251 -- A'Length (X) X is part of the attribute designator
3252 -- A'Pos (X) X is an explicit actual parameter of function A'Pos
3253 -- A'Class (X) X is the expression of a type conversion
3254
3255 -- It would be possible for the parser to distinguish these cases
3256 -- by looking at the attribute identifier. However, that would mean
3257 -- more work in introducing new implementation defined attributes,
3258 -- and also it would mean that special processing for attributes
3259 -- would be scattered around, instead of being centralized in the
3260 -- semantic routine that handles an N_Attribute_Reference node.
3261 -- Consequently, the parser in all the above cases stores the
3262 -- expression (X in these examples) as a single element list in
3263 -- in the Expressions field of the N_Attribute_Reference node.
3264
3265 -- Similarly, for attributes like Max which take two arguments,
3266 -- we store the two arguments as a two element list in the
3267 -- Expressions field. Of course it is clear at parse time that
3268 -- this case is really a function call with an attribute as the
3269 -- prefix, but it turns out to be convenient to handle the two
3270 -- argument case in a similar manner to the one argument case,
3271 -- and indeed in general the parser will accept any number of
3272 -- expressions in this position and store them as a list in the
3273 -- attribute reference node. This allows for future addition of
3274 -- attributes that take more than two arguments.
3275
3276 -- Note: named associates are not permitted in function calls where
3277 -- the function is an attribute (see RM 6.4(3)) so it is legitimate
3278 -- to skip the normal subprogram argument processing.
3279
3280 -- Note: for the attributes whose designators are technically keywords,
3281 -- i.e. digits, access, delta, range, the Attribute_Name field contains
3282 -- the corresponding name, even though no identifier is involved.
3283
3284 -- Note: the generated code may contain stream attributes applied to
3285 -- limited types for which no stream routines exist officially. In such
3286 -- case, the result is to use the stream attribute for the underlying
3287 -- full type, or in the case of a protected type, the components
3288 -- (including any discriminants) are merely streamed in order.
3289
3290 -- See Exp_Attr for a complete description of which attributes are
3291 -- passed onto Gigi, and which are handled entirely by the front end.
3292
3293 -- Gigi restriction: For the Pos attribute, the prefix cannot be
3294 -- a non-standard enumeration type or a nonzero/zero semantics
3295 -- boolean type, so the value is simply the stored representation.
3296
3297 -- Gigi requirement: For the Mechanism_Code attribute, if the prefix
3298 -- references a subprogram that is a renaming, then the front end must
3299 -- rewrite the attribute to refer directly to the renamed entity.
3300
3301 -- Note: In generated code, the Address and Unrestricted_Access
3302 -- attributes can be applied to any expression, and the meaning is
3303 -- to create an object containing the value (the object is in the
3304 -- current stack frame), and pass the address of this value. If the
3305 -- Must_Be_Byte_Aligned flag is set, then the object whose address
3306 -- is taken must be on a byte (storage unit) boundary, and if it is
3307 -- not (or may not be), then the generated code must create a copy
3308 -- that is byte aligned, and pass the address of this copy.
3309
3310 -- N_Attribute_Reference
3311 -- Sloc points to apostrophe
3312 -- Prefix (Node3)
3313 -- Attribute_Name (Name2) identifier name from attribute designator
3314 -- Expressions (List1) (set to No_List if no associated expressions)
3315 -- Entity (Node4-Sem) used if the attribute yields a type
3316 -- Associated_Node (Node4-Sem)
3317 -- Do_Overflow_Check (Flag17-Sem)
3318 -- Redundant_Use (Flag13-Sem)
3319 -- Must_Be_Byte_Aligned (Flag14)
3320 -- plus fields for expression
3321
3322 ---------------------------------
3323 -- 4.1.4 Attribute Designator --
3324 ---------------------------------
3325
3326 -- ATTRIBUTE_DESIGNATOR ::=
3327 -- IDENTIFIER [(static_EXPRESSION)]
3328 -- | access | delta | digits
3329
3330 -- There is no explicit node in the tree for an attribute designator.
3331 -- Instead the Attribute_Name and Expressions fields of the parent
3332 -- node (N_Attribute_Reference node) hold the information.
3333
3334 -- Note: if ACCESS, DELTA or DIGITS appears in an attribute
3335 -- designator, then they are treated as identifiers internally
3336 -- rather than the keywords of the same name.
3337
3338 --------------------------------------
3339 -- 4.1.4 Range Attribute Reference --
3340 --------------------------------------
3341
3342 -- RANGE_ATTRIBUTE_REFERENCE ::= PREFIX ' RANGE_ATTRIBUTE_DESIGNATOR
3343
3344 -- A range attribute reference is represented in the tree using the
3345 -- normal N_Attribute_Reference node.
3346
3347 ---------------------------------------
3348 -- 4.1.4 Range Attribute Designator --
3349 ---------------------------------------
3350
3351 -- RANGE_ATTRIBUTE_DESIGNATOR ::= Range [(static_EXPRESSION)]
3352
3353 -- A range attribute designator is represented in the tree using the
3354 -- normal N_Attribute_Reference node.
3355
3356 --------------------
3357 -- 4.3 Aggregate --
3358 --------------------
3359
3360 -- AGGREGATE ::=
3361 -- RECORD_AGGREGATE | EXTENSION_AGGREGATE | ARRAY_AGGREGATE
3362
3363 -----------------------------
3364 -- 4.3.1 Record Aggregate --
3365 -----------------------------
3366
3367 -- RECORD_AGGREGATE ::= (RECORD_COMPONENT_ASSOCIATION_LIST)
3368
3369 -- N_Aggregate
3370 -- Sloc points to left parenthesis
3371 -- Expressions (List1) (set to No_List if none or null record case)
3372 -- Component_Associations (List2) (set to No_List if none)
3373 -- Null_Record_Present (Flag17)
3374 -- Aggregate_Bounds (Node3-Sem)
3375 -- Associated_Node (Node4-Sem)
3376 -- Static_Processing_OK (Flag4-Sem)
3377 -- Compile_Time_Known_Aggregate (Flag18-Sem)
3378 -- Expansion_Delayed (Flag11-Sem)
3379 -- Has_Self_Reference (Flag13-Sem)
3380 -- plus fields for expression
3381
3382 -- Note: this structure is used for both record and array aggregates
3383 -- since the two cases are not separable by the parser. The parser
3384 -- makes no attempt to enforce consistency here, so it is up to the
3385 -- semantic phase to make sure that the aggregate is consistent (i.e.
3386 -- that it is not a "half-and-half" case that mixes record and array
3387 -- syntax. In particular, for a record aggregate, the expressions
3388 -- field will be set if there are positional associations.
3389
3390 -- Note: N_Aggregate is not used for all aggregates; in particular,
3391 -- there is a separate node kind for extension aggregates.
3392
3393 -- Note: gigi/gcc can handle array aggregates correctly providing that
3394 -- they are entirely positional, and the array subtype involved has a
3395 -- known at compile time length and is not bit packed, or a convention
3396 -- Fortran array with more than one dimension. If these conditions
3397 -- are not met, then the front end must translate the aggregate into
3398 -- an appropriate set of assignments into a temporary.
3399
3400 -- Note: for the record aggregate case, gigi/gcc can handle all cases of
3401 -- record aggregates, including those for packed, and rep-claused
3402 -- records, and also variant records, providing that there are no
3403 -- variable length fields whose size is not known at compile time, and
3404 -- providing that the aggregate is presented in fully named form.
3405
3406 ----------------------------------------------
3407 -- 4.3.1 Record Component Association List --
3408 ----------------------------------------------
3409
3410 -- RECORD_COMPONENT_ASSOCIATION_LIST ::=
3411 -- RECORD_COMPONENT_ASSOCIATION {, RECORD_COMPONENT_ASSOCIATION}
3412 -- | null record
3413
3414 -- There is no explicit node in the tree for a record component
3415 -- association list. Instead the Null_Record_Present flag is set in
3416 -- the parent node for the NULL RECORD case.
3417
3418 ------------------------------------------------------
3419 -- 4.3.1 Record Component Association (also 4.3.3) --
3420 ------------------------------------------------------
3421
3422 -- RECORD_COMPONENT_ASSOCIATION ::=
3423 -- [COMPONENT_CHOICE_LIST =>] EXPRESSION
3424
3425 -- N_Component_Association
3426 -- Sloc points to first selector name
3427 -- Choices (List1)
3428 -- Loop_Actions (List2-Sem)
3429 -- Expression (Node3)
3430 -- Box_Present (Flag15)
3431 -- Inherited_Discriminant (Flag13)
3432
3433 -- Note: this structure is used for both record component associations
3434 -- and array component associations, since the two cases aren't always
3435 -- separable by the parser. The choices list may represent either a
3436 -- list of selector names in the record aggregate case, or a list of
3437 -- discrete choices in the array aggregate case or an N_Others_Choice
3438 -- node (which appears as a singleton list). Box_Present gives support
3439 -- to Ada 2005 (AI-287).
3440
3441 ----------------------------------
3442 -- 4.3.1 Component Choice List --
3443 ----------------------------------
3444
3445 -- COMPONENT_CHOICE_LIST ::=
3446 -- component_SELECTOR_NAME {| component_SELECTOR_NAME}
3447 -- | others
3448
3449 -- The entries of a component choice list appear in the Choices list of
3450 -- the associated N_Component_Association, as either selector names, or
3451 -- as an N_Others_Choice node.
3452
3453 --------------------------------
3454 -- 4.3.2 Extension Aggregate --
3455 --------------------------------
3456
3457 -- EXTENSION_AGGREGATE ::=
3458 -- (ANCESTOR_PART with RECORD_COMPONENT_ASSOCIATION_LIST)
3459
3460 -- Note: extension aggregates are not permitted in Ada 83 mode
3461
3462 -- N_Extension_Aggregate
3463 -- Sloc points to left parenthesis
3464 -- Ancestor_Part (Node3)
3465 -- Associated_Node (Node4-Sem)
3466 -- Expressions (List1) (set to No_List if none or null record case)
3467 -- Component_Associations (List2) (set to No_List if none)
3468 -- Null_Record_Present (Flag17)
3469 -- Expansion_Delayed (Flag11-Sem)
3470 -- Has_Self_Reference (Flag13-Sem)
3471 -- plus fields for expression
3472
3473 --------------------------
3474 -- 4.3.2 Ancestor Part --
3475 --------------------------
3476
3477 -- ANCESTOR_PART ::= EXPRESSION | SUBTYPE_MARK
3478
3479 ----------------------------
3480 -- 4.3.3 Array Aggregate --
3481 ----------------------------
3482
3483 -- ARRAY_AGGREGATE ::=
3484 -- POSITIONAL_ARRAY_AGGREGATE | NAMED_ARRAY_AGGREGATE
3485
3486 ---------------------------------------
3487 -- 4.3.3 Positional Array Aggregate --
3488 ---------------------------------------
3489
3490 -- POSITIONAL_ARRAY_AGGREGATE ::=
3491 -- (EXPRESSION, EXPRESSION {, EXPRESSION})
3492 -- | (EXPRESSION {, EXPRESSION}, others => EXPRESSION)
3493
3494 -- See Record_Aggregate (4.3.1) for node structure
3495
3496 ----------------------------------
3497 -- 4.3.3 Named Array Aggregate --
3498 ----------------------------------
3499
3500 -- NAMED_ARRAY_AGGREGATE ::=
3501 -- | (ARRAY_COMPONENT_ASSOCIATION {, ARRAY_COMPONENT_ASSOCIATION})
3502
3503 -- See Record_Aggregate (4.3.1) for node structure
3504
3505 ----------------------------------------
3506 -- 4.3.3 Array Component Association --
3507 ----------------------------------------
3508
3509 -- ARRAY_COMPONENT_ASSOCIATION ::=
3510 -- DISCRETE_CHOICE_LIST => EXPRESSION
3511
3512 -- See Record_Component_Association (4.3.1) for node structure
3513
3514 --------------------------------------------------
3515 -- 4.4 Expression/Relation/Term/Factor/Primary --
3516 --------------------------------------------------
3517
3518 -- EXPRESSION ::=
3519 -- RELATION {LOGICAL_OPERATOR RELATION}
3520
3521 -- CHOICE_EXPRESSION ::=
3522 -- CHOICE_RELATION {LOGICAL_OPERATOR CHOICE_RELATION}
3523
3524 -- CHOICE_RELATION ::=
3525 -- SIMPLE_EXPRESSION [RELATIONAL_OPERATOR SIMPLE_EXPRESSION]
3526
3527 -- RELATION ::=
3528 -- SIMPLE_EXPRESSION [not] in MEMBERSHIP_CHOICE_LIST
3529
3530 -- MEMBERSHIP_CHOICE_LIST ::=
3531 -- MEMBERSHIP_CHOICE {'|' MEMBERSHIP CHOICE}
3532
3533 -- MEMBERSHIP_CHOICE ::=
3534 -- CHOICE_EXPRESSION | RANGE | SUBTYPE_MARK
3535
3536 -- LOGICAL_OPERATOR ::= and | and then | or | or else | xor
3537
3538 -- SIMPLE_EXPRESSION ::=
3539 -- [UNARY_ADDING_OPERATOR] TERM {BINARY_ADDING_OPERATOR TERM}
3540
3541 -- TERM ::= FACTOR {MULTIPLYING_OPERATOR FACTOR}
3542
3543 -- FACTOR ::= PRIMARY [** PRIMARY] | abs PRIMARY | not PRIMARY
3544
3545 -- No nodes are generated for any of these constructs. Instead, the
3546 -- node for the operator appears directly. When we refer to an
3547 -- expression in this description, we mean any of the possible
3548 -- constituent components of an expression (e.g. identifier is
3549 -- an example of an expression).
3550
3551 -- Note: the above syntax is that Ada 2012 syntax which restricts
3552 -- choice relations to simple expressions to avoid ambiguities in
3553 -- some contexts with set membership notation. It has been decided
3554 -- that in retrospect, the Ada 95 change allowing general expressions
3555 -- in this context was a mistake, so we have reverted to the above
3556 -- syntax in Ada 95 and Ada 2005 modes (the restriction to simple
3557 -- expressions was there in Ada 83 from the start).
3558
3559 ------------------
3560 -- 4.4 Primary --
3561 ------------------
3562
3563 -- PRIMARY ::=
3564 -- NUMERIC_LITERAL | null
3565 -- | STRING_LITERAL | AGGREGATE
3566 -- | NAME | QUALIFIED_EXPRESSION
3567 -- | ALLOCATOR | (EXPRESSION)
3568
3569 -- Usually there is no explicit node in the tree for primary. Instead
3570 -- the constituent (e.g. AGGREGATE) appears directly. There are two
3571 -- exceptions. First, there is an explicit node for a null primary.
3572
3573 -- N_Null
3574 -- Sloc points to NULL
3575 -- plus fields for expression
3576
3577 -- Second, the case of (EXPRESSION) is handled specially. Ada requires
3578 -- that the parser keep track of which subexpressions are enclosed
3579 -- in parentheses, and how many levels of parentheses are used. This
3580 -- information is required for optimization purposes, and also for
3581 -- some semantic checks (e.g. (((1))) in a procedure spec does not
3582 -- conform with ((((1)))) in the body).
3583
3584 -- The parentheses are recorded by keeping a Paren_Count field in every
3585 -- subexpression node (it is actually present in all nodes, but only
3586 -- used in subexpression nodes). This count records the number of
3587 -- levels of parentheses. If the number of levels in the source exceeds
3588 -- the maximum accommodated by this count, then the count is simply left
3589 -- at the maximum value. This means that there are some pathological
3590 -- cases of failure to detect conformance failures (e.g. an expression
3591 -- with 500 levels of parens will conform with one with 501 levels),
3592 -- but we do not need to lose sleep over this.
3593
3594 -- Historical note: in versions of GNAT prior to 1.75, there was a node
3595 -- type N_Parenthesized_Expression used to accurately record unlimited
3596 -- numbers of levels of parentheses. However, it turned out to be a
3597 -- real nuisance to have to take into account the possible presence of
3598 -- this node during semantic analysis, since basically parentheses have
3599 -- zero relevance to semantic analysis.
3600
3601 -- Note: the level of parentheses always present in things like
3602 -- aggregates does not count, only the parentheses in the primary
3603 -- (EXPRESSION) affect the setting of the Paren_Count field.
3604
3605 -- 2nd Note: the contents of the Expression field must be ignored (i.e.
3606 -- treated as though it were Empty) if No_Initialization is set True.
3607
3608 --------------------------------------
3609 -- 4.5 Short Circuit Control Forms --
3610 --------------------------------------
3611
3612 -- EXPRESSION ::=
3613 -- RELATION {and then RELATION} | RELATION {or else RELATION}
3614
3615 -- Gigi restriction: For both these control forms, the operand and
3616 -- result types are always Standard.Boolean. The expander inserts the
3617 -- required conversion operations where needed to ensure this is the
3618 -- case.
3619
3620 -- N_And_Then
3621 -- Sloc points to AND of AND THEN
3622 -- Left_Opnd (Node2)
3623 -- Right_Opnd (Node3)
3624 -- Actions (List1-Sem)
3625 -- plus fields for expression
3626
3627 -- N_Or_Else
3628 -- Sloc points to OR of OR ELSE
3629 -- Left_Opnd (Node2)
3630 -- Right_Opnd (Node3)
3631 -- Actions (List1-Sem)
3632 -- plus fields for expression
3633
3634 -- Note: The Actions field is used to hold actions associated with
3635 -- the right hand operand. These have to be treated specially since
3636 -- they are not unconditionally executed. See Insert_Actions for a
3637 -- more detailed description of how these actions are handled.
3638
3639 ---------------------------
3640 -- 4.5 Membership Tests --
3641 ---------------------------
3642
3643 -- RELATION ::=
3644 -- SIMPLE_EXPRESSION [not] in MEMBERSHIP_CHOICE_LIST
3645
3646 -- MEMBERSHIP_CHOICE_LIST ::=
3647 -- MEMBERSHIP_CHOICE {'|' MEMBERSHIP CHOICE}
3648
3649 -- MEMBERSHIP_CHOICE ::=
3650 -- CHOICE_EXPRESSION | RANGE | SUBTYPE_MARK
3651
3652 -- Note: although the grammar above allows only a range or a subtype
3653 -- mark, the parser in fact will accept any simple expression in place
3654 -- of a subtype mark. This means that the semantic analyzer must be able
3655 -- to deal with, and diagnose a simple expression other than a name for
3656 -- the right operand. This simplifies error recovery in the parser.
3657
3658 -- The Alternatives field below is present only if there is more
3659 -- than one Membership_Choice present (which is legitimate only in
3660 -- Ada 2012 mode) in which case Right_Opnd is Empty, and Alternatives
3661 -- contains the list of choices. In the tree passed to the back end,
3662 -- Alternatives is always No_List, and Right_Opnd is set (i.e. the
3663 -- expansion circuitry expands out the complex set membership case
3664 -- using simple membership operations).
3665
3666 -- Should we rename Alternatives here to Membership_Choices ???
3667
3668 -- N_In
3669 -- Sloc points to IN
3670 -- Left_Opnd (Node2)
3671 -- Right_Opnd (Node3)
3672 -- Alternatives (List4) (set to No_List if only one set alternative)
3673 -- plus fields for expression
3674
3675 -- N_Not_In
3676 -- Sloc points to NOT of NOT IN
3677 -- Left_Opnd (Node2)
3678 -- Right_Opnd (Node3)
3679 -- Alternatives (List4) (set to No_List if only one set alternative)
3680 -- plus fields for expression
3681
3682 --------------------
3683 -- 4.5 Operators --
3684 --------------------
3685
3686 -- LOGICAL_OPERATOR ::= and | or | xor
3687
3688 -- RELATIONAL_OPERATOR ::= = | /= | < | <= | > | >=
3689
3690 -- BINARY_ADDING_OPERATOR ::= + | - | &
3691
3692 -- UNARY_ADDING_OPERATOR ::= + | -
3693
3694 -- MULTIPLYING_OPERATOR ::= * | / | mod | rem
3695
3696 -- HIGHEST_PRECEDENCE_OPERATOR ::= ** | abs | not
3697
3698 -- Sprint syntax if Treat_Fixed_As_Integer is set:
3699
3700 -- x #* y
3701 -- x #/ y
3702 -- x #mod y
3703 -- x #rem y
3704
3705 -- Gigi restriction: For * / mod rem with fixed-point operands, Gigi
3706 -- will only be given nodes with the Treat_Fixed_As_Integer flag set.
3707 -- All handling of smalls for multiplication and division is handled
3708 -- by the front end (mod and rem result only from expansion). Gigi
3709 -- thus never needs to worry about small values (for other operators
3710 -- operating on fixed-point, e.g. addition, the small value does not
3711 -- have any semantic effect anyway, these are always integer operations.
3712
3713 -- Gigi restriction: For all operators taking Boolean operands, the
3714 -- type is always Standard.Boolean. The expander inserts the required
3715 -- conversion operations where needed to ensure this is the case.
3716
3717 -- N_Op_And
3718 -- Sloc points to AND
3719 -- Do_Length_Check (Flag4-Sem)
3720 -- plus fields for binary operator
3721 -- plus fields for expression
3722
3723 -- N_Op_Or
3724 -- Sloc points to OR
3725 -- Do_Length_Check (Flag4-Sem)
3726 -- plus fields for binary operator
3727 -- plus fields for expression
3728
3729 -- N_Op_Xor
3730 -- Sloc points to XOR
3731 -- Do_Length_Check (Flag4-Sem)
3732 -- plus fields for binary operator
3733 -- plus fields for expression
3734
3735 -- N_Op_Eq
3736 -- Sloc points to =
3737 -- plus fields for binary operator
3738 -- plus fields for expression
3739
3740 -- N_Op_Ne
3741 -- Sloc points to /=
3742 -- plus fields for binary operator
3743 -- plus fields for expression
3744
3745 -- N_Op_Lt
3746 -- Sloc points to <
3747 -- plus fields for binary operator
3748 -- plus fields for expression
3749
3750 -- N_Op_Le
3751 -- Sloc points to <=
3752 -- plus fields for binary operator
3753 -- plus fields for expression
3754
3755 -- N_Op_Gt
3756 -- Sloc points to >
3757 -- plus fields for binary operator
3758 -- plus fields for expression
3759
3760 -- N_Op_Ge
3761 -- Sloc points to >=
3762 -- plus fields for binary operator
3763 -- plus fields for expression
3764
3765 -- N_Op_Add
3766 -- Sloc points to + (binary)
3767 -- plus fields for binary operator
3768 -- plus fields for expression
3769
3770 -- N_Op_Subtract
3771 -- Sloc points to - (binary)
3772 -- plus fields for binary operator
3773 -- plus fields for expression
3774
3775 -- N_Op_Concat
3776 -- Sloc points to &
3777 -- Is_Component_Left_Opnd (Flag13-Sem)
3778 -- Is_Component_Right_Opnd (Flag14-Sem)
3779 -- plus fields for binary operator
3780 -- plus fields for expression
3781
3782 -- N_Op_Multiply
3783 -- Sloc points to *
3784 -- Treat_Fixed_As_Integer (Flag14-Sem)
3785 -- Rounded_Result (Flag18-Sem)
3786 -- plus fields for binary operator
3787 -- plus fields for expression
3788
3789 -- N_Op_Divide
3790 -- Sloc points to /
3791 -- Treat_Fixed_As_Integer (Flag14-Sem)
3792 -- Do_Division_Check (Flag13-Sem)
3793 -- Rounded_Result (Flag18-Sem)
3794 -- plus fields for binary operator
3795 -- plus fields for expression
3796
3797 -- N_Op_Mod
3798 -- Sloc points to MOD
3799 -- Treat_Fixed_As_Integer (Flag14-Sem)
3800 -- Do_Division_Check (Flag13-Sem)
3801 -- plus fields for binary operator
3802 -- plus fields for expression
3803
3804 -- N_Op_Rem
3805 -- Sloc points to REM
3806 -- Treat_Fixed_As_Integer (Flag14-Sem)
3807 -- Do_Division_Check (Flag13-Sem)
3808 -- plus fields for binary operator
3809 -- plus fields for expression
3810
3811 -- N_Op_Expon
3812 -- Is_Power_Of_2_For_Shift (Flag13-Sem)
3813 -- Sloc points to **
3814 -- plus fields for binary operator
3815 -- plus fields for expression
3816
3817 -- N_Op_Plus
3818 -- Sloc points to + (unary)
3819 -- plus fields for unary operator
3820 -- plus fields for expression
3821
3822 -- N_Op_Minus
3823 -- Sloc points to - (unary)
3824 -- plus fields for unary operator
3825 -- plus fields for expression
3826
3827 -- N_Op_Abs
3828 -- Sloc points to ABS
3829 -- plus fields for unary operator
3830 -- plus fields for expression
3831
3832 -- N_Op_Not
3833 -- Sloc points to NOT
3834 -- plus fields for unary operator
3835 -- plus fields for expression
3836
3837 -- See also shift operators in section B.2
3838
3839 -- Note on fixed-point operations passed to Gigi: For adding operators,
3840 -- the semantics is to treat these simply as integer operations, with
3841 -- the small values being ignored (the bounds are already stored in
3842 -- units of small, so that constraint checking works as usual). For the
3843 -- case of multiply/divide/rem/mod operations, Gigi will only see fixed
3844 -- point operands if the Treat_Fixed_As_Integer flag is set and will
3845 -- thus treat these nodes in identical manner, ignoring small values.
3846
3847 ---------------------------------
3848 -- 4.5.9 Quantified Expression --
3849 ---------------------------------
3850
3851 -- QUANTIFIED_EXPRESSION ::=
3852 -- for QUANTIFIER LOOP_PARAMETER_SPECIFICATION => PREDICATE
3853 -- | for QUANTIFIER ITERATOR_SPECIFICATION => PREDICATE
3854 --
3855 -- QUANTIFIER ::= all | some
3856
3857 -- At most one of (Iterator_Specification, Loop_Parameter_Specification)
3858 -- is present at a time, in which case the other one is empty.
3859
3860 -- N_Quantified_Expression
3861 -- Sloc points to FOR
3862 -- Iterator_Specification (Node2)
3863 -- Loop_Parameter_Specification (Node4)
3864 -- Condition (Node1)
3865 -- All_Present (Flag15)
3866
3867 --------------------------
3868 -- 4.6 Type Conversion --
3869 --------------------------
3870
3871 -- TYPE_CONVERSION ::=
3872 -- SUBTYPE_MARK (EXPRESSION) | SUBTYPE_MARK (NAME)
3873
3874 -- In the (NAME) case, the name is stored as the expression
3875
3876 -- Note: the parser never generates a type conversion node, since it
3877 -- looks like an indexed component which is generated by preference.
3878 -- The semantic pass must correct this misidentification.
3879
3880 -- Gigi handles conversions that involve no change in the root type,
3881 -- and also all conversions from integer to floating-point types.
3882 -- Conversions from floating-point to integer are only handled in
3883 -- the case where Float_Truncate flag set. Other conversions from
3884 -- floating-point to integer (involving rounding) and all conversions
3885 -- involving fixed-point types are handled by the expander.
3886
3887 -- Sprint syntax if Float_Truncate set: X^(Y)
3888 -- Sprint syntax if Conversion_OK set X?(Y)
3889 -- Sprint syntax if both flags set X?^(Y)
3890
3891 -- Note: If either the operand or result type is fixed-point, Gigi will
3892 -- only see a type conversion node with Conversion_OK set. The front end
3893 -- takes care of all handling of small's for fixed-point conversions.
3894
3895 -- N_Type_Conversion
3896 -- Sloc points to first token of subtype mark
3897 -- Subtype_Mark (Node4)
3898 -- Expression (Node3)
3899 -- Do_Tag_Check (Flag13-Sem)
3900 -- Do_Length_Check (Flag4-Sem)
3901 -- Do_Overflow_Check (Flag17-Sem)
3902 -- Float_Truncate (Flag11-Sem)
3903 -- Rounded_Result (Flag18-Sem)
3904 -- Conversion_OK (Flag14-Sem)
3905 -- plus fields for expression
3906
3907 -- Note: if a range check is required, then the Do_Range_Check flag
3908 -- is set in the Expression with the check being done against the
3909 -- target type range (after the base type conversion, if any).
3910
3911 -------------------------------
3912 -- 4.7 Qualified Expression --
3913 -------------------------------
3914
3915 -- QUALIFIED_EXPRESSION ::=
3916 -- SUBTYPE_MARK ' (EXPRESSION) | SUBTYPE_MARK ' AGGREGATE
3917
3918 -- Note: the parentheses in the (EXPRESSION) case are deemed to enclose
3919 -- the expression, so the Expression field of this node always points
3920 -- to a parenthesized expression in this case (i.e. Paren_Count will
3921 -- always be non-zero for the referenced expression if it is not an
3922 -- aggregate).
3923
3924 -- N_Qualified_Expression
3925 -- Sloc points to apostrophe
3926 -- Subtype_Mark (Node4)
3927 -- Expression (Node3) expression or aggregate
3928 -- plus fields for expression
3929
3930 --------------------
3931 -- 4.8 Allocator --
3932 --------------------
3933
3934 -- ALLOCATOR ::=
3935 -- new [NULL_EXCLUSION] SUBTYPE_INDICATION | new QUALIFIED_EXPRESSION
3936
3937 -- Sprint syntax (when storage pool present)
3938 -- new xxx (storage_pool = pool)
3939
3940 -- N_Allocator
3941 -- Sloc points to NEW
3942 -- Expression (Node3) subtype indication or qualified expression
3943 -- Storage_Pool (Node1-Sem)
3944 -- Procedure_To_Call (Node2-Sem)
3945 -- Coextensions (Elist4-Sem)
3946 -- Null_Exclusion_Present (Flag11)
3947 -- No_Initialization (Flag13-Sem)
3948 -- Is_Static_Coextension (Flag14-Sem)
3949 -- Do_Storage_Check (Flag17-Sem)
3950 -- Is_Dynamic_Coextension (Flag18-Sem)
3951 -- plus fields for expression
3952
3953 -- Note: like all nodes, the N_Allocator has the Comes_From_Source flag.
3954 -- This flag has a special function in conjunction with the restriction
3955 -- No_Implicit_Heap_Allocations, which will be triggered if this flag
3956 -- is not set. This means that if a source allocator is replaced with
3957 -- a constructed allocator, the Comes_From_Source flag should be copied
3958 -- to the newly created allocator.
3959
3960 ---------------------------------
3961 -- 5.1 Sequence Of Statements --
3962 ---------------------------------
3963
3964 -- SEQUENCE_OF_STATEMENTS ::= STATEMENT {STATEMENT}
3965
3966 -- Note: Although the parser will not accept a declaration as a
3967 -- statement, the semantic analyzer may insert declarations (e.g.
3968 -- declarations of implicit types needed for execution of other
3969 -- statements) into a sequence of statements, so the code generator
3970 -- should be prepared to accept a declaration where a statement is
3971 -- expected. Note also that pragmas can appear as statements.
3972
3973 --------------------
3974 -- 5.1 Statement --
3975 --------------------
3976
3977 -- STATEMENT ::=
3978 -- {LABEL} SIMPLE_STATEMENT | {LABEL} COMPOUND_STATEMENT
3979
3980 -- There is no explicit node in the tree for a statement. Instead, the
3981 -- individual statement appears directly. Labels are treated as a
3982 -- kind of statement, i.e. they are linked into a statement list at
3983 -- the point they appear, so the labeled statement appears following
3984 -- the label or labels in the statement list.
3985
3986 ---------------------------
3987 -- 5.1 Simple Statement --
3988 ---------------------------
3989
3990 -- SIMPLE_STATEMENT ::= NULL_STATEMENT
3991 -- | ASSIGNMENT_STATEMENT | EXIT_STATEMENT
3992 -- | GOTO_STATEMENT | PROCEDURE_CALL_STATEMENT
3993 -- | SIMPLE_RETURN_STATEMENT | ENTRY_CALL_STATEMENT
3994 -- | REQUEUE_STATEMENT | DELAY_STATEMENT
3995 -- | ABORT_STATEMENT | RAISE_STATEMENT
3996 -- | CODE_STATEMENT
3997
3998 -----------------------------
3999 -- 5.1 Compound Statement --
4000 -----------------------------
4001
4002 -- COMPOUND_STATEMENT ::=
4003 -- IF_STATEMENT | CASE_STATEMENT
4004 -- | LOOP_STATEMENT | BLOCK_STATEMENT
4005 -- | EXTENDED_RETURN_STATEMENT
4006 -- | ACCEPT_STATEMENT | SELECT_STATEMENT
4007
4008 -------------------------
4009 -- 5.1 Null Statement --
4010 -------------------------
4011
4012 -- NULL_STATEMENT ::= null;
4013
4014 -- N_Null_Statement
4015 -- Sloc points to NULL
4016
4017 ----------------
4018 -- 5.1 Label --
4019 ----------------
4020
4021 -- LABEL ::= <<label_STATEMENT_IDENTIFIER>>
4022
4023 -- Note that the occurrence of a label is not a defining identifier,
4024 -- but rather a referencing occurrence. The defining occurrence is
4025 -- in the implicit label declaration which occurs in the innermost
4026 -- enclosing block.
4027
4028 -- N_Label
4029 -- Sloc points to <<
4030 -- Identifier (Node1) direct name of statement identifier
4031 -- Exception_Junk (Flag8-Sem)
4032
4033 -- Note: Before Ada 2012, a label is always followed by a statement,
4034 -- and this is true in the tree even in Ada 2012 mode (the parser
4035 -- inserts a null statement marked with Comes_From_Source False).
4036
4037 -------------------------------
4038 -- 5.1 Statement Identifier --
4039 -------------------------------
4040
4041 -- STATEMENT_IDENTIFIER ::= DIRECT_NAME
4042
4043 -- The IDENTIFIER of a STATEMENT_IDENTIFIER shall be an identifier
4044 -- (not an OPERATOR_SYMBOL)
4045
4046 -------------------------------
4047 -- 5.2 Assignment Statement --
4048 -------------------------------
4049
4050 -- ASSIGNMENT_STATEMENT ::=
4051 -- variable_NAME := EXPRESSION;
4052
4053 -- N_Assignment_Statement
4054 -- Sloc points to :=
4055 -- Name (Node2)
4056 -- Expression (Node3)
4057 -- Do_Tag_Check (Flag13-Sem)
4058 -- Do_Length_Check (Flag4-Sem)
4059 -- Forwards_OK (Flag5-Sem)
4060 -- Backwards_OK (Flag6-Sem)
4061 -- No_Ctrl_Actions (Flag7-Sem)
4062 -- Componentwise_Assignment (Flag14-Sem)
4063 -- Suppress_Assignment_Checks (Flag18-Sem)
4064
4065 -- Note: if a range check is required, then the Do_Range_Check flag
4066 -- is set in the Expression (right hand side), with the check b6ing
4067 -- done against the type of the Name (left hand side).
4068
4069 -- Note: the back end places some restrictions on the form of the
4070 -- Expression field. If the object being assigned to is Atomic, then
4071 -- the Expression may not have the form of an aggregate (since this
4072 -- might cause the back end to generate separate assignments). In this
4073 -- case the front end must generate an extra temporary and initialize
4074 -- this temporary as required (the temporary itself is not atomic).
4075
4076 -----------------------
4077 -- 5.3 If Statement --
4078 -----------------------
4079
4080 -- IF_STATEMENT ::=
4081 -- if CONDITION then
4082 -- SEQUENCE_OF_STATEMENTS
4083 -- {elsif CONDITION then
4084 -- SEQUENCE_OF_STATEMENTS}
4085 -- [else
4086 -- SEQUENCE_OF_STATEMENTS]
4087 -- end if;
4088
4089 -- Gigi restriction: This expander ensures that the type of the
4090 -- Condition fields is always Standard.Boolean, even if the type
4091 -- in the source is some non-standard boolean type.
4092
4093 -- N_If_Statement
4094 -- Sloc points to IF
4095 -- Condition (Node1)
4096 -- Then_Statements (List2)
4097 -- Elsif_Parts (List3) (set to No_List if none present)
4098 -- Else_Statements (List4) (set to No_List if no else part present)
4099 -- End_Span (Uint5) (set to No_Uint if expander generated)
4100
4101 -- N_Elsif_Part
4102 -- Sloc points to ELSIF
4103 -- Condition (Node1)
4104 -- Then_Statements (List2)
4105 -- Condition_Actions (List3-Sem)
4106
4107 --------------------
4108 -- 5.3 Condition --
4109 --------------------
4110
4111 -- CONDITION ::= boolean_EXPRESSION
4112
4113 -------------------------
4114 -- 5.4 Case Statement --
4115 -------------------------
4116
4117 -- CASE_STATEMENT ::=
4118 -- case EXPRESSION is
4119 -- CASE_STATEMENT_ALTERNATIVE
4120 -- {CASE_STATEMENT_ALTERNATIVE}
4121 -- end case;
4122
4123 -- Note: the Alternatives can contain pragmas. These only occur at
4124 -- the start of the list, since any pragmas occurring after the first
4125 -- alternative are absorbed into the corresponding statement sequence.
4126
4127 -- N_Case_Statement
4128 -- Sloc points to CASE
4129 -- Expression (Node3)
4130 -- Alternatives (List4)
4131 -- End_Span (Uint5) (set to No_Uint if expander generated)
4132
4133 -- Note: Before Ada 2012, a pragma in a statement sequence is always
4134 -- followed by a statement, and this is true in the tree even in Ada
4135 -- 2012 mode (the parser inserts a null statement marked with the flag
4136 -- Comes_From_Source False).
4137
4138 -------------------------------------
4139 -- 5.4 Case Statement Alternative --
4140 -------------------------------------
4141
4142 -- CASE_STATEMENT_ALTERNATIVE ::=
4143 -- when DISCRETE_CHOICE_LIST =>
4144 -- SEQUENCE_OF_STATEMENTS
4145
4146 -- N_Case_Statement_Alternative
4147 -- Sloc points to WHEN
4148 -- Discrete_Choices (List4)
4149 -- Statements (List3)
4150
4151 -------------------------
4152 -- 5.5 Loop Statement --
4153 -------------------------
4154
4155 -- LOOP_STATEMENT ::=
4156 -- [loop_STATEMENT_IDENTIFIER :]
4157 -- [ITERATION_SCHEME] loop
4158 -- SEQUENCE_OF_STATEMENTS
4159 -- end loop [loop_IDENTIFIER];
4160
4161 -- Note: The occurrence of a loop label is not a defining identifier
4162 -- but rather a referencing occurrence. The defining occurrence is in
4163 -- the implicit label declaration which occurs in the innermost
4164 -- enclosing block.
4165
4166 -- Note: there is always a loop statement identifier present in
4167 -- the tree, even if none was given in the source. In the case where
4168 -- no loop identifier is given in the source, the parser creates
4169 -- a name of the form _Loop_n, where n is a decimal integer (the
4170 -- two underlines ensure that the loop names created in this manner
4171 -- do not conflict with any user defined identifiers), and the flag
4172 -- Has_Created_Identifier is set to True. The only exception to the
4173 -- rule that all loop statement nodes have identifiers occurs for
4174 -- loops constructed by the expander, and the semantic analyzer will
4175 -- create and supply dummy loop identifiers in these cases.
4176
4177 -- N_Loop_Statement
4178 -- Sloc points to LOOP
4179 -- Identifier (Node1) loop identifier (set to Empty if no identifier)
4180 -- Iteration_Scheme (Node2) (set to Empty if no iteration scheme)
4181 -- Statements (List3)
4182 -- End_Label (Node4)
4183 -- Has_Created_Identifier (Flag15)
4184 -- Is_Null_Loop (Flag16)
4185 -- Suppress_Loop_Warnings (Flag17)
4186
4187 -- Note: the parser fills in the Identifier field if there is an
4188 -- explicit loop identifier. Otherwise the parser leaves this field
4189 -- set to Empty, and then the semantic processing for a loop statement
4190 -- creates an identifier, setting the Has_Created_Identifier flag to
4191 -- True. So after semantic anlaysis, the Identifier is always set,
4192 -- referencing an identifier whose entity has an Ekind of E_Loop.
4193
4194 --------------------------
4195 -- 5.5 Iteration Scheme --
4196 --------------------------
4197
4198 -- ITERATION_SCHEME ::=
4199 -- while CONDITION
4200 -- | for LOOP_PARAMETER_SPECIFICATION
4201 -- | for ITERATOR_SPECIFICATION
4202
4203 -- At most one of (Iterator_Specification, Loop_Parameter_Specification)
4204 -- is present at a time, in which case the other one is empty. Both are
4205 -- empty in the case of a WHILE loop.
4206
4207 -- Gigi restriction: This expander ensures that the type of the
4208 -- Condition field is always Standard.Boolean, even if the type
4209 -- in the source is some non-standard boolean type.
4210
4211 -- N_Iteration_Scheme
4212 -- Sloc points to WHILE or FOR
4213 -- Condition (Node1) (set to Empty if FOR case)
4214 -- Condition_Actions (List3-Sem)
4215 -- Iterator_Specification (Node2) (set to Empty if WHILE case)
4216 -- Loop_Parameter_Specification (Node4) (set to Empty if WHILE case)
4217
4218 ---------------------------------------
4219 -- 5.5 Loop parameter specification --
4220 ---------------------------------------
4221
4222 -- LOOP_PARAMETER_SPECIFICATION ::=
4223 -- DEFINING_IDENTIFIER in [reverse] DISCRETE_SUBTYPE_DEFINITION
4224
4225 -- N_Loop_Parameter_Specification
4226 -- Sloc points to first identifier
4227 -- Defining_Identifier (Node1)
4228 -- Reverse_Present (Flag15)
4229 -- Discrete_Subtype_Definition (Node4)
4230
4231 ----------------------------------
4232 -- 5.5.1 Iterator specification --
4233 ----------------------------------
4234
4235 -- ITERATOR_SPECIFICATION ::=
4236 -- DEFINING_IDENTIFIER in [reverse] NAME
4237 -- | DEFINING_IDENTIFIER [: SUBTYPE_INDICATION] of [reverse] NAME
4238
4239 -- N_Iterator_Specification
4240 -- Sloc points to defining identifier
4241 -- Defining_Identifier (Node1)
4242 -- Name (Node2)
4243 -- Reverse_Present (Flag15)
4244 -- Of_Present (Flag16)
4245 -- Subtype_Indication (Node5)
4246
4247 -- Note: The Of_Present flag distinguishes the two forms
4248
4249 --------------------------
4250 -- 5.6 Block Statement --
4251 --------------------------
4252
4253 -- BLOCK_STATEMENT ::=
4254 -- [block_STATEMENT_IDENTIFIER:]
4255 -- [declare
4256 -- DECLARATIVE_PART]
4257 -- begin
4258 -- HANDLED_SEQUENCE_OF_STATEMENTS
4259 -- end [block_IDENTIFIER];
4260
4261 -- Note that the occurrence of a block identifier is not a defining
4262 -- identifier, but rather a referencing occurrence. The defining
4263 -- occurrence is an E_Block entity declared by the implicit label
4264 -- declaration which occurs in the innermost enclosing block statement
4265 -- or body; the block identifier denotes that E_Block.
4266
4267 -- For block statements that come from source code, there is always a
4268 -- block statement identifier present in the tree, denoting an
4269 -- E_Block. In the case where no block identifier is given in the
4270 -- source, the parser creates a name of the form B_n, where n is a
4271 -- decimal integer, and the flag Has_Created_Identifier is set to
4272 -- True. Blocks constructed by the expander usually have no identifier,
4273 -- and no corresponding entity.
4274
4275 -- Note: the block statement created for an extended return statement
4276 -- has an entity, and this entity is an E_Return_Statement, rather than
4277 -- the usual E_Block.
4278
4279 -- Note: Exception_Junk is set for the wrapping blocks created during
4280 -- local raise optimization (Exp_Ch11.Expand_Local_Exception_Handlers).
4281
4282 -- N_Block_Statement
4283 -- Sloc points to DECLARE or BEGIN
4284 -- Identifier (Node1) block direct name (set to Empty if not present)
4285 -- Declarations (List2) (set to No_List if no DECLARE part)
4286 -- Handled_Statement_Sequence (Node4)
4287 -- Is_Task_Master (Flag5-Sem)
4288 -- Activation_Chain_Entity (Node3-Sem)
4289 -- Has_Created_Identifier (Flag15)
4290 -- Is_Task_Allocation_Block (Flag6)
4291 -- Is_Asynchronous_Call_Block (Flag7)
4292 -- Exception_Junk (Flag8-Sem)
4293
4294 -------------------------
4295 -- 5.7 Exit Statement --
4296 -------------------------
4297
4298 -- EXIT_STATEMENT ::= exit [loop_NAME] [when CONDITION];
4299
4300 -- Gigi restriction: This expander ensures that the type of the
4301 -- Condition field is always Standard.Boolean, even if the type
4302 -- in the source is some non-standard boolean type.
4303
4304 -- N_Exit_Statement
4305 -- Sloc points to EXIT
4306 -- Name (Node2) (set to Empty if no loop name present)
4307 -- Condition (Node1) (set to Empty if no WHEN part present)
4308 -- Next_Exit_Statement (Node3-Sem): Next exit on chain
4309
4310 -------------------------
4311 -- 5.9 Goto Statement --
4312 -------------------------
4313
4314 -- GOTO_STATEMENT ::= goto label_NAME;
4315
4316 -- N_Goto_Statement
4317 -- Sloc points to GOTO
4318 -- Name (Node2)
4319 -- Exception_Junk (Flag8-Sem)
4320
4321 ---------------------------------
4322 -- 6.1 Subprogram Declaration --
4323 ---------------------------------
4324
4325 -- SUBPROGRAM_DECLARATION ::=
4326 -- SUBPROGRAM_SPECIFICATION
4327 -- [ASPECT_SPECIFICATIONS];
4328
4329 -- N_Subprogram_Declaration
4330 -- Sloc points to FUNCTION or PROCEDURE
4331 -- Specification (Node1)
4332 -- Body_To_Inline (Node3-Sem)
4333 -- Corresponding_Body (Node5-Sem)
4334 -- Parent_Spec (Node4-Sem)
4335
4336 ------------------------------------------
4337 -- 6.1 Abstract Subprogram Declaration --
4338 ------------------------------------------
4339
4340 -- ABSTRACT_SUBPROGRAM_DECLARATION ::=
4341 -- SUBPROGRAM_SPECIFICATION is abstract
4342 -- [ASPECT_SPECIFICATIONS];
4343
4344 -- N_Abstract_Subprogram_Declaration
4345 -- Sloc points to ABSTRACT
4346 -- Specification (Node1)
4347
4348 -----------------------------------
4349 -- 6.1 Subprogram Specification --
4350 -----------------------------------
4351
4352 -- SUBPROGRAM_SPECIFICATION ::=
4353 -- [[not] overriding]
4354 -- procedure DEFINING_PROGRAM_UNIT_NAME PARAMETER_PROFILE
4355 -- | [[not] overriding]
4356 -- function DEFINING_DESIGNATOR PARAMETER_AND_RESULT_PROFILE
4357
4358 -- Note: there are no separate nodes for the profiles, instead the
4359 -- information appears directly in the following nodes.
4360
4361 -- N_Function_Specification
4362 -- Sloc points to FUNCTION
4363 -- Defining_Unit_Name (Node1) (the designator)
4364 -- Elaboration_Boolean (Node2-Sem)
4365 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4366 -- Null_Exclusion_Present (Flag11)
4367 -- Result_Definition (Node4) for result subtype
4368 -- Generic_Parent (Node5-Sem)
4369 -- Must_Override (Flag14) set if overriding indicator present
4370 -- Must_Not_Override (Flag15) set if not_overriding indicator present
4371
4372 -- N_Procedure_Specification
4373 -- Sloc points to PROCEDURE
4374 -- Defining_Unit_Name (Node1)
4375 -- Elaboration_Boolean (Node2-Sem)
4376 -- Parameter_Specifications (List3) (set to No_List if no formal part)
4377 -- Generic_Parent (Node5-Sem)
4378 -- Null_Present (Flag13) set for null procedure case (Ada 2005 feature)
4379 -- Must_Override (Flag14) set if overriding indicator present
4380 -- Must_Not_Override (Flag15) set if not_overriding indicator present
4381
4382 -- Note: overriding indicator is an Ada 2005 feature
4383
4384 ---------------------
4385 -- 6.1 Designator --
4386 ---------------------
4387
4388 -- DESIGNATOR ::=
4389 -- [PARENT_UNIT_NAME .] IDENTIFIER | OPERATOR_SYMBOL
4390
4391 -- Designators that are simply identifiers or operator symbols appear
4392 -- directly in the tree in this form. The following node is used only
4393 -- in the case where the designator has a parent unit name component.
4394
4395 -- N_Designator
4396 -- Sloc points to period
4397 -- Name (Node2) holds the parent unit name. Note that this is always
4398 -- non-Empty, since this node is only used for the case where a
4399 -- parent library unit package name is present.
4400 -- Identifier (Node1)
4401
4402 -- Note that the identifier can also be an operator symbol here
4403
4404 ------------------------------
4405 -- 6.1 Defining Designator --
4406 ------------------------------
4407
4408 -- DEFINING_DESIGNATOR ::=
4409 -- DEFINING_PROGRAM_UNIT_NAME | DEFINING_OPERATOR_SYMBOL
4410
4411 -------------------------------------
4412 -- 6.1 Defining Program Unit Name --
4413 -------------------------------------
4414
4415 -- DEFINING_PROGRAM_UNIT_NAME ::=
4416 -- [PARENT_UNIT_NAME .] DEFINING_IDENTIFIER
4417
4418 -- The parent unit name is present only in the case of a child unit
4419 -- name (permissible only for Ada 95 for a library level unit, i.e.
4420 -- a unit at scope level one). If no such name is present, the defining
4421 -- program unit name is represented simply as the defining identifier.
4422 -- In the child unit case, the following node is used to represent the
4423 -- child unit name.
4424
4425 -- N_Defining_Program_Unit_Name
4426 -- Sloc points to period
4427 -- Name (Node2) holds the parent unit name. Note that this is always
4428 -- non-Empty, since this node is only used for the case where a
4429 -- parent unit name is present.
4430 -- Defining_Identifier (Node1)
4431
4432 --------------------------
4433 -- 6.1 Operator Symbol --
4434 --------------------------
4435
4436 -- OPERATOR_SYMBOL ::= STRING_LITERAL
4437
4438 -- Note: the fields of the N_Operator_Symbol node are laid out to
4439 -- match the corresponding fields of an N_Character_Literal node. This
4440 -- allows easy conversion of the operator symbol node into a character
4441 -- literal node in the case where a string constant of the form of an
4442 -- operator symbol is scanned out as such, but turns out semantically
4443 -- to be a string literal that is not an operator. For details see
4444 -- Sinfo.CN.Change_Operator_Symbol_To_String_Literal.
4445
4446 -- N_Operator_Symbol
4447 -- Sloc points to literal
4448 -- Chars (Name1) contains the Name_Id for the operator symbol
4449 -- Strval (Str3) Id of string value. This is used if the operator
4450 -- symbol turns out to be a normal string after all.
4451 -- Entity (Node4-Sem)
4452 -- Associated_Node (Node4-Sem)
4453 -- Has_Private_View (Flag11-Sem) set in generic units.
4454 -- Etype (Node5-Sem)
4455
4456 -- Note: the Strval field may be set to No_String for generated
4457 -- operator symbols that are known not to be string literals
4458 -- semantically.
4459
4460 -----------------------------------
4461 -- 6.1 Defining Operator Symbol --
4462 -----------------------------------
4463
4464 -- DEFINING_OPERATOR_SYMBOL ::= OPERATOR_SYMBOL
4465
4466 -- A defining operator symbol is an entity, which has additional
4467 -- fields depending on the setting of the Ekind field. These
4468 -- additional fields are defined (and access subprograms declared)
4469 -- in package Einfo.
4470
4471 -- Note: N_Defining_Operator_Symbol is an extended node whose fields
4472 -- are deliberately layed out to match the layout of fields in an
4473 -- ordinary N_Operator_Symbol node allowing for easy alteration of
4474 -- an operator symbol node into a defining operator symbol node.
4475 -- See Sinfo.CN.Change_Operator_Symbol_To_Defining_Operator_Symbol
4476 -- for further details.
4477
4478 -- N_Defining_Operator_Symbol
4479 -- Sloc points to literal
4480 -- Chars (Name1) contains the Name_Id for the operator symbol
4481 -- Next_Entity (Node2-Sem)
4482 -- Scope (Node3-Sem)
4483 -- Etype (Node5-Sem)
4484
4485 ----------------------------
4486 -- 6.1 Parameter Profile --
4487 ----------------------------
4488
4489 -- PARAMETER_PROFILE ::= [FORMAL_PART]
4490
4491 ---------------------------------------
4492 -- 6.1 Parameter and Result Profile --
4493 ---------------------------------------
4494
4495 -- PARAMETER_AND_RESULT_PROFILE ::=
4496 -- [FORMAL_PART] return [NULL_EXCLUSION] SUBTYPE_MARK
4497 -- | [FORMAL_PART] return ACCESS_DEFINITION
4498
4499 -- There is no explicit node in the tree for a parameter and result
4500 -- profile. Instead the information appears directly in the parent.
4501
4502 ----------------------
4503 -- 6.1 Formal part --
4504 ----------------------
4505
4506 -- FORMAL_PART ::=
4507 -- (PARAMETER_SPECIFICATION {; PARAMETER_SPECIFICATION})
4508
4509 ----------------------------------
4510 -- 6.1 Parameter specification --
4511 ----------------------------------
4512
4513 -- PARAMETER_SPECIFICATION ::=
4514 -- DEFINING_IDENTIFIER_LIST : MODE [NULL_EXCLUSION] SUBTYPE_MARK
4515 -- [:= DEFAULT_EXPRESSION]
4516 -- | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
4517 -- [:= DEFAULT_EXPRESSION]
4518
4519 -- Although the syntax allows multiple identifiers in the list, the
4520 -- semantics is as though successive specifications were given with
4521 -- identical type definition and expression components. To simplify
4522 -- semantic processing, the parser represents a multiple declaration
4523 -- case as a sequence of single Specifications, using the More_Ids and
4524 -- Prev_Ids flags to preserve the original source form as described
4525 -- in the section on "Handling of Defining Identifier Lists".
4526
4527 -- N_Parameter_Specification
4528 -- Sloc points to first identifier
4529 -- Defining_Identifier (Node1)
4530 -- In_Present (Flag15)
4531 -- Out_Present (Flag17)
4532 -- Null_Exclusion_Present (Flag11)
4533 -- Parameter_Type (Node2) subtype mark or access definition
4534 -- Expression (Node3) (set to Empty if no default expression present)
4535 -- Do_Accessibility_Check (Flag13-Sem)
4536 -- More_Ids (Flag5) (set to False if no more identifiers in list)
4537 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
4538 -- Default_Expression (Node5-Sem)
4539
4540 ---------------
4541 -- 6.1 Mode --
4542 ---------------
4543
4544 -- MODE ::= [in] | in out | out
4545
4546 -- There is no explicit node in the tree for the Mode. Instead the
4547 -- In_Present and Out_Present flags are set in the parent node to
4548 -- record the presence of keywords specifying the mode.
4549
4550 --------------------------
4551 -- 6.3 Subprogram Body --
4552 --------------------------
4553
4554 -- SUBPROGRAM_BODY ::=
4555 -- SUBPROGRAM_SPECIFICATION is
4556 -- DECLARATIVE_PART
4557 -- begin
4558 -- HANDLED_SEQUENCE_OF_STATEMENTS
4559 -- end [DESIGNATOR];
4560
4561 -- N_Subprogram_Body
4562 -- Sloc points to FUNCTION or PROCEDURE
4563 -- Specification (Node1)
4564 -- Declarations (List2)
4565 -- Handled_Statement_Sequence (Node4)
4566 -- Activation_Chain_Entity (Node3-Sem)
4567 -- Corresponding_Spec (Node5-Sem)
4568 -- Acts_As_Spec (Flag4-Sem)
4569 -- Bad_Is_Detected (Flag15) used only by parser
4570 -- Do_Storage_Check (Flag17-Sem)
4571 -- Has_Pragma_Priority (Flag6-Sem)
4572 -- Is_Protected_Subprogram_Body (Flag7-Sem)
4573 -- Is_Entry_Barrier_Function (Flag8-Sem)
4574 -- Is_Task_Master (Flag5-Sem)
4575 -- Was_Originally_Stub (Flag13-Sem)
4576 -- Has_Relative_Deadline_Pragma (Flag9-Sem)
4577 -- Has_Pragma_CPU (Flag14-Sem)
4578
4579 ------------------------------
4580 -- Parameterized Expression --
4581 ------------------------------
4582
4583 -- This is an Ada 2012 extension, we put it here for now, to be labeled
4584 -- and put in its proper section when we know exactly where that is!
4585
4586 -- PARAMETERIZED_EXPRESSION ::=
4587 -- FUNCTION SPECIFICATION IS (EXPRESSION);
4588
4589 -- N_Parameterized_Expression
4590 -- Sloc points to FUNCTION
4591 -- Specification (Node1)
4592 -- Expression (Node3)
4593
4594 -----------------------------------
4595 -- 6.4 Procedure Call Statement --
4596 -----------------------------------
4597
4598 -- PROCEDURE_CALL_STATEMENT ::=
4599 -- procedure_NAME; | procedure_PREFIX ACTUAL_PARAMETER_PART;
4600
4601 -- Note: the reason that a procedure call has expression fields is
4602 -- that it semantically resembles an expression, e.g. overloading is
4603 -- allowed and a type is concocted for semantic processing purposes.
4604 -- Certain of these fields, such as Parens are not relevant, but it
4605 -- is easier to just supply all of them together!
4606
4607 -- N_Procedure_Call_Statement
4608 -- Sloc points to first token of name or prefix
4609 -- Name (Node2) stores name or prefix
4610 -- Parameter_Associations (List3) (set to No_List if no
4611 -- actual parameter part)
4612 -- First_Named_Actual (Node4-Sem)
4613 -- Controlling_Argument (Node1-Sem) (set to Empty if not dispatching)
4614 -- Do_Tag_Check (Flag13-Sem)
4615 -- No_Elaboration_Check (Flag14-Sem)
4616 -- Parameter_List_Truncated (Flag17-Sem)
4617 -- ABE_Is_Certain (Flag18-Sem)
4618 -- plus fields for expression
4619
4620 -- If any IN parameter requires a range check, then the corresponding
4621 -- argument expression has the Do_Range_Check flag set, and the range
4622 -- check is done against the formal type. Note that this argument
4623 -- expression may appear directly in the Parameter_Associations list,
4624 -- or may be a descendent of an N_Parameter_Association node that
4625 -- appears in this list.
4626
4627 ------------------------
4628 -- 6.4 Function Call --
4629 ------------------------
4630
4631 -- FUNCTION_CALL ::=
4632 -- function_NAME | function_PREFIX ACTUAL_PARAMETER_PART
4633
4634 -- Note: the parser may generate an indexed component node or simply
4635 -- a name node instead of a function call node. The semantic pass must
4636 -- correct this misidentification.
4637
4638 -- N_Function_Call
4639 -- Sloc points to first token of name or prefix
4640 -- Name (Node2) stores name or prefix
4641 -- Parameter_Associations (List3) (set to No_List if no
4642 -- actual parameter part)
4643 -- First_Named_Actual (Node4-Sem)
4644 -- Controlling_Argument (Node1-Sem) (set to Empty if not dispatching)
4645 -- Is_Expanded_Build_In_Place_Call (Flag11-Sem)
4646 -- Do_Tag_Check (Flag13-Sem)
4647 -- No_Elaboration_Check (Flag14-Sem)
4648 -- Parameter_List_Truncated (Flag17-Sem)
4649 -- ABE_Is_Certain (Flag18-Sem)
4650 -- plus fields for expression
4651
4652 --------------------------------
4653 -- 6.4 Actual Parameter Part --
4654 --------------------------------
4655
4656 -- ACTUAL_PARAMETER_PART ::=
4657 -- (PARAMETER_ASSOCIATION {,PARAMETER_ASSOCIATION})
4658
4659 --------------------------------
4660 -- 6.4 Parameter Association --
4661 --------------------------------
4662
4663 -- PARAMETER_ASSOCIATION ::=
4664 -- [formal_parameter_SELECTOR_NAME =>] EXPLICIT_ACTUAL_PARAMETER
4665
4666 -- Note: the N_Parameter_Association node is built only if a formal
4667 -- parameter selector name is present, otherwise the parameter
4668 -- association appears in the tree simply as the node for the
4669 -- explicit actual parameter.
4670
4671 -- N_Parameter_Association
4672 -- Sloc points to formal parameter
4673 -- Selector_Name (Node2) (always non-Empty)
4674 -- Explicit_Actual_Parameter (Node3)
4675 -- Next_Named_Actual (Node4-Sem)
4676 -- Is_Accessibility_Actual (Flag13-Sem)
4677
4678 ---------------------------
4679 -- 6.4 Actual Parameter --
4680 ---------------------------
4681
4682 -- EXPLICIT_ACTUAL_PARAMETER ::= EXPRESSION | variable_NAME
4683
4684 ---------------------------
4685 -- 6.5 Return Statement --
4686 ---------------------------
4687
4688 -- RETURN_STATEMENT ::= return [EXPRESSION]; -- Ada 95
4689
4690 -- In Ada 2005, we have:
4691
4692 -- SIMPLE_RETURN_STATEMENT ::= return [EXPRESSION];
4693
4694 -- EXTENDED_RETURN_STATEMENT ::=
4695 -- return DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
4696 -- [:= EXPRESSION] [do
4697 -- HANDLED_SEQUENCE_OF_STATEMENTS
4698 -- end return];
4699
4700 -- RETURN_SUBTYPE_INDICATION ::= SUBTYPE_INDICATION | ACCESS_DEFINITION
4701
4702 -- So in Ada 2005, RETURN_STATEMENT is no longer a nonterminal, but
4703 -- "return statement" is defined in 6.5 to mean a
4704 -- SIMPLE_RETURN_STATEMENT or an EXTENDED_RETURN_STATEMENT.
4705
4706 -- N_Return_Statement
4707 -- Sloc points to RETURN
4708 -- Return_Statement_Entity (Node5-Sem)
4709 -- Expression (Node3) (set to Empty if no expression present)
4710 -- Storage_Pool (Node1-Sem)
4711 -- Procedure_To_Call (Node2-Sem)
4712 -- Do_Tag_Check (Flag13-Sem)
4713 -- By_Ref (Flag5-Sem)
4714 -- Comes_From_Extended_Return_Statement (Flag18-Sem)
4715
4716 -- N_Return_Statement represents a simple_return_statement, and is
4717 -- renamed to be N_Simple_Return_Statement below. Clients should refer
4718 -- to N_Simple_Return_Statement. We retain N_Return_Statement because
4719 -- that's how gigi knows it. See also renaming of Make_Return_Statement
4720 -- as Make_Simple_Return_Statement in Sem_Util.
4721
4722 -- Note: Return_Statement_Entity points to an E_Return_Statement
4723
4724 -- If a range check is required, then Do_Range_Check is set on the
4725 -- Expression. The check is against the return subtype of the function.
4726
4727 -- N_Extended_Return_Statement
4728 -- Sloc points to RETURN
4729 -- Return_Statement_Entity (Node5-Sem)
4730 -- Return_Object_Declarations (List3)
4731 -- Handled_Statement_Sequence (Node4) (set to Empty if not present)
4732 -- Storage_Pool (Node1-Sem)
4733 -- Procedure_To_Call (Node2-Sem)
4734 -- Do_Tag_Check (Flag13-Sem)
4735 -- By_Ref (Flag5-Sem)
4736
4737 -- Note: Return_Statement_Entity points to an E_Return_Statement.
4738
4739 -- Note that Return_Object_Declarations is a list containing the
4740 -- N_Object_Declaration -- see comment on this field above.
4741
4742 -- The declared object will have Is_Return_Object = True.
4743
4744 -- There is no such syntactic category as return_object_declaration
4745 -- in the RM. Return_Object_Declarations represents this portion of
4746 -- the syntax for EXTENDED_RETURN_STATEMENT:
4747 -- DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
4748 -- [:= EXPRESSION]
4749
4750 -- There are two entities associated with an extended_return_statement:
4751 -- the Return_Statement_Entity represents the statement itself, and the
4752 -- Defining_Identifier of the Object_Declaration in
4753 -- Return_Object_Declarations represents the object being
4754 -- returned. N_Simple_Return_Statement has only the former.
4755
4756 ------------------------------
4757 -- 7.1 Package Declaration --
4758 ------------------------------
4759
4760 -- PACKAGE_DECLARATION ::=
4761 -- PACKAGE_SPECIFICATION
4762 -- [ASPECT_SPECIFICATIONS];
4763
4764 -- Note: the activation chain entity for a package spec is used for
4765 -- all tasks declared in the package spec, or in the package body.
4766
4767 -- N_Package_Declaration
4768 -- Sloc points to PACKAGE
4769 -- Specification (Node1)
4770 -- Corresponding_Body (Node5-Sem)
4771 -- Parent_Spec (Node4-Sem)
4772 -- Activation_Chain_Entity (Node3-Sem)
4773
4774 --------------------------------
4775 -- 7.1 Package Specification --
4776 --------------------------------
4777
4778 -- PACKAGE_SPECIFICATION ::=
4779 -- package DEFINING_PROGRAM_UNIT_NAME is
4780 -- {BASIC_DECLARATIVE_ITEM}
4781 -- [private
4782 -- {BASIC_DECLARATIVE_ITEM}]
4783 -- end [[PARENT_UNIT_NAME .] IDENTIFIER]
4784
4785 -- N_Package_Specification
4786 -- Sloc points to PACKAGE
4787 -- Defining_Unit_Name (Node1)
4788 -- Visible_Declarations (List2)
4789 -- Private_Declarations (List3) (set to No_List if no private
4790 -- part present)
4791 -- End_Label (Node4)
4792 -- Generic_Parent (Node5-Sem)
4793 -- Limited_View_Installed (Flag18-Sem)
4794
4795 -----------------------
4796 -- 7.1 Package Body --
4797 -----------------------
4798
4799 -- PACKAGE_BODY ::=
4800 -- package body DEFINING_PROGRAM_UNIT_NAME is
4801 -- DECLARATIVE_PART
4802 -- [begin
4803 -- HANDLED_SEQUENCE_OF_STATEMENTS]
4804 -- end [[PARENT_UNIT_NAME .] IDENTIFIER];
4805
4806 -- N_Package_Body
4807 -- Sloc points to PACKAGE
4808 -- Defining_Unit_Name (Node1)
4809 -- Declarations (List2)
4810 -- Handled_Statement_Sequence (Node4) (set to Empty if no HSS present)
4811 -- Corresponding_Spec (Node5-Sem)
4812 -- Was_Originally_Stub (Flag13-Sem)
4813
4814 -- Note: if a source level package does not contain a handled sequence
4815 -- of statements, then the parser supplies a dummy one with a null
4816 -- sequence of statements. Comes_From_Source will be False in this
4817 -- constructed sequence. The reason we need this is for the End_Label
4818 -- field in the HSS.
4819
4820 -----------------------------------
4821 -- 7.4 Private Type Declaration --
4822 -----------------------------------
4823
4824 -- PRIVATE_TYPE_DECLARATION ::=
4825 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART]
4826 -- is [[abstract] tagged] [limited] private;
4827
4828 -- Note: TAGGED is not permitted in Ada 83 mode
4829
4830 -- N_Private_Type_Declaration
4831 -- Sloc points to TYPE
4832 -- Defining_Identifier (Node1)
4833 -- Discriminant_Specifications (List4) (set to No_List if no
4834 -- discriminant part)
4835 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
4836 -- Abstract_Present (Flag4)
4837 -- Tagged_Present (Flag15)
4838 -- Limited_Present (Flag17)
4839
4840 ----------------------------------------
4841 -- 7.4 Private Extension Declaration --
4842 ----------------------------------------
4843
4844 -- PRIVATE_EXTENSION_DECLARATION ::=
4845 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART] is
4846 -- [abstract] [limited | synchronized]
4847 -- new ancestor_SUBTYPE_INDICATION [and INTERFACE_LIST]
4848 -- with private;
4849
4850 -- Note: LIMITED, and private extension declarations are not allowed
4851 -- in Ada 83 mode.
4852
4853 -- N_Private_Extension_Declaration
4854 -- Sloc points to TYPE
4855 -- Defining_Identifier (Node1)
4856 -- Discriminant_Specifications (List4) (set to No_List if no
4857 -- discriminant part)
4858 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
4859 -- Abstract_Present (Flag4)
4860 -- Limited_Present (Flag17)
4861 -- Synchronized_Present (Flag7)
4862 -- Subtype_Indication (Node5)
4863 -- Interface_List (List2) (set to No_List if none)
4864
4865 ---------------------
4866 -- 8.4 Use Clause --
4867 ---------------------
4868
4869 -- USE_CLAUSE ::= USE_PACKAGE_CLAUSE | USE_TYPE_CLAUSE
4870
4871 -----------------------------
4872 -- 8.4 Use Package Clause --
4873 -----------------------------
4874
4875 -- USE_PACKAGE_CLAUSE ::= use package_NAME {, package_NAME};
4876
4877 -- N_Use_Package_Clause
4878 -- Sloc points to USE
4879 -- Names (List2)
4880 -- Next_Use_Clause (Node3-Sem)
4881 -- Hidden_By_Use_Clause (Elist4-Sem)
4882
4883 --------------------------
4884 -- 8.4 Use Type Clause --
4885 --------------------------
4886
4887 -- USE_TYPE_CLAUSE ::= use [ALL] type SUBTYPE_MARK {, SUBTYPE_MARK};
4888
4889 -- Note: use type clause is not permitted in Ada 83 mode
4890
4891 -- Note: the ALL keyword can appear only in Ada 2012 mode
4892
4893 -- N_Use_Type_Clause
4894 -- Sloc points to USE
4895 -- Subtype_Marks (List2)
4896 -- Next_Use_Clause (Node3-Sem)
4897 -- Hidden_By_Use_Clause (Elist4-Sem)
4898 -- All_Present (Flag15)
4899
4900 -------------------------------
4901 -- 8.5 Renaming Declaration --
4902 -------------------------------
4903
4904 -- RENAMING_DECLARATION ::=
4905 -- OBJECT_RENAMING_DECLARATION
4906 -- | EXCEPTION_RENAMING_DECLARATION
4907 -- | PACKAGE_RENAMING_DECLARATION
4908 -- | SUBPROGRAM_RENAMING_DECLARATION
4909 -- | GENERIC_RENAMING_DECLARATION
4910
4911 --------------------------------------
4912 -- 8.5 Object Renaming Declaration --
4913 --------------------------------------
4914
4915 -- OBJECT_RENAMING_DECLARATION ::=
4916 -- DEFINING_IDENTIFIER :
4917 -- [NULL_EXCLUSION] SUBTYPE_MARK renames object_NAME;
4918 -- | DEFINING_IDENTIFIER :
4919 -- ACCESS_DEFINITION renames object_NAME;
4920
4921 -- Note: Access_Definition is an optional field that gives support to
4922 -- Ada 2005 (AI-230). The parser generates nodes that have either the
4923 -- Subtype_Indication field or else the Access_Definition field.
4924
4925 -- N_Object_Renaming_Declaration
4926 -- Sloc points to first identifier
4927 -- Defining_Identifier (Node1)
4928 -- Null_Exclusion_Present (Flag11) (set to False if not present)
4929 -- Subtype_Mark (Node4) (set to Empty if not present)
4930 -- Access_Definition (Node3) (set to Empty if not present)
4931 -- Name (Node2)
4932 -- Corresponding_Generic_Association (Node5-Sem)
4933
4934 -----------------------------------------
4935 -- 8.5 Exception Renaming Declaration --
4936 -----------------------------------------
4937
4938 -- EXCEPTION_RENAMING_DECLARATION ::=
4939 -- DEFINING_IDENTIFIER : exception renames exception_NAME;
4940
4941 -- N_Exception_Renaming_Declaration
4942 -- Sloc points to first identifier
4943 -- Defining_Identifier (Node1)
4944 -- Name (Node2)
4945
4946 ---------------------------------------
4947 -- 8.5 Package Renaming Declaration --
4948 ---------------------------------------
4949
4950 -- PACKAGE_RENAMING_DECLARATION ::=
4951 -- package DEFINING_PROGRAM_UNIT_NAME renames package_NAME;
4952
4953 -- N_Package_Renaming_Declaration
4954 -- Sloc points to PACKAGE
4955 -- Defining_Unit_Name (Node1)
4956 -- Name (Node2)
4957 -- Parent_Spec (Node4-Sem)
4958
4959 ------------------------------------------
4960 -- 8.5 Subprogram Renaming Declaration --
4961 ------------------------------------------
4962
4963 -- SUBPROGRAM_RENAMING_DECLARATION ::=
4964 -- SUBPROGRAM_SPECIFICATION renames callable_entity_NAME;
4965
4966 -- N_Subprogram_Renaming_Declaration
4967 -- Sloc points to RENAMES
4968 -- Specification (Node1)
4969 -- Name (Node2)
4970 -- Parent_Spec (Node4-Sem)
4971 -- Corresponding_Spec (Node5-Sem)
4972 -- Corresponding_Formal_Spec (Node3-Sem)
4973 -- From_Default (Flag6-Sem)
4974
4975 -----------------------------------------
4976 -- 8.5.5 Generic Renaming Declaration --
4977 -----------------------------------------
4978
4979 -- GENERIC_RENAMING_DECLARATION ::=
4980 -- generic package DEFINING_PROGRAM_UNIT_NAME
4981 -- renames generic_package_NAME
4982 -- | generic procedure DEFINING_PROGRAM_UNIT_NAME
4983 -- renames generic_procedure_NAME
4984 -- | generic function DEFINING_PROGRAM_UNIT_NAME
4985 -- renames generic_function_NAME
4986
4987 -- N_Generic_Package_Renaming_Declaration
4988 -- Sloc points to GENERIC
4989 -- Defining_Unit_Name (Node1)
4990 -- Name (Node2)
4991 -- Parent_Spec (Node4-Sem)
4992
4993 -- N_Generic_Procedure_Renaming_Declaration
4994 -- Sloc points to GENERIC
4995 -- Defining_Unit_Name (Node1)
4996 -- Name (Node2)
4997 -- Parent_Spec (Node4-Sem)
4998
4999 -- N_Generic_Function_Renaming_Declaration
5000 -- Sloc points to GENERIC
5001 -- Defining_Unit_Name (Node1)
5002 -- Name (Node2)
5003 -- Parent_Spec (Node4-Sem)
5004
5005 --------------------------------
5006 -- 9.1 Task Type Declaration --
5007 --------------------------------
5008
5009 -- TASK_TYPE_DECLARATION ::=
5010 -- task type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
5011 -- [is [new INTERFACE_LIST with] TASK_DEFINITION]
5012 -- [ASPECT_SPECIFICATIONS];
5013
5014 -- N_Task_Type_Declaration
5015 -- Sloc points to TASK
5016 -- Defining_Identifier (Node1)
5017 -- Discriminant_Specifications (List4) (set to No_List if no
5018 -- discriminant part)
5019 -- Interface_List (List2) (set to No_List if none)
5020 -- Task_Definition (Node3) (set to Empty if not present)
5021 -- Corresponding_Body (Node5-Sem)
5022
5023 ----------------------------------
5024 -- 9.1 Single Task Declaration --
5025 ----------------------------------
5026
5027 -- SINGLE_TASK_DECLARATION ::=
5028 -- task DEFINING_IDENTIFIER
5029 -- [is [new INTERFACE_LIST with] TASK_DEFINITION]
5030 -- [ASPECT_SPECIFICATIONS];
5031
5032 -- N_Single_Task_Declaration
5033 -- Sloc points to TASK
5034 -- Defining_Identifier (Node1)
5035 -- Interface_List (List2) (set to No_List if none)
5036 -- Task_Definition (Node3) (set to Empty if not present)
5037
5038 --------------------------
5039 -- 9.1 Task Definition --
5040 --------------------------
5041
5042 -- TASK_DEFINITION ::=
5043 -- {TASK_ITEM}
5044 -- [private
5045 -- {TASK_ITEM}]
5046 -- end [task_IDENTIFIER]
5047
5048 -- Note: as a result of semantic analysis, the list of task items can
5049 -- include implicit type declarations resulting from entry families.
5050
5051 -- N_Task_Definition
5052 -- Sloc points to first token of task definition
5053 -- Visible_Declarations (List2)
5054 -- Private_Declarations (List3) (set to No_List if no private part)
5055 -- End_Label (Node4)
5056 -- Has_Pragma_Priority (Flag6-Sem)
5057 -- Has_Storage_Size_Pragma (Flag5-Sem)
5058 -- Has_Task_Info_Pragma (Flag7-Sem)
5059 -- Has_Task_Name_Pragma (Flag8-Sem)
5060 -- Has_Relative_Deadline_Pragma (Flag9-Sem)
5061 -- Has_Pragma_CPU (Flag14-Sem)
5062
5063 --------------------
5064 -- 9.1 Task Item --
5065 --------------------
5066
5067 -- TASK_ITEM ::= ENTRY_DECLARATION | REPRESENTATION_CLAUSE
5068
5069 --------------------
5070 -- 9.1 Task Body --
5071 --------------------
5072
5073 -- TASK_BODY ::=
5074 -- task body task_DEFINING_IDENTIFIER is
5075 -- DECLARATIVE_PART
5076 -- begin
5077 -- HANDLED_SEQUENCE_OF_STATEMENTS
5078 -- end [task_IDENTIFIER];
5079
5080 -- Gigi restriction: This node never appears
5081
5082 -- N_Task_Body
5083 -- Sloc points to TASK
5084 -- Defining_Identifier (Node1)
5085 -- Declarations (List2)
5086 -- Handled_Statement_Sequence (Node4)
5087 -- Is_Task_Master (Flag5-Sem)
5088 -- Activation_Chain_Entity (Node3-Sem)
5089 -- Corresponding_Spec (Node5-Sem)
5090 -- Was_Originally_Stub (Flag13-Sem)
5091
5092 -------------------------------------
5093 -- 9.4 Protected Type Declaration --
5094 -------------------------------------
5095
5096 -- PROTECTED_TYPE_DECLARATION ::=
5097 -- protected type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
5098 -- is [new INTERFACE_LIST with] PROTECTED_DEFINITION
5099 -- {ASPECT_SPECIFICATIONS];
5100
5101 -- Note: protected type declarations are not permitted in Ada 83 mode
5102
5103 -- N_Protected_Type_Declaration
5104 -- Sloc points to PROTECTED
5105 -- Defining_Identifier (Node1)
5106 -- Discriminant_Specifications (List4) (set to No_List if no
5107 -- discriminant part)
5108 -- Interface_List (List2) (set to No_List if none)
5109 -- Protected_Definition (Node3)
5110 -- Corresponding_Body (Node5-Sem)
5111
5112 ---------------------------------------
5113 -- 9.4 Single Protected Declaration --
5114 ---------------------------------------
5115
5116 -- SINGLE_PROTECTED_DECLARATION ::=
5117 -- protected DEFINING_IDENTIFIER
5118 -- is [new INTERFACE_LIST with] PROTECTED_DEFINITION
5119 -- [ASPECT_SPECIFICATIONS];
5120
5121 -- Note: single protected declarations are not allowed in Ada 83 mode
5122
5123 -- N_Single_Protected_Declaration
5124 -- Sloc points to PROTECTED
5125 -- Defining_Identifier (Node1)
5126 -- Interface_List (List2) (set to No_List if none)
5127 -- Protected_Definition (Node3)
5128
5129 -------------------------------
5130 -- 9.4 Protected Definition --
5131 -------------------------------
5132
5133 -- PROTECTED_DEFINITION ::=
5134 -- {PROTECTED_OPERATION_DECLARATION}
5135 -- [private
5136 -- {PROTECTED_ELEMENT_DECLARATION}]
5137 -- end [protected_IDENTIFIER]
5138
5139 -- N_Protected_Definition
5140 -- Sloc points to first token of protected definition
5141 -- Visible_Declarations (List2)
5142 -- Private_Declarations (List3) (set to No_List if no private part)
5143 -- End_Label (Node4)
5144 -- Has_Pragma_Priority (Flag6-Sem)
5145
5146 ------------------------------------------
5147 -- 9.4 Protected Operation Declaration --
5148 ------------------------------------------
5149
5150 -- PROTECTED_OPERATION_DECLARATION ::=
5151 -- SUBPROGRAM_DECLARATION
5152 -- | ENTRY_DECLARATION
5153 -- | REPRESENTATION_CLAUSE
5154
5155 ----------------------------------------
5156 -- 9.4 Protected Element Declaration --
5157 ----------------------------------------
5158
5159 -- PROTECTED_ELEMENT_DECLARATION ::=
5160 -- PROTECTED_OPERATION_DECLARATION | COMPONENT_DECLARATION
5161
5162 -------------------------
5163 -- 9.4 Protected Body --
5164 -------------------------
5165
5166 -- PROTECTED_BODY ::=
5167 -- protected body DEFINING_IDENTIFIER is
5168 -- {PROTECTED_OPERATION_ITEM}
5169 -- end [protected_IDENTIFIER];
5170
5171 -- Note: protected bodies are not allowed in Ada 83 mode
5172
5173 -- Gigi restriction: This node never appears
5174
5175 -- N_Protected_Body
5176 -- Sloc points to PROTECTED
5177 -- Defining_Identifier (Node1)
5178 -- Declarations (List2) protected operation items (and pragmas)
5179 -- End_Label (Node4)
5180 -- Corresponding_Spec (Node5-Sem)
5181 -- Was_Originally_Stub (Flag13-Sem)
5182
5183 -----------------------------------
5184 -- 9.4 Protected Operation Item --
5185 -----------------------------------
5186
5187 -- PROTECTED_OPERATION_ITEM ::=
5188 -- SUBPROGRAM_DECLARATION
5189 -- | SUBPROGRAM_BODY
5190 -- | ENTRY_BODY
5191 -- | REPRESENTATION_CLAUSE
5192
5193 ------------------------------
5194 -- 9.5.2 Entry Declaration --
5195 ------------------------------
5196
5197 -- ENTRY_DECLARATION ::=
5198 -- [[not] overriding]
5199 -- entry DEFINING_IDENTIFIER
5200 -- [(DISCRETE_SUBTYPE_DEFINITION)] PARAMETER_PROFILE;
5201
5202 -- N_Entry_Declaration
5203 -- Sloc points to ENTRY
5204 -- Defining_Identifier (Node1)
5205 -- Discrete_Subtype_Definition (Node4) (set to Empty if not present)
5206 -- Parameter_Specifications (List3) (set to No_List if no formal part)
5207 -- Corresponding_Body (Node5-Sem)
5208 -- Must_Override (Flag14) set if overriding indicator present
5209 -- Must_Not_Override (Flag15) set if not_overriding indicator present
5210
5211 -- Note: overriding indicator is an Ada 2005 feature
5212
5213 -----------------------------
5214 -- 9.5.2 Accept statement --
5215 -----------------------------
5216
5217 -- ACCEPT_STATEMENT ::=
5218 -- accept entry_DIRECT_NAME
5219 -- [(ENTRY_INDEX)] PARAMETER_PROFILE [do
5220 -- HANDLED_SEQUENCE_OF_STATEMENTS
5221 -- end [entry_IDENTIFIER]];
5222
5223 -- Gigi restriction: This node never appears
5224
5225 -- Note: there are no explicit declarations allowed in an accept
5226 -- statement. However, the implicit declarations for any statement
5227 -- identifiers (labels and block/loop identifiers) are declarations
5228 -- that belong logically to the accept statement, and that is why
5229 -- there is a Declarations field in this node.
5230
5231 -- N_Accept_Statement
5232 -- Sloc points to ACCEPT
5233 -- Entry_Direct_Name (Node1)
5234 -- Entry_Index (Node5) (set to Empty if not present)
5235 -- Parameter_Specifications (List3) (set to No_List if no formal part)
5236 -- Handled_Statement_Sequence (Node4)
5237 -- Declarations (List2) (set to No_List if no declarations)
5238
5239 ------------------------
5240 -- 9.5.2 Entry Index --
5241 ------------------------
5242
5243 -- ENTRY_INDEX ::= EXPRESSION
5244
5245 -----------------------
5246 -- 9.5.2 Entry Body --
5247 -----------------------
5248
5249 -- ENTRY_BODY ::=
5250 -- entry DEFINING_IDENTIFIER ENTRY_BODY_FORMAL_PART ENTRY_BARRIER is
5251 -- DECLARATIVE_PART
5252 -- begin
5253 -- HANDLED_SEQUENCE_OF_STATEMENTS
5254 -- end [entry_IDENTIFIER];
5255
5256 -- ENTRY_BARRIER ::= when CONDITION
5257
5258 -- Note: we store the CONDITION of the ENTRY_BARRIER in the node for
5259 -- the ENTRY_BODY_FORMAL_PART to avoid the N_Entry_Body node getting
5260 -- too full (it would otherwise have too many fields)
5261
5262 -- Gigi restriction: This node never appears
5263
5264 -- N_Entry_Body
5265 -- Sloc points to ENTRY
5266 -- Defining_Identifier (Node1)
5267 -- Entry_Body_Formal_Part (Node5)
5268 -- Declarations (List2)
5269 -- Handled_Statement_Sequence (Node4)
5270 -- Activation_Chain_Entity (Node3-Sem)
5271
5272 -----------------------------------
5273 -- 9.5.2 Entry Body Formal Part --
5274 -----------------------------------
5275
5276 -- ENTRY_BODY_FORMAL_PART ::=
5277 -- [(ENTRY_INDEX_SPECIFICATION)] PARAMETER_PROFILE
5278
5279 -- Note that an entry body formal part node is present even if it is
5280 -- empty. This reflects the grammar, in which it is the components of
5281 -- the entry body formal part that are optional, not the entry body
5282 -- formal part itself. Also this means that the barrier condition
5283 -- always has somewhere to be stored.
5284
5285 -- Gigi restriction: This node never appears
5286
5287 -- N_Entry_Body_Formal_Part
5288 -- Sloc points to first token
5289 -- Entry_Index_Specification (Node4) (set to Empty if not present)
5290 -- Parameter_Specifications (List3) (set to No_List if no formal part)
5291 -- Condition (Node1) from entry barrier of entry body
5292
5293 --------------------------
5294 -- 9.5.2 Entry Barrier --
5295 --------------------------
5296
5297 -- ENTRY_BARRIER ::= when CONDITION
5298
5299 --------------------------------------
5300 -- 9.5.2 Entry Index Specification --
5301 --------------------------------------
5302
5303 -- ENTRY_INDEX_SPECIFICATION ::=
5304 -- for DEFINING_IDENTIFIER in DISCRETE_SUBTYPE_DEFINITION
5305
5306 -- Gigi restriction: This node never appears
5307
5308 -- N_Entry_Index_Specification
5309 -- Sloc points to FOR
5310 -- Defining_Identifier (Node1)
5311 -- Discrete_Subtype_Definition (Node4)
5312
5313 ---------------------------------
5314 -- 9.5.3 Entry Call Statement --
5315 ---------------------------------
5316
5317 -- ENTRY_CALL_STATEMENT ::= entry_NAME [ACTUAL_PARAMETER_PART];
5318
5319 -- The parser may generate a procedure call for this construct. The
5320 -- semantic pass must correct this misidentification where needed.
5321
5322 -- Gigi restriction: This node never appears
5323
5324 -- N_Entry_Call_Statement
5325 -- Sloc points to first token of name
5326 -- Name (Node2)
5327 -- Parameter_Associations (List3) (set to No_List if no
5328 -- actual parameter part)
5329 -- First_Named_Actual (Node4-Sem)
5330
5331 ------------------------------
5332 -- 9.5.4 Requeue Statement --
5333 ------------------------------
5334
5335 -- REQUEUE_STATEMENT ::= requeue entry_NAME [with abort];
5336
5337 -- Note: requeue statements are not permitted in Ada 83 mode
5338
5339 -- Gigi restriction: This node never appears
5340
5341 -- N_Requeue_Statement
5342 -- Sloc points to REQUEUE
5343 -- Name (Node2)
5344 -- Abort_Present (Flag15)
5345
5346 --------------------------
5347 -- 9.6 Delay Statement --
5348 --------------------------
5349
5350 -- DELAY_STATEMENT ::=
5351 -- DELAY_UNTIL_STATEMENT
5352 -- | DELAY_RELATIVE_STATEMENT
5353
5354 --------------------------------
5355 -- 9.6 Delay Until Statement --
5356 --------------------------------
5357
5358 -- DELAY_UNTIL_STATEMENT ::= delay until delay_EXPRESSION;
5359
5360 -- Note: delay until statements are not permitted in Ada 83 mode
5361
5362 -- Gigi restriction: This node never appears
5363
5364 -- N_Delay_Until_Statement
5365 -- Sloc points to DELAY
5366 -- Expression (Node3)
5367
5368 -----------------------------------
5369 -- 9.6 Delay Relative Statement --
5370 -----------------------------------
5371
5372 -- DELAY_RELATIVE_STATEMENT ::= delay delay_EXPRESSION;
5373
5374 -- Gigi restriction: This node never appears
5375
5376 -- N_Delay_Relative_Statement
5377 -- Sloc points to DELAY
5378 -- Expression (Node3)
5379
5380 ---------------------------
5381 -- 9.7 Select Statement --
5382 ---------------------------
5383
5384 -- SELECT_STATEMENT ::=
5385 -- SELECTIVE_ACCEPT
5386 -- | TIMED_ENTRY_CALL
5387 -- | CONDITIONAL_ENTRY_CALL
5388 -- | ASYNCHRONOUS_SELECT
5389
5390 -----------------------------
5391 -- 9.7.1 Selective Accept --
5392 -----------------------------
5393
5394 -- SELECTIVE_ACCEPT ::=
5395 -- select
5396 -- [GUARD]
5397 -- SELECT_ALTERNATIVE
5398 -- {or
5399 -- [GUARD]
5400 -- SELECT_ALTERNATIVE}
5401 -- [else
5402 -- SEQUENCE_OF_STATEMENTS]
5403 -- end select;
5404
5405 -- Gigi restriction: This node never appears
5406
5407 -- Note: the guard expression, if present, appears in the node for
5408 -- the select alternative.
5409
5410 -- N_Selective_Accept
5411 -- Sloc points to SELECT
5412 -- Select_Alternatives (List1)
5413 -- Else_Statements (List4) (set to No_List if no else part)
5414
5415 ------------------
5416 -- 9.7.1 Guard --
5417 ------------------
5418
5419 -- GUARD ::= when CONDITION =>
5420
5421 -- As noted above, the CONDITION that is part of a GUARD is included
5422 -- in the node for the select alternative for convenience.
5423
5424 -------------------------------
5425 -- 9.7.1 Select Alternative --
5426 -------------------------------
5427
5428 -- SELECT_ALTERNATIVE ::=
5429 -- ACCEPT_ALTERNATIVE
5430 -- | DELAY_ALTERNATIVE
5431 -- | TERMINATE_ALTERNATIVE
5432
5433 -------------------------------
5434 -- 9.7.1 Accept Alternative --
5435 -------------------------------
5436
5437 -- ACCEPT_ALTERNATIVE ::=
5438 -- ACCEPT_STATEMENT [SEQUENCE_OF_STATEMENTS]
5439
5440 -- Gigi restriction: This node never appears
5441
5442 -- N_Accept_Alternative
5443 -- Sloc points to ACCEPT
5444 -- Accept_Statement (Node2)
5445 -- Condition (Node1) from the guard (set to Empty if no guard present)
5446 -- Statements (List3) (set to Empty_List if no statements)
5447 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5448 -- Accept_Handler_Records (List5-Sem)
5449
5450 ------------------------------
5451 -- 9.7.1 Delay Alternative --
5452 ------------------------------
5453
5454 -- DELAY_ALTERNATIVE ::=
5455 -- DELAY_STATEMENT [SEQUENCE_OF_STATEMENTS]
5456
5457 -- Gigi restriction: This node never appears
5458
5459 -- N_Delay_Alternative
5460 -- Sloc points to DELAY
5461 -- Delay_Statement (Node2)
5462 -- Condition (Node1) from the guard (set to Empty if no guard present)
5463 -- Statements (List3) (set to Empty_List if no statements)
5464 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5465
5466 ----------------------------------
5467 -- 9.7.1 Terminate Alternative --
5468 ----------------------------------
5469
5470 -- TERMINATE_ALTERNATIVE ::= terminate;
5471
5472 -- Gigi restriction: This node never appears
5473
5474 -- N_Terminate_Alternative
5475 -- Sloc points to TERMINATE
5476 -- Condition (Node1) from the guard (set to Empty if no guard present)
5477 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5478 -- Pragmas_After (List5) pragmas after alt (set to No_List if none)
5479
5480 -----------------------------
5481 -- 9.7.2 Timed Entry Call --
5482 -----------------------------
5483
5484 -- TIMED_ENTRY_CALL ::=
5485 -- select
5486 -- ENTRY_CALL_ALTERNATIVE
5487 -- or
5488 -- DELAY_ALTERNATIVE
5489 -- end select;
5490
5491 -- Gigi restriction: This node never appears
5492
5493 -- N_Timed_Entry_Call
5494 -- Sloc points to SELECT
5495 -- Entry_Call_Alternative (Node1)
5496 -- Delay_Alternative (Node4)
5497
5498 -----------------------------------
5499 -- 9.7.2 Entry Call Alternative --
5500 -----------------------------------
5501
5502 -- ENTRY_CALL_ALTERNATIVE ::=
5503 -- PROCEDURE_OR_ENTRY_CALL [SEQUENCE_OF_STATEMENTS]
5504
5505 -- PROCEDURE_OR_ENTRY_CALL ::=
5506 -- PROCEDURE_CALL_STATEMENT | ENTRY_CALL_STATEMENT
5507
5508 -- Gigi restriction: This node never appears
5509
5510 -- N_Entry_Call_Alternative
5511 -- Sloc points to first token of entry call statement
5512 -- Entry_Call_Statement (Node1)
5513 -- Statements (List3) (set to Empty_List if no statements)
5514 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5515
5516 -----------------------------------
5517 -- 9.7.3 Conditional Entry Call --
5518 -----------------------------------
5519
5520 -- CONDITIONAL_ENTRY_CALL ::=
5521 -- select
5522 -- ENTRY_CALL_ALTERNATIVE
5523 -- else
5524 -- SEQUENCE_OF_STATEMENTS
5525 -- end select;
5526
5527 -- Gigi restriction: This node never appears
5528
5529 -- N_Conditional_Entry_Call
5530 -- Sloc points to SELECT
5531 -- Entry_Call_Alternative (Node1)
5532 -- Else_Statements (List4)
5533
5534 --------------------------------
5535 -- 9.7.4 Asynchronous Select --
5536 --------------------------------
5537
5538 -- ASYNCHRONOUS_SELECT ::=
5539 -- select
5540 -- TRIGGERING_ALTERNATIVE
5541 -- then abort
5542 -- ABORTABLE_PART
5543 -- end select;
5544
5545 -- Note: asynchronous select is not permitted in Ada 83 mode
5546
5547 -- Gigi restriction: This node never appears
5548
5549 -- N_Asynchronous_Select
5550 -- Sloc points to SELECT
5551 -- Triggering_Alternative (Node1)
5552 -- Abortable_Part (Node2)
5553
5554 -----------------------------------
5555 -- 9.7.4 Triggering Alternative --
5556 -----------------------------------
5557
5558 -- TRIGGERING_ALTERNATIVE ::=
5559 -- TRIGGERING_STATEMENT [SEQUENCE_OF_STATEMENTS]
5560
5561 -- Gigi restriction: This node never appears
5562
5563 -- N_Triggering_Alternative
5564 -- Sloc points to first token of triggering statement
5565 -- Triggering_Statement (Node1)
5566 -- Statements (List3) (set to Empty_List if no statements)
5567 -- Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5568
5569 ---------------------------------
5570 -- 9.7.4 Triggering Statement --
5571 ---------------------------------
5572
5573 -- TRIGGERING_STATEMENT ::= PROCEDURE_OR_ENTRY_CALL | DELAY_STATEMENT
5574
5575 ---------------------------
5576 -- 9.7.4 Abortable Part --
5577 ---------------------------
5578
5579 -- ABORTABLE_PART ::= SEQUENCE_OF_STATEMENTS
5580
5581 -- Gigi restriction: This node never appears
5582
5583 -- N_Abortable_Part
5584 -- Sloc points to ABORT
5585 -- Statements (List3)
5586
5587 --------------------------
5588 -- 9.8 Abort Statement --
5589 --------------------------
5590
5591 -- ABORT_STATEMENT ::= abort task_NAME {, task_NAME};
5592
5593 -- Gigi restriction: This node never appears
5594
5595 -- N_Abort_Statement
5596 -- Sloc points to ABORT
5597 -- Names (List2)
5598
5599 -------------------------
5600 -- 10.1.1 Compilation --
5601 -------------------------
5602
5603 -- COMPILATION ::= {COMPILATION_UNIT}
5604
5605 -- There is no explicit node in the tree for a compilation, since in
5606 -- general the compiler is processing only a single compilation unit
5607 -- at a time. It is possible to parse multiple units in syntax check
5608 -- only mode, but the trees are discarded in that case.
5609
5610 ------------------------------
5611 -- 10.1.1 Compilation Unit --
5612 ------------------------------
5613
5614 -- COMPILATION_UNIT ::=
5615 -- CONTEXT_CLAUSE LIBRARY_ITEM
5616 -- | CONTEXT_CLAUSE SUBUNIT
5617
5618 -- The N_Compilation_Unit node itself represents the above syntax.
5619 -- However, there are two additional items not reflected in the above
5620 -- syntax. First we have the global declarations that are added by the
5621 -- code generator. These are outer level declarations (so they cannot
5622 -- be represented as being inside the units). An example is the wrapper
5623 -- subprograms that are created to do ABE checking. As always a list of
5624 -- declarations can contain actions as well (i.e. statements), and such
5625 -- statements are executed as part of the elaboration of the unit. Note
5626 -- that all such declarations are elaborated before the library unit.
5627
5628 -- Similarly, certain actions need to be elaborated at the completion
5629 -- of elaboration of the library unit (notably the statement that sets
5630 -- the Boolean flag indicating that elaboration is complete).
5631
5632 -- The third item not reflected in the syntax is pragmas that appear
5633 -- after the compilation unit. As always pragmas are a problem since
5634 -- they are not part of the formal syntax, but can be stuck into the
5635 -- source following a set of ad hoc rules, and we have to find an ad
5636 -- hoc way of sticking them into the tree. For pragmas that appear
5637 -- before the library unit, we just consider them to be part of the
5638 -- context clause, and pragmas can appear in the Context_Items list
5639 -- of the compilation unit. However, pragmas can also appear after
5640 -- the library item.
5641
5642 -- To deal with all these problems, we create an auxiliary node for
5643 -- a compilation unit, referenced from the N_Compilation_Unit node,
5644 -- that contains these items.
5645
5646 -- N_Compilation_Unit
5647 -- Sloc points to first token of defining unit name
5648 -- Library_Unit (Node4-Sem) corresponding/parent spec/body
5649 -- Context_Items (List1) context items and pragmas preceding unit
5650 -- Private_Present (Flag15) set if library unit has private keyword
5651 -- Unit (Node2) library item or subunit
5652 -- Aux_Decls_Node (Node5) points to the N_Compilation_Unit_Aux node
5653 -- Has_No_Elaboration_Code (Flag17-Sem)
5654 -- Body_Required (Flag13-Sem) set for spec if body is required
5655 -- Acts_As_Spec (Flag4-Sem) flag for subprogram body with no spec
5656 -- Context_Pending (Flag16-Sem)
5657 -- First_Inlined_Subprogram (Node3-Sem)
5658 -- Has_Pragma_Suppress_All (Flag14-Sem)
5659
5660 -- N_Compilation_Unit_Aux
5661 -- Sloc is a copy of the Sloc from the N_Compilation_Unit node
5662 -- Declarations (List2) (set to No_List if no global declarations)
5663 -- Actions (List1) (set to No_List if no actions)
5664 -- Pragmas_After (List5) pragmas after unit (set to No_List if none)
5665 -- Config_Pragmas (List4) config pragmas (set to Empty_List if none)
5666 -- Default_Storage_Pool (Node3-Sem)
5667
5668 --------------------------
5669 -- 10.1.1 Library Item --
5670 --------------------------
5671
5672 -- LIBRARY_ITEM ::=
5673 -- [private] LIBRARY_UNIT_DECLARATION
5674 -- | LIBRARY_UNIT_BODY
5675 -- | [private] LIBRARY_UNIT_RENAMING_DECLARATION
5676
5677 -- Note: PRIVATE is not allowed in Ada 83 mode
5678
5679 -- There is no explicit node in the tree for library item, instead
5680 -- the declaration or body, and the flag for private if present,
5681 -- appear in the N_Compilation_Unit node.
5682
5683 --------------------------------------
5684 -- 10.1.1 Library Unit Declaration --
5685 --------------------------------------
5686
5687 -- LIBRARY_UNIT_DECLARATION ::=
5688 -- SUBPROGRAM_DECLARATION | PACKAGE_DECLARATION
5689 -- | GENERIC_DECLARATION | GENERIC_INSTANTIATION
5690
5691 -----------------------------------------------
5692 -- 10.1.1 Library Unit Renaming Declaration --
5693 -----------------------------------------------
5694
5695 -- LIBRARY_UNIT_RENAMING_DECLARATION ::=
5696 -- PACKAGE_RENAMING_DECLARATION
5697 -- | GENERIC_RENAMING_DECLARATION
5698 -- | SUBPROGRAM_RENAMING_DECLARATION
5699
5700 -------------------------------
5701 -- 10.1.1 Library unit body --
5702 -------------------------------
5703
5704 -- LIBRARY_UNIT_BODY ::= SUBPROGRAM_BODY | PACKAGE_BODY
5705
5706 ------------------------------
5707 -- 10.1.1 Parent Unit Name --
5708 ------------------------------
5709
5710 -- PARENT_UNIT_NAME ::= NAME
5711
5712 ----------------------------
5713 -- 10.1.2 Context clause --
5714 ----------------------------
5715
5716 -- CONTEXT_CLAUSE ::= {CONTEXT_ITEM}
5717
5718 -- The context clause can include pragmas, and any pragmas that appear
5719 -- before the context clause proper (i.e. all configuration pragmas,
5720 -- also appear at the front of this list).
5721
5722 --------------------------
5723 -- 10.1.2 Context_Item --
5724 --------------------------
5725
5726 -- CONTEXT_ITEM ::= WITH_CLAUSE | USE_CLAUSE | WITH_TYPE_CLAUSE
5727
5728 -------------------------
5729 -- 10.1.2 With clause --
5730 -------------------------
5731
5732 -- WITH_CLAUSE ::=
5733 -- with library_unit_NAME {,library_unit_NAME};
5734
5735 -- A separate With clause is built for each name, so that we have
5736 -- a Corresponding_Spec field for each with'ed spec. The flags
5737 -- First_Name and Last_Name are used to reconstruct the exact
5738 -- source form. When a list of names appears in one with clause,
5739 -- the first name in the list has First_Name set, and the last
5740 -- has Last_Name set. If the with clause has only one name, then
5741 -- both of the flags First_Name and Last_Name are set in this name.
5742
5743 -- Note: in the case of implicit with's that are installed by the
5744 -- Rtsfind routine, Implicit_With is set, and the Sloc is typically
5745 -- set to Standard_Location, but it is incorrect to test the Sloc
5746 -- to find out if a with clause is implicit, test the flag instead.
5747
5748 -- N_With_Clause
5749 -- Sloc points to first token of library unit name
5750 -- Withed_Body (Node1-Sem)
5751 -- Name (Node2)
5752 -- Next_Implicit_With (Node3-Sem)
5753 -- Library_Unit (Node4-Sem)
5754 -- Corresponding_Spec (Node5-Sem)
5755 -- First_Name (Flag5) (set to True if first name or only one name)
5756 -- Last_Name (Flag6) (set to True if last name or only one name)
5757 -- Context_Installed (Flag13-Sem)
5758 -- Elaborate_Present (Flag4-Sem)
5759 -- Elaborate_All_Present (Flag14-Sem)
5760 -- Elaborate_All_Desirable (Flag9-Sem)
5761 -- Elaborate_Desirable (Flag11-Sem)
5762 -- Private_Present (Flag15) set if with_clause has private keyword
5763 -- Implicit_With (Flag16-Sem)
5764 -- Limited_Present (Flag17) set if LIMITED is present
5765 -- Limited_View_Installed (Flag18-Sem)
5766 -- Unreferenced_In_Spec (Flag7-Sem)
5767 -- No_Entities_Ref_In_Spec (Flag8-Sem)
5768
5769 -- Note: Limited_Present and Limited_View_Installed give support to
5770 -- Ada 2005 (AI-50217).
5771 -- Similarly, Private_Present gives support to AI-50262.
5772
5773 ----------------------
5774 -- With_Type clause --
5775 ----------------------
5776
5777 -- This is a GNAT extension, used to implement mutually recursive
5778 -- types declared in different packages.
5779 -- Note: this is now obsolete. The functionality of this construct
5780 -- is now implemented by the Ada 2005 Limited_with_Clause.
5781
5782 ---------------------
5783 -- 10.2 Body stub --
5784 ---------------------
5785
5786 -- BODY_STUB ::=
5787 -- SUBPROGRAM_BODY_STUB
5788 -- | PACKAGE_BODY_STUB
5789 -- | TASK_BODY_STUB
5790 -- | PROTECTED_BODY_STUB
5791
5792 ----------------------------------
5793 -- 10.1.3 Subprogram Body Stub --
5794 ----------------------------------
5795
5796 -- SUBPROGRAM_BODY_STUB ::=
5797 -- SUBPROGRAM_SPECIFICATION is separate;
5798
5799 -- N_Subprogram_Body_Stub
5800 -- Sloc points to FUNCTION or PROCEDURE
5801 -- Specification (Node1)
5802 -- Library_Unit (Node4-Sem) points to the subunit
5803 -- Corresponding_Body (Node5-Sem)
5804
5805 -------------------------------
5806 -- 10.1.3 Package Body Stub --
5807 -------------------------------
5808
5809 -- PACKAGE_BODY_STUB ::=
5810 -- package body DEFINING_IDENTIFIER is separate;
5811
5812 -- N_Package_Body_Stub
5813 -- Sloc points to PACKAGE
5814 -- Defining_Identifier (Node1)
5815 -- Library_Unit (Node4-Sem) points to the subunit
5816 -- Corresponding_Body (Node5-Sem)
5817
5818 ----------------------------
5819 -- 10.1.3 Task Body Stub --
5820 ----------------------------
5821
5822 -- TASK_BODY_STUB ::=
5823 -- task body DEFINING_IDENTIFIER is separate;
5824
5825 -- N_Task_Body_Stub
5826 -- Sloc points to TASK
5827 -- Defining_Identifier (Node1)
5828 -- Library_Unit (Node4-Sem) points to the subunit
5829 -- Corresponding_Body (Node5-Sem)
5830
5831 ---------------------------------
5832 -- 10.1.3 Protected Body Stub --
5833 ---------------------------------
5834
5835 -- PROTECTED_BODY_STUB ::=
5836 -- protected body DEFINING_IDENTIFIER is separate;
5837
5838 -- Note: protected body stubs are not allowed in Ada 83 mode
5839
5840 -- N_Protected_Body_Stub
5841 -- Sloc points to PROTECTED
5842 -- Defining_Identifier (Node1)
5843 -- Library_Unit (Node4-Sem) points to the subunit
5844 -- Corresponding_Body (Node5-Sem)
5845
5846 ---------------------
5847 -- 10.1.3 Subunit --
5848 ---------------------
5849
5850 -- SUBUNIT ::= separate (PARENT_UNIT_NAME) PROPER_BODY
5851
5852 -- N_Subunit
5853 -- Sloc points to SEPARATE
5854 -- Name (Node2) is the name of the parent unit
5855 -- Proper_Body (Node1) is the subunit body
5856 -- Corresponding_Stub (Node3-Sem) is the stub declaration for the unit.
5857
5858 ---------------------------------
5859 -- 11.1 Exception Declaration --
5860 ---------------------------------
5861
5862 -- EXCEPTION_DECLARATION ::= DEFINING_IDENTIFIER_LIST : exception
5863 -- [ASPECT_SPECIFICATIONS];
5864
5865 -- For consistency with object declarations etc., the parser converts
5866 -- the case of multiple identifiers being declared to a series of
5867 -- declarations in which the expression is copied, using the More_Ids
5868 -- and Prev_Ids flags to remember the source form as described in the
5869 -- section on "Handling of Defining Identifier Lists".
5870
5871 -- N_Exception_Declaration
5872 -- Sloc points to EXCEPTION
5873 -- Defining_Identifier (Node1)
5874 -- Expression (Node3-Sem)
5875 -- Renaming_Exception (Node2-Sem)
5876 -- More_Ids (Flag5) (set to False if no more identifiers in list)
5877 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
5878
5879 ------------------------------------------
5880 -- 11.2 Handled Sequence Of Statements --
5881 ------------------------------------------
5882
5883 -- HANDLED_SEQUENCE_OF_STATEMENTS ::=
5884 -- SEQUENCE_OF_STATEMENTS
5885 -- [exception
5886 -- EXCEPTION_HANDLER
5887 -- {EXCEPTION_HANDLER}]
5888 -- [at end
5889 -- cleanup_procedure_call (param, param, param, ...);]
5890
5891 -- The AT END phrase is a GNAT extension to provide for cleanups. It is
5892 -- used only internally currently, but is considered to be syntactic.
5893 -- At the moment, the only cleanup action allowed is a single call to
5894 -- a parameterless procedure, and the Identifier field of the node is
5895 -- the procedure to be called. Also there is a current restriction
5896 -- that exception handles and a cleanup cannot be present in the same
5897 -- frame, so at least one of Exception_Handlers or the Identifier must
5898 -- be missing.
5899
5900 -- Actually, more accurately, this restriction applies to the original
5901 -- source program. In the expanded tree, if the At_End_Proc field is
5902 -- present, then there will also be an exception handler of the form:
5903
5904 -- when all others =>
5905 -- cleanup;
5906 -- raise;
5907
5908 -- where cleanup is the procedure to be generated. The reason we do
5909 -- this is so that the front end can handle the necessary entries in
5910 -- the exception tables, and other exception handler actions required
5911 -- as part of the normal handling for exception handlers.
5912
5913 -- The AT END cleanup handler protects only the sequence of statements
5914 -- (not the associated declarations of the parent), just like exception
5915 -- handlers. The big difference is that the cleanup procedure is called
5916 -- on either a normal or an abnormal exit from the statement sequence.
5917
5918 -- Note: the list of Exception_Handlers can contain pragmas as well
5919 -- as actual handlers. In practice these pragmas can only occur at
5920 -- the start of the list, since any pragmas occurring later on will
5921 -- be included in the statement list of the corresponding handler.
5922
5923 -- Note: although in the Ada syntax, the sequence of statements in
5924 -- a handled sequence of statements can only contain statements, we
5925 -- allow free mixing of declarations and statements in the resulting
5926 -- expanded tree. This is for example used to deal with the case of
5927 -- a cleanup procedure that must handle declarations as well as the
5928 -- statements of a block.
5929
5930 -- N_Handled_Sequence_Of_Statements
5931 -- Sloc points to first token of first statement
5932 -- Statements (List3)
5933 -- End_Label (Node4) (set to Empty if expander generated)
5934 -- Exception_Handlers (List5) (set to No_List if none present)
5935 -- At_End_Proc (Node1) (set to Empty if no clean up procedure)
5936 -- First_Real_Statement (Node2-Sem)
5937 -- Zero_Cost_Handling (Flag5-Sem)
5938
5939 -- Note: the parent always contains a Declarations field which contains
5940 -- declarations associated with the handled sequence of statements. This
5941 -- is true even in the case of an accept statement (see description of
5942 -- the N_Accept_Statement node).
5943
5944 -- End_Label refers to the containing construct
5945
5946 -----------------------------
5947 -- 11.2 Exception Handler --
5948 -----------------------------
5949
5950 -- EXCEPTION_HANDLER ::=
5951 -- when [CHOICE_PARAMETER_SPECIFICATION :]
5952 -- EXCEPTION_CHOICE {| EXCEPTION_CHOICE} =>
5953 -- SEQUENCE_OF_STATEMENTS
5954
5955 -- Note: choice parameter specification is not allowed in Ada 83 mode
5956
5957 -- N_Exception_Handler
5958 -- Sloc points to WHEN
5959 -- Choice_Parameter (Node2) (set to Empty if not present)
5960 -- Exception_Choices (List4)
5961 -- Statements (List3)
5962 -- Exception_Label (Node5-Sem) (set to Empty of not present)
5963 -- Zero_Cost_Handling (Flag5-Sem)
5964 -- Local_Raise_Statements (Elist1-Sem) (set to No_Elist if not present)
5965 -- Local_Raise_Not_OK (Flag7-Sem)
5966 -- Has_Local_Raise (Flag8-Sem)
5967
5968 ------------------------------------------
5969 -- 11.2 Choice parameter specification --
5970 ------------------------------------------
5971
5972 -- CHOICE_PARAMETER_SPECIFICATION ::= DEFINING_IDENTIFIER
5973
5974 ----------------------------
5975 -- 11.2 Exception Choice --
5976 ----------------------------
5977
5978 -- EXCEPTION_CHOICE ::= exception_NAME | others
5979
5980 -- Except in the case of OTHERS, no explicit node appears in the tree
5981 -- for exception choice. Instead the exception name appears directly.
5982 -- An OTHERS choice is represented by a N_Others_Choice node (see
5983 -- section 3.8.1.
5984
5985 -- Note: for the exception choice created for an at end handler, the
5986 -- exception choice is an N_Others_Choice node with All_Others set.
5987
5988 ---------------------------
5989 -- 11.3 Raise Statement --
5990 ---------------------------
5991
5992 -- RAISE_STATEMENT ::= raise [exception_NAME];
5993
5994 -- In Ada 2005, we have
5995
5996 -- RAISE_STATEMENT ::= raise; | raise exception_NAME [with EXPRESSION];
5997
5998 -- N_Raise_Statement
5999 -- Sloc points to RAISE
6000 -- Name (Node2) (set to Empty if no exception name present)
6001 -- Expression (Node3) (set to Empty if no expression present)
6002 -- From_At_End (Flag4-Sem)
6003
6004 -------------------------------
6005 -- 12.1 Generic Declaration --
6006 -------------------------------
6007
6008 -- GENERIC_DECLARATION ::=
6009 -- GENERIC_SUBPROGRAM_DECLARATION | GENERIC_PACKAGE_DECLARATION
6010
6011 ------------------------------------------
6012 -- 12.1 Generic Subprogram Declaration --
6013 ------------------------------------------
6014
6015 -- GENERIC_SUBPROGRAM_DECLARATION ::=
6016 -- GENERIC_FORMAL_PART SUBPROGRAM_SPECIFICATION;
6017
6018 -- Note: Generic_Formal_Declarations can include pragmas
6019
6020 -- N_Generic_Subprogram_Declaration
6021 -- Sloc points to GENERIC
6022 -- Specification (Node1) subprogram specification
6023 -- Corresponding_Body (Node5-Sem)
6024 -- Generic_Formal_Declarations (List2) from generic formal part
6025 -- Parent_Spec (Node4-Sem)
6026
6027 ---------------------------------------
6028 -- 12.1 Generic Package Declaration --
6029 ---------------------------------------
6030
6031 -- GENERIC_PACKAGE_DECLARATION ::=
6032 -- GENERIC_FORMAL_PART PACKAGE_SPECIFICATION
6033 -- [ASPECT_SPECIFICATIONS];
6034
6035 -- Note: when we do generics right, the Activation_Chain_Entity entry
6036 -- for this node can be removed (since the expander won't see generic
6037 -- units any more)???.
6038
6039 -- Note: Generic_Formal_Declarations can include pragmas
6040
6041 -- N_Generic_Package_Declaration
6042 -- Sloc points to GENERIC
6043 -- Specification (Node1) package specification
6044 -- Corresponding_Body (Node5-Sem)
6045 -- Generic_Formal_Declarations (List2) from generic formal part
6046 -- Parent_Spec (Node4-Sem)
6047 -- Activation_Chain_Entity (Node3-Sem)
6048
6049 -------------------------------
6050 -- 12.1 Generic Formal Part --
6051 -------------------------------
6052
6053 -- GENERIC_FORMAL_PART ::=
6054 -- generic {GENERIC_FORMAL_PARAMETER_DECLARATION | USE_CLAUSE}
6055
6056 ------------------------------------------------
6057 -- 12.1 Generic Formal Parameter Declaration --
6058 ------------------------------------------------
6059
6060 -- GENERIC_FORMAL_PARAMETER_DECLARATION ::=
6061 -- FORMAL_OBJECT_DECLARATION
6062 -- | FORMAL_TYPE_DECLARATION
6063 -- | FORMAL_SUBPROGRAM_DECLARATION
6064 -- | FORMAL_PACKAGE_DECLARATION
6065
6066 ---------------------------------
6067 -- 12.3 Generic Instantiation --
6068 ---------------------------------
6069
6070 -- GENERIC_INSTANTIATION ::=
6071 -- package DEFINING_PROGRAM_UNIT_NAME is
6072 -- new generic_package_NAME [GENERIC_ACTUAL_PART]
6073 -- [ASPECT_SPECIFICATIONS];
6074 -- | [[not] overriding]
6075 -- procedure DEFINING_PROGRAM_UNIT_NAME is
6076 -- new generic_procedure_NAME [GENERIC_ACTUAL_PART]
6077 -- [ASPECT_SPECIFICATIONS];
6078 -- | [[not] overriding]
6079 -- function DEFINING_DESIGNATOR is
6080 -- new generic_function_NAME [GENERIC_ACTUAL_PART]
6081 -- [ASPECT_SPECIFICATIONS];
6082
6083 -- N_Package_Instantiation
6084 -- Sloc points to PACKAGE
6085 -- Defining_Unit_Name (Node1)
6086 -- Name (Node2)
6087 -- Generic_Associations (List3) (set to No_List if no
6088 -- generic actual part)
6089 -- Parent_Spec (Node4-Sem)
6090 -- Instance_Spec (Node5-Sem)
6091 -- ABE_Is_Certain (Flag18-Sem)
6092
6093 -- N_Procedure_Instantiation
6094 -- Sloc points to PROCEDURE
6095 -- Defining_Unit_Name (Node1)
6096 -- Name (Node2)
6097 -- Parent_Spec (Node4-Sem)
6098 -- Generic_Associations (List3) (set to No_List if no
6099 -- generic actual part)
6100 -- Instance_Spec (Node5-Sem)
6101 -- Must_Override (Flag14) set if overriding indicator present
6102 -- Must_Not_Override (Flag15) set if not_overriding indicator present
6103 -- ABE_Is_Certain (Flag18-Sem)
6104
6105 -- N_Function_Instantiation
6106 -- Sloc points to FUNCTION
6107 -- Defining_Unit_Name (Node1)
6108 -- Name (Node2)
6109 -- Generic_Associations (List3) (set to No_List if no
6110 -- generic actual part)
6111 -- Parent_Spec (Node4-Sem)
6112 -- Instance_Spec (Node5-Sem)
6113 -- Must_Override (Flag14) set if overriding indicator present
6114 -- Must_Not_Override (Flag15) set if not_overriding indicator present
6115 -- ABE_Is_Certain (Flag18-Sem)
6116
6117 -- Note: overriding indicator is an Ada 2005 feature
6118
6119 -------------------------------
6120 -- 12.3 Generic Actual Part --
6121 -------------------------------
6122
6123 -- GENERIC_ACTUAL_PART ::=
6124 -- (GENERIC_ASSOCIATION {, GENERIC_ASSOCIATION})
6125
6126 -------------------------------
6127 -- 12.3 Generic Association --
6128 -------------------------------
6129
6130 -- GENERIC_ASSOCIATION ::=
6131 -- [generic_formal_parameter_SELECTOR_NAME =>]
6132
6133 -- Note: unlike the procedure call case, a generic association node
6134 -- is generated for every association, even if no formal parameter
6135 -- selector name is present. In this case the parser will leave the
6136 -- Selector_Name field set to Empty, to be filled in later by the
6137 -- semantic pass.
6138
6139 -- In Ada 2005, a formal may be associated with a box, if the
6140 -- association is part of the list of actuals for a formal package.
6141 -- If the association is given by OTHERS => <>, the association is
6142 -- an N_Others_Choice.
6143
6144 -- N_Generic_Association
6145 -- Sloc points to first token of generic association
6146 -- Selector_Name (Node2) (set to Empty if no formal
6147 -- parameter selector name)
6148 -- Explicit_Generic_Actual_Parameter (Node1) (Empty if box present)
6149 -- Box_Present (Flag15) (for formal_package associations with a box)
6150
6151 ---------------------------------------------
6152 -- 12.3 Explicit Generic Actual Parameter --
6153 ---------------------------------------------
6154
6155 -- EXPLICIT_GENERIC_ACTUAL_PARAMETER ::=
6156 -- EXPRESSION | variable_NAME | subprogram_NAME
6157 -- | entry_NAME | SUBTYPE_MARK | package_instance_NAME
6158
6159 -------------------------------------
6160 -- 12.4 Formal Object Declaration --
6161 -------------------------------------
6162
6163 -- FORMAL_OBJECT_DECLARATION ::=
6164 -- DEFINING_IDENTIFIER_LIST :
6165 -- MODE [NULL_EXCLUSION] SUBTYPE_MARK [:= DEFAULT_EXPRESSION]
6166 -- [ASPECT_SPECIFICATIONS];
6167 -- | DEFINING_IDENTIFIER_LIST :
6168 -- MODE ACCESS_DEFINITION [:= DEFAULT_EXPRESSION]
6169 -- [ASPECT_SPECIFICATIONS];
6170
6171 -- Although the syntax allows multiple identifiers in the list, the
6172 -- semantics is as though successive declarations were given with
6173 -- identical type definition and expression components. To simplify
6174 -- semantic processing, the parser represents a multiple declaration
6175 -- case as a sequence of single declarations, using the More_Ids and
6176 -- Prev_Ids flags to preserve the original source form as described
6177 -- in the section on "Handling of Defining Identifier Lists".
6178
6179 -- N_Formal_Object_Declaration
6180 -- Sloc points to first identifier
6181 -- Defining_Identifier (Node1)
6182 -- In_Present (Flag15)
6183 -- Out_Present (Flag17)
6184 -- Null_Exclusion_Present (Flag11) (set to False if not present)
6185 -- Subtype_Mark (Node4) (set to Empty if not present)
6186 -- Access_Definition (Node3) (set to Empty if not present)
6187 -- Default_Expression (Node5) (set to Empty if no default expression)
6188 -- More_Ids (Flag5) (set to False if no more identifiers in list)
6189 -- Prev_Ids (Flag6) (set to False if no previous identifiers in list)
6190
6191 -----------------------------------
6192 -- 12.5 Formal Type Declaration --
6193 -----------------------------------
6194
6195 -- FORMAL_TYPE_DECLARATION ::=
6196 -- type DEFINING_IDENTIFIER [DISCRIMINANT_PART]
6197 -- is FORMAL_TYPE_DEFINITION
6198 -- [ASPECT_SPECIFICATIONS];
6199
6200 -- N_Formal_Type_Declaration
6201 -- Sloc points to TYPE
6202 -- Defining_Identifier (Node1)
6203 -- Formal_Type_Definition (Node3)
6204 -- Discriminant_Specifications (List4) (set to No_List if no
6205 -- discriminant part)
6206 -- Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
6207
6208 ----------------------------------
6209 -- 12.5 Formal type definition --
6210 ----------------------------------
6211
6212 -- FORMAL_TYPE_DEFINITION ::=
6213 -- FORMAL_PRIVATE_TYPE_DEFINITION
6214 -- | FORMAL_DERIVED_TYPE_DEFINITION
6215 -- | FORMAL_DISCRETE_TYPE_DEFINITION
6216 -- | FORMAL_SIGNED_INTEGER_TYPE_DEFINITION
6217 -- | FORMAL_MODULAR_TYPE_DEFINITION
6218 -- | FORMAL_FLOATING_POINT_DEFINITION
6219 -- | FORMAL_ORDINARY_FIXED_POINT_DEFINITION
6220 -- | FORMAL_DECIMAL_FIXED_POINT_DEFINITION
6221 -- | FORMAL_ARRAY_TYPE_DEFINITION
6222 -- | FORMAL_ACCESS_TYPE_DEFINITION
6223 -- | FORMAL_INTERFACE_TYPE_DEFINITION
6224
6225 ---------------------------------------------
6226 -- 12.5.1 Formal Private Type Definition --
6227 ---------------------------------------------
6228
6229 -- FORMAL_PRIVATE_TYPE_DEFINITION ::=
6230 -- [[abstract] tagged] [limited] private
6231
6232 -- Note: TAGGED is not allowed in Ada 83 mode
6233
6234 -- N_Formal_Private_Type_Definition
6235 -- Sloc points to PRIVATE
6236 -- Abstract_Present (Flag4)
6237 -- Tagged_Present (Flag15)
6238 -- Limited_Present (Flag17)
6239
6240 --------------------------------------------
6241 -- 12.5.1 Formal Derived Type Definition --
6242 --------------------------------------------
6243
6244 -- FORMAL_DERIVED_TYPE_DEFINITION ::=
6245 -- [abstract] [limited | synchronized]
6246 -- new SUBTYPE_MARK [[and INTERFACE_LIST] with private]
6247 -- Note: this construct is not allowed in Ada 83 mode
6248
6249 -- N_Formal_Derived_Type_Definition
6250 -- Sloc points to NEW
6251 -- Subtype_Mark (Node4)
6252 -- Private_Present (Flag15)
6253 -- Abstract_Present (Flag4)
6254 -- Limited_Present (Flag17)
6255 -- Synchronized_Present (Flag7)
6256 -- Interface_List (List2) (set to No_List if none)
6257
6258 ---------------------------------------------
6259 -- 12.5.2 Formal Discrete Type Definition --
6260 ---------------------------------------------
6261
6262 -- FORMAL_DISCRETE_TYPE_DEFINITION ::= (<>)
6263
6264 -- N_Formal_Discrete_Type_Definition
6265 -- Sloc points to (
6266
6267 ---------------------------------------------------
6268 -- 12.5.2 Formal Signed Integer Type Definition --
6269 ---------------------------------------------------
6270
6271 -- FORMAL_SIGNED_INTEGER_TYPE_DEFINITION ::= range <>
6272
6273 -- N_Formal_Signed_Integer_Type_Definition
6274 -- Sloc points to RANGE
6275
6276 --------------------------------------------
6277 -- 12.5.2 Formal Modular Type Definition --
6278 --------------------------------------------
6279
6280 -- FORMAL_MODULAR_TYPE_DEFINITION ::= mod <>
6281
6282 -- N_Formal_Modular_Type_Definition
6283 -- Sloc points to MOD
6284
6285 ----------------------------------------------
6286 -- 12.5.2 Formal Floating Point Definition --
6287 ----------------------------------------------
6288
6289 -- FORMAL_FLOATING_POINT_DEFINITION ::= digits <>
6290
6291 -- N_Formal_Floating_Point_Definition
6292 -- Sloc points to DIGITS
6293
6294 ----------------------------------------------------
6295 -- 12.5.2 Formal Ordinary Fixed Point Definition --
6296 ----------------------------------------------------
6297
6298 -- FORMAL_ORDINARY_FIXED_POINT_DEFINITION ::= delta <>
6299
6300 -- N_Formal_Ordinary_Fixed_Point_Definition
6301 -- Sloc points to DELTA
6302
6303 ---------------------------------------------------
6304 -- 12.5.2 Formal Decimal Fixed Point Definition --
6305 ---------------------------------------------------
6306
6307 -- FORMAL_DECIMAL_FIXED_POINT_DEFINITION ::= delta <> digits <>
6308
6309 -- Note: formal decimal fixed point definition not allowed in Ada 83
6310
6311 -- N_Formal_Decimal_Fixed_Point_Definition
6312 -- Sloc points to DELTA
6313
6314 ------------------------------------------
6315 -- 12.5.3 Formal Array Type Definition --
6316 ------------------------------------------
6317
6318 -- FORMAL_ARRAY_TYPE_DEFINITION ::= ARRAY_TYPE_DEFINITION
6319
6320 -------------------------------------------
6321 -- 12.5.4 Formal Access Type Definition --
6322 -------------------------------------------
6323
6324 -- FORMAL_ACCESS_TYPE_DEFINITION ::= ACCESS_TYPE_DEFINITION
6325
6326 ----------------------------------------------
6327 -- 12.5.5 Formal Interface Type Definition --
6328 ----------------------------------------------
6329
6330 -- FORMAL_INTERFACE_TYPE_DEFINITION ::= INTERFACE_TYPE_DEFINITION
6331
6332 -----------------------------------------
6333 -- 12.6 Formal Subprogram Declaration --
6334 -----------------------------------------
6335
6336 -- FORMAL_SUBPROGRAM_DECLARATION ::=
6337 -- FORMAL_CONCRETE_SUBPROGRAM_DECLARATION
6338 -- | FORMAL_ABSTRACT_SUBPROGRAM_DECLARATION
6339
6340 --------------------------------------------------
6341 -- 12.6 Formal Concrete Subprogram Declaration --
6342 --------------------------------------------------
6343
6344 -- FORMAL_CONCRETE_SUBPROGRAM_DECLARATION ::=
6345 -- with SUBPROGRAM_SPECIFICATION [is SUBPROGRAM_DEFAULT]
6346 -- [ASPECT_SPECIFICATIONS];
6347
6348 -- N_Formal_Concrete_Subprogram_Declaration
6349 -- Sloc points to WITH
6350 -- Specification (Node1)
6351 -- Default_Name (Node2) (set to Empty if no subprogram default)
6352 -- Box_Present (Flag15)
6353
6354 -- Note: if no subprogram default is present, then Name is set
6355 -- to Empty, and Box_Present is False.
6356
6357 --------------------------------------------------
6358 -- 12.6 Formal Abstract Subprogram Declaration --
6359 --------------------------------------------------
6360
6361 -- FORMAL_ABSTRACT_SUBPROGRAM_DECLARATION ::=
6362 -- with SUBPROGRAM_SPECIFICATION is abstract [SUBPROGRAM_DEFAULT]
6363 -- [ASPECT_SPECIFICATIONS];
6364
6365 -- N_Formal_Abstract_Subprogram_Declaration
6366 -- Sloc points to WITH
6367 -- Specification (Node1)
6368 -- Default_Name (Node2) (set to Empty if no subprogram default)
6369 -- Box_Present (Flag15)
6370
6371 -- Note: if no subprogram default is present, then Name is set
6372 -- to Empty, and Box_Present is False.
6373
6374 ------------------------------
6375 -- 12.6 Subprogram Default --
6376 ------------------------------
6377
6378 -- SUBPROGRAM_DEFAULT ::= DEFAULT_NAME | <>
6379
6380 -- There is no separate node in the tree for a subprogram default.
6381 -- Instead the parent (N_Formal_Concrete_Subprogram_Declaration
6382 -- or N_Formal_Abstract_Subprogram_Declaration) node contains the
6383 -- default name or box indication, as needed.
6384
6385 ------------------------
6386 -- 12.6 Default Name --
6387 ------------------------
6388
6389 -- DEFAULT_NAME ::= NAME
6390
6391 --------------------------------------
6392 -- 12.7 Formal Package Declaration --
6393 --------------------------------------
6394
6395 -- FORMAL_PACKAGE_DECLARATION ::=
6396 -- with package DEFINING_IDENTIFIER
6397 -- is new generic_package_NAME FORMAL_PACKAGE_ACTUAL_PART
6398 -- [ASPECT_SPECIFICATIONS];
6399
6400 -- Note: formal package declarations not allowed in Ada 83 mode
6401
6402 -- N_Formal_Package_Declaration
6403 -- Sloc points to WITH
6404 -- Defining_Identifier (Node1)
6405 -- Name (Node2)
6406 -- Generic_Associations (List3) (set to No_List if (<>) case or
6407 -- empty generic actual part)
6408 -- Box_Present (Flag15)
6409 -- Instance_Spec (Node5-Sem)
6410 -- ABE_Is_Certain (Flag18-Sem)
6411
6412 --------------------------------------
6413 -- 12.7 Formal Package Actual Part --
6414 --------------------------------------
6415
6416 -- FORMAL_PACKAGE_ACTUAL_PART ::=
6417 -- ([OTHERS] => <>)
6418 -- | [GENERIC_ACTUAL_PART]
6419 -- (FORMAL_PACKAGE_ASSOCIATION {. FORMAL_PACKAGE_ASSOCIATION}
6420
6421 -- FORMAL_PACKAGE_ASSOCIATION ::=
6422 -- GENERIC_ASSOCIATION
6423 -- | GENERIC_FORMAL_PARAMETER_SELECTOR_NAME => <>
6424
6425 -- There is no explicit node in the tree for a formal package actual
6426 -- part. Instead the information appears in the parent node (i.e. the
6427 -- formal package declaration node itself).
6428
6429 -- There is no explicit node for a formal package association. All of
6430 -- them are represented either by a generic association, possibly with
6431 -- Box_Present, or by an N_Others_Choice.
6432
6433 ---------------------------------
6434 -- 13.1 Representation clause --
6435 ---------------------------------
6436
6437 -- REPRESENTATION_CLAUSE ::=
6438 -- ATTRIBUTE_DEFINITION_CLAUSE
6439 -- | ENUMERATION_REPRESENTATION_CLAUSE
6440 -- | RECORD_REPRESENTATION_CLAUSE
6441 -- | AT_CLAUSE
6442
6443 ----------------------
6444 -- 13.1 Local Name --
6445 ----------------------
6446
6447 -- LOCAL_NAME :=
6448 -- DIRECT_NAME
6449 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
6450 -- | library_unit_NAME
6451
6452 -- The construct DIRECT_NAME'ATTRIBUTE_DESIGNATOR appears in the tree
6453 -- as an attribute reference, which has essentially the same form.
6454
6455 ---------------------------------------
6456 -- 13.3 Attribute definition clause --
6457 ---------------------------------------
6458
6459 -- ATTRIBUTE_DEFINITION_CLAUSE ::=
6460 -- for LOCAL_NAME'ATTRIBUTE_DESIGNATOR use EXPRESSION;
6461 -- | for LOCAL_NAME'ATTRIBUTE_DESIGNATOR use NAME;
6462
6463 -- In Ada 83, the expression must be a simple expression and the
6464 -- local name must be a direct name.
6465
6466 -- Note: the only attribute definition clause that is processed by
6467 -- gigi is an address clause. For all other cases, the information
6468 -- is extracted by the front end and either results in setting entity
6469 -- information, e.g. Esize for the Size clause, or in appropriate
6470 -- expansion actions (e.g. in the case of Storage_Size).
6471
6472 -- For an address clause, Gigi constructs the appropriate addressing
6473 -- code. It also ensures that no aliasing optimizations are made
6474 -- for the object for which the address clause appears.
6475
6476 -- Note: for an address clause used to achieve an overlay:
6477
6478 -- A : Integer;
6479 -- B : Integer;
6480 -- for B'Address use A'Address;
6481
6482 -- the above rule means that Gigi will ensure that no optimizations
6483 -- will be made for B that would violate the implementation advice
6484 -- of RM 13.3(19). However, this advice applies only to B and not
6485 -- to A, which seems unfortunate. The GNAT front end will mark the
6486 -- object A as volatile to also prevent unwanted optimization
6487 -- assumptions based on no aliasing being made for B.
6488
6489 -- N_Attribute_Definition_Clause
6490 -- Sloc points to FOR
6491 -- Name (Node2) the local name
6492 -- Chars (Name1) the identifier name from the attribute designator
6493 -- Expression (Node3) the expression or name
6494 -- Entity (Node4-Sem)
6495 -- Next_Rep_Item (Node5-Sem)
6496 -- From_At_Mod (Flag4-Sem)
6497 -- Check_Address_Alignment (Flag11-Sem)
6498 -- From_Aspect_Specification (Flag13-Sem)
6499 -- Is_Delayed_Aspect (Flag14-Sem)
6500 -- Address_Warning_Posted (Flag18-Sem)
6501
6502 -- Note: if From_Aspect_Specification is set, then Sloc points to the
6503 -- aspect name, and Entity is resolved already to reference the entity
6504 -- to which the aspect applies.
6505
6506 -----------------------------------
6507 -- 13.3.1 Aspect Specifications --
6508 -----------------------------------
6509
6510 -- We modify the RM grammar here, the RM grammar is:
6511
6512 -- ASPECT_SPECIFICATION ::=
6513 -- with ASPECT_MARK [=> ASPECT_DEFINITION] {.
6514 -- ASPECT_MARK [=> ASPECT_DEFINITION] }
6515
6516 -- ASPECT_MARK ::= aspect_IDENTIFIER['Class]
6517
6518 -- ASPECT_DEFINITION ::= NAME | EXPRESSION
6519
6520 -- That's inconvenient, since there is no non-terminal name for a single
6521 -- entry in the list of aspects. So we use this grammar instead:
6522
6523 -- ASPECT_SPECIFICATIONS ::=
6524 -- with ASPECT_SPECIFICATION {, ASPECT_SPECIFICATION}
6525
6526 -- ASPECT_SPECIFICATION =>
6527 -- ASPECT_MARK [=> ASPECT_DEFINITION]
6528
6529 -- ASPECT_MARK ::= aspect_IDENTIFIER['Class]
6530
6531 -- ASPECT_DEFINITION ::= NAME | EXPRESSION
6532
6533 -- See separate package Aspects for details on the incorporation of
6534 -- these nodes into the tree, and how aspect specifications for a given
6535 -- declaration node are associated with that node.
6536
6537 -- N_Aspect_Specification
6538 -- Sloc points to aspect identifier
6539 -- Identifier (Node1) aspect identifier
6540 -- Aspect_Rep_Item (Node2-Sem)
6541 -- Expression (Node3) Aspect_Definition (set to Empty if none)
6542 -- Entity (Node4-Sem) entity to which the aspect applies
6543 -- Class_Present (Flag6) Set if 'Class present
6544 -- Next_Rep_Item (Node5-Sem)
6545 -- Split_PPC (Flag17) Set if split pre/post attribute
6546
6547 -- Note: Aspect_Specification is an Ada 2012 feature
6548
6549 -- Note: When a Pre or Post aspect specification is processed, it is
6550 -- broken into AND THEN sections. The left most section has Split_PPC
6551 -- set to False, indicating that it is the original specification (e.g.
6552 -- for posting errors). For the other sections, Split_PPC is set True.
6553
6554 ---------------------------------------------
6555 -- 13.4 Enumeration representation clause --
6556 ---------------------------------------------
6557
6558 -- ENUMERATION_REPRESENTATION_CLAUSE ::=
6559 -- for first_subtype_LOCAL_NAME use ENUMERATION_AGGREGATE;
6560
6561 -- In Ada 83, the name must be a direct name
6562
6563 -- N_Enumeration_Representation_Clause
6564 -- Sloc points to FOR
6565 -- Identifier (Node1) direct name
6566 -- Array_Aggregate (Node3)
6567 -- Next_Rep_Item (Node5-Sem)
6568
6569 ---------------------------------
6570 -- 13.4 Enumeration aggregate --
6571 ---------------------------------
6572
6573 -- ENUMERATION_AGGREGATE ::= ARRAY_AGGREGATE
6574
6575 ------------------------------------------
6576 -- 13.5.1 Record representation clause --
6577 ------------------------------------------
6578
6579 -- RECORD_REPRESENTATION_CLAUSE ::=
6580 -- for first_subtype_LOCAL_NAME use
6581 -- record [MOD_CLAUSE]
6582 -- {COMPONENT_CLAUSE}
6583 -- end record;
6584
6585 -- Gigi restriction: Mod_Clause is always Empty (if present it is
6586 -- replaced by a corresponding Alignment attribute definition clause).
6587
6588 -- Note: Component_Clauses can include pragmas
6589
6590 -- N_Record_Representation_Clause
6591 -- Sloc points to FOR
6592 -- Identifier (Node1) direct name
6593 -- Mod_Clause (Node2) (set to Empty if no mod clause present)
6594 -- Component_Clauses (List3)
6595 -- Next_Rep_Item (Node5-Sem)
6596
6597 ------------------------------
6598 -- 13.5.1 Component clause --
6599 ------------------------------
6600
6601 -- COMPONENT_CLAUSE ::=
6602 -- component_LOCAL_NAME at POSITION
6603 -- range FIRST_BIT .. LAST_BIT;
6604
6605 -- N_Component_Clause
6606 -- Sloc points to AT
6607 -- Component_Name (Node1) points to Name or Attribute_Reference
6608 -- Position (Node2)
6609 -- First_Bit (Node3)
6610 -- Last_Bit (Node4)
6611
6612 ----------------------
6613 -- 13.5.1 Position --
6614 ----------------------
6615
6616 -- POSITION ::= static_EXPRESSION
6617
6618 -----------------------
6619 -- 13.5.1 First_Bit --
6620 -----------------------
6621
6622 -- FIRST_BIT ::= static_SIMPLE_EXPRESSION
6623
6624 ----------------------
6625 -- 13.5.1 Last_Bit --
6626 ----------------------
6627
6628 -- LAST_BIT ::= static_SIMPLE_EXPRESSION
6629
6630 --------------------------
6631 -- 13.8 Code statement --
6632 --------------------------
6633
6634 -- CODE_STATEMENT ::= QUALIFIED_EXPRESSION;
6635
6636 -- Note: in GNAT, the qualified expression has the form
6637
6638 -- Asm_Insn'(Asm (...));
6639
6640 -- See package System.Machine_Code in file s-maccod.ads for details on
6641 -- the allowed parameters to Asm. There are two ways this node can
6642 -- arise, as a code statement, in which case the expression is the
6643 -- qualified expression, or as a result of the expansion of an intrinsic
6644 -- call to the Asm or Asm_Input procedure.
6645
6646 -- N_Code_Statement
6647 -- Sloc points to first token of the expression
6648 -- Expression (Node3)
6649
6650 -- Note: package Exp_Code contains an abstract functional interface
6651 -- for use by Gigi in accessing the data from N_Code_Statement nodes.
6652
6653 ------------------------
6654 -- 13.12 Restriction --
6655 ------------------------
6656
6657 -- RESTRICTION ::=
6658 -- restriction_IDENTIFIER
6659 -- | restriction_parameter_IDENTIFIER => EXPRESSION
6660
6661 -- There is no explicit node for restrictions. Instead the restriction
6662 -- appears in normal pragma syntax as a pragma argument association,
6663 -- which has the same syntactic form.
6664
6665 --------------------------
6666 -- B.2 Shift Operators --
6667 --------------------------
6668
6669 -- Calls to the intrinsic shift functions are converted to one of
6670 -- the following shift nodes, which have the form of normal binary
6671 -- operator names. Note that for a given shift operation, one node
6672 -- covers all possible types, as for normal operators.
6673
6674 -- Note: it is perfectly permissible for the expander to generate
6675 -- shift operation nodes directly, in which case they will be analyzed
6676 -- and parsed in the usual manner.
6677
6678 -- Sprint syntax: shift-function-name!(expr, count)
6679
6680 -- Note: the Left_Opnd field holds the first argument (the value to
6681 -- be shifted). The Right_Opnd field holds the second argument (the
6682 -- shift count). The Chars field is the name of the intrinsic function.
6683
6684 -- N_Op_Rotate_Left
6685 -- Sloc points to the function name
6686 -- plus fields for binary operator
6687 -- plus fields for expression
6688 -- Shift_Count_OK (Flag4-Sem)
6689
6690 -- N_Op_Rotate_Right
6691 -- Sloc points to the function name
6692 -- plus fields for binary operator
6693 -- plus fields for expression
6694 -- Shift_Count_OK (Flag4-Sem)
6695
6696 -- N_Op_Shift_Left
6697 -- Sloc points to the function name
6698 -- plus fields for binary operator
6699 -- plus fields for expression
6700 -- Shift_Count_OK (Flag4-Sem)
6701
6702 -- N_Op_Shift_Right_Arithmetic
6703 -- Sloc points to the function name
6704 -- plus fields for binary operator
6705 -- plus fields for expression
6706 -- Shift_Count_OK (Flag4-Sem)
6707
6708 -- N_Op_Shift_Right
6709 -- Sloc points to the function name
6710 -- plus fields for binary operator
6711 -- plus fields for expression
6712 -- Shift_Count_OK (Flag4-Sem)
6713
6714 --------------------------
6715 -- Obsolescent Features --
6716 --------------------------
6717
6718 -- The syntax descriptions and tree nodes for obsolescent features are
6719 -- grouped together, corresponding to their location in appendix I in
6720 -- the RM. However, parsing and semantic analysis for these constructs
6721 -- is located in an appropriate chapter (see individual notes).
6722
6723 ---------------------------
6724 -- J.3 Delta Constraint --
6725 ---------------------------
6726
6727 -- Note: the parse routine for this construct is located in section
6728 -- 3.5.9 of Par-Ch3, and semantic analysis is in Sem_Ch3, which is
6729 -- where delta constraint logically belongs.
6730
6731 -- DELTA_CONSTRAINT ::= DELTA static_EXPRESSION [RANGE_CONSTRAINT]
6732
6733 -- N_Delta_Constraint
6734 -- Sloc points to DELTA
6735 -- Delta_Expression (Node3)
6736 -- Range_Constraint (Node4) (set to Empty if not present)
6737
6738 --------------------
6739 -- J.7 At Clause --
6740 --------------------
6741
6742 -- AT_CLAUSE ::= for DIRECT_NAME use at EXPRESSION;
6743
6744 -- Note: the parse routine for this construct is located in Par-Ch13,
6745 -- and the semantic analysis is in Sem_Ch13, where at clause logically
6746 -- belongs if it were not obsolescent.
6747
6748 -- Note: in Ada 83 the expression must be a simple expression
6749
6750 -- Gigi restriction: This node never appears, it is rewritten as an
6751 -- address attribute definition clause.
6752
6753 -- N_At_Clause
6754 -- Sloc points to FOR
6755 -- Identifier (Node1)
6756 -- Expression (Node3)
6757
6758 ---------------------
6759 -- J.8 Mod clause --
6760 ---------------------
6761
6762 -- MOD_CLAUSE ::= at mod static_EXPRESSION;
6763
6764 -- Note: the parse routine for this construct is located in Par-Ch13,
6765 -- and the semantic analysis is in Sem_Ch13, where mod clause logically
6766 -- belongs if it were not obsolescent.
6767
6768 -- Note: in Ada 83, the expression must be a simple expression
6769
6770 -- Gigi restriction: this node never appears. It is replaced
6771 -- by a corresponding Alignment attribute definition clause.
6772
6773 -- Note: pragmas can appear before and after the MOD_CLAUSE since
6774 -- its name has "clause" in it. This is rather strange, but is quite
6775 -- definitely specified. The pragmas before are collected in the
6776 -- Pragmas_Before field of the mod clause node itself, and pragmas
6777 -- after are simply swallowed up in the list of component clauses.
6778
6779 -- N_Mod_Clause
6780 -- Sloc points to AT
6781 -- Expression (Node3)
6782 -- Pragmas_Before (List4) Pragmas before mod clause (No_List if none)
6783
6784 --------------------
6785 -- Semantic Nodes --
6786 --------------------
6787
6788 -- These semantic nodes are used to hold additional semantic information.
6789 -- They are inserted into the tree as a result of semantic processing.
6790 -- Although there are no legitimate source syntax constructions that
6791 -- correspond directly to these nodes, we need a source syntax for the
6792 -- reconstructed tree printed by Sprint, and the node descriptions here
6793 -- show this syntax.
6794
6795 -- Note: Case_Expression and Conditional_Expression is in this section for
6796 -- now, since they are extensions. We will move them to their appropriate
6797 -- places when they are officially approved as extensions (and then we will
6798 -- know what the exact grammar and place in the Reference Manual is!)
6799
6800 ---------------------
6801 -- Case Expression --
6802 ---------------------
6803
6804 -- CASE_EXPRESSION ::=
6805 -- case EXPRESSION is
6806 -- CASE_EXPRESSION_ALTERNATIVE
6807 -- {CASE_EXPRESSION_ALTERNATIVE}
6808
6809 -- Note that the Alternatives cannot include pragmas (this constrasts
6810 -- with the situation of case statements where pragmas are allowed).
6811
6812 -- N_Case_Expression
6813 -- Sloc points to CASE
6814 -- Expression (Node3)
6815 -- Alternatives (List4)
6816
6817 ---------------------------------
6818 -- Case Expression Alternative --
6819 ---------------------------------
6820
6821 -- CASE_STATEMENT_ALTERNATIVE ::=
6822 -- when DISCRETE_CHOICE_LIST =>
6823 -- EXPRESSION
6824
6825 -- N_Case_Expression_Alternative
6826 -- Sloc points to WHEN
6827 -- Actions (List1)
6828 -- Discrete_Choices (List4)
6829 -- Expression (Node3)
6830
6831 -- Note: The Actions field temporarily holds any actions associated with
6832 -- evaluation of the Expression. During expansion of the case expression
6833 -- these actions are wrapped into the an N_Expressions_With_Actions node
6834 -- replacing the original expression.
6835
6836 ----------------------------
6837 -- Conditional Expression --
6838 ----------------------------
6839
6840 -- This node is used to represent an expression corresponding to the
6841 -- C construct (condition ? then-expression : else_expression), where
6842 -- Expressions is a three element list, whose first expression is the
6843 -- condition, and whose second and third expressions are the then and
6844 -- else expressions respectively.
6845
6846 -- Note: the Then_Actions and Else_Actions fields are always set to
6847 -- No_List in the tree passed to Gigi. These fields are used only
6848 -- for temporary processing purposes in the expander.
6849
6850 -- The Ada language does not permit conditional expressions, however
6851 -- this is under discussion as a possible extension by the ARG, and we
6852 -- have implemented a form of this capability in GNAT under control of
6853 -- the -gnatX switch. The syntax is:
6854
6855 -- CONDITIONAL_EXPRESSION ::=
6856 -- if EXPRESSION then EXPRESSION
6857 -- {elsif EXPRESSION then EXPRESSION}
6858 -- [else EXPRESSION]
6859
6860 -- And we add the additional constructs
6861
6862 -- PRIMARY ::= ( CONDITIONAL_EXPRESION )
6863 -- PRAGMA_ARGUMENT_ASSOCIATION ::= CONDITIONAL_EXPRESSION
6864
6865 -- Note: if we have (IF x1 THEN x2 ELSIF x3 THEN x4 ELSE x5) then it
6866 -- is represented as (IF x1 THEN x2 ELSE (IF x3 THEN x4 ELSE x5)) and
6867 -- the Is_Elsif flag is set on the inner conditional expression.
6868
6869 -- N_Conditional_Expression
6870 -- Sloc points to IF or ELSIF keyword
6871 -- Expressions (List1)
6872 -- Then_Actions (List2-Sem)
6873 -- Else_Actions (List3-Sem)
6874 -- Is_Elsif (Flag13) (set if comes from ELSIF)
6875 -- plus fields for expression
6876
6877 -------------------
6878 -- Expanded_Name --
6879 -------------------
6880
6881 -- The N_Expanded_Name node is used to represent a selected component
6882 -- name that has been resolved to an expanded name. The semantic phase
6883 -- replaces N_Selected_Component nodes that represent names by the use
6884 -- of this node, leaving the N_Selected_Component node used only when
6885 -- the prefix is a record or protected type.
6886
6887 -- The fields of the N_Expanded_Name node are layed out identically
6888 -- to those of the N_Selected_Component node, allowing conversion of
6889 -- an expanded name node to a selected component node to be done
6890 -- easily, see Sinfo.CN.Change_Selected_Component_To_Expanded_Name.
6891
6892 -- There is no special sprint syntax for an expanded name
6893
6894 -- N_Expanded_Name
6895 -- Sloc points to the period
6896 -- Chars (Name1) copy of Chars field of selector name
6897 -- Prefix (Node3)
6898 -- Selector_Name (Node2)
6899 -- Entity (Node4-Sem)
6900 -- Associated_Node (Node4-Sem)
6901 -- Redundant_Use (Flag13-Sem)
6902 -- Has_Private_View (Flag11-Sem) set in generic units.
6903 -- plus fields for expression
6904
6905 -----------------------------
6906 -- Expression with Actions --
6907 -----------------------------
6908
6909 -- This node is created by the analyzer/expander to handle some
6910 -- expansion cases, notably short circuit forms where there are
6911 -- actions associated with the right hand operand.
6912
6913 -- The N_Expression_With_Actions node represents an expression with
6914 -- an associated set of actions (which are executable statements and
6915 -- declarations, as might occur in a handled statement sequence).
6916
6917 -- The required semantics is that the set of actions is executed in
6918 -- the order in which it appears just before the expression is
6919 -- evaluated (and these actions must only be executed if the value
6920 -- of the expression is evaluated). The node is considered to be
6921 -- a subexpression, whose value is the value of the Expression after
6922 -- executing all the actions.
6923
6924 -- Note: if the actions contain declarations, then these declarations
6925 -- maybe referenced with in the expression. It is thus appropriate for
6926 -- the back end to create a scope that encompasses the construct (any
6927 -- declarations within the actions will definitely not be referenced
6928 -- once elaboration of the construct is completed).
6929
6930 -- Sprint syntax: do
6931 -- action;
6932 -- action;
6933 -- ...
6934 -- action;
6935 -- in expression end
6936
6937 -- N_Expression_With_Actions
6938 -- Actions (List1)
6939 -- Expression (Node3)
6940 -- plus fields for expression
6941
6942 -- Note: the actions list is always non-null, since we would
6943 -- never have created this node if there weren't some actions.
6944
6945 --------------------
6946 -- Free Statement --
6947 --------------------
6948
6949 -- The N_Free_Statement node is generated as a result of a call to an
6950 -- instantiation of Unchecked_Deallocation. The instantiation of this
6951 -- generic is handled specially and generates this node directly.
6952
6953 -- Sprint syntax: free expression
6954
6955 -- N_Free_Statement
6956 -- Sloc is copied from the unchecked deallocation call
6957 -- Expression (Node3) argument to unchecked deallocation call
6958 -- Storage_Pool (Node1-Sem)
6959 -- Procedure_To_Call (Node2-Sem)
6960 -- Actual_Designated_Subtype (Node4-Sem)
6961
6962 -- Note: in the case where a debug source file is generated, the Sloc
6963 -- for this node points to the FREE keyword in the Sprint file output.
6964
6965 -------------------
6966 -- Freeze Entity --
6967 -------------------
6968
6969 -- This node marks the point in a declarative part at which an entity
6970 -- declared therein becomes frozen. The expander places initialization
6971 -- procedures for types at those points. Gigi uses the freezing point
6972 -- to elaborate entities that may depend on previous private types.
6973
6974 -- See the section in Einfo "Delayed Freezing and Elaboration" for
6975 -- a full description of the use of this node.
6976
6977 -- The Entity field points back to the entity for the type (whose
6978 -- Freeze_Node field points back to this freeze node).
6979
6980 -- The Actions field contains a list of declarations and statements
6981 -- generated by the expander which are associated with the freeze
6982 -- node, and are elaborated as though the freeze node were replaced
6983 -- by this sequence of actions.
6984
6985 -- Note: the Sloc field in the freeze node references a construct
6986 -- associated with the freezing point. This is used for posting
6987 -- messages in some error/warning situations, e.g. the case where
6988 -- a primitive operation of a tagged type is declared too late.
6989
6990 -- Sprint syntax: freeze entity-name [
6991 -- freeze actions
6992 -- ]
6993
6994 -- N_Freeze_Entity
6995 -- Sloc points near freeze point (see above special note)
6996 -- Entity (Node4-Sem)
6997 -- Access_Types_To_Process (Elist2-Sem) (set to No_Elist if none)
6998 -- TSS_Elist (Elist3-Sem) (set to No_Elist if no associated TSS's)
6999 -- Actions (List1) (set to No_List if no freeze actions)
7000 -- First_Subtype_Link (Node5-Sem) (set to Empty if no link)
7001
7002 -- The Actions field holds actions associated with the freeze. These
7003 -- actions are elaborated at the point where the type is frozen.
7004
7005 -- Note: in the case where a debug source file is generated, the Sloc
7006 -- for this node points to the FREEZE keyword in the Sprint file output.
7007
7008 --------------------------------
7009 -- Implicit Label Declaration --
7010 --------------------------------
7011
7012 -- An implicit label declaration is created for every occurrence of a
7013 -- label on a statement or a label on a block or loop. It is chained
7014 -- in the declarations of the innermost enclosing block as specified
7015 -- in RM section 5.1 (3).
7016
7017 -- The Defining_Identifier is the actual identifier for the statement
7018 -- identifier. Note that the occurrence of the label is a reference, NOT
7019 -- the defining occurrence. The defining occurrence occurs at the head
7020 -- of the innermost enclosing block, and is represented by this node.
7021
7022 -- Note: from the grammar, this might better be called an implicit
7023 -- statement identifier declaration, but the term we choose seems
7024 -- friendlier, since at least informally statement identifiers are
7025 -- called labels in both cases (i.e. when used in labels, and when
7026 -- used as the identifiers of blocks and loops).
7027
7028 -- Note: although this is logically a semantic node, since it does not
7029 -- correspond directly to a source syntax construction, these nodes are
7030 -- actually created by the parser in a post pass done just after parsing
7031 -- is complete, before semantic analysis is started (see Par.Labl).
7032
7033 -- Sprint syntax: labelname : label;
7034
7035 -- N_Implicit_Label_Declaration
7036 -- Sloc points to the << of the label
7037 -- Defining_Identifier (Node1)
7038 -- Label_Construct (Node2-Sem)
7039
7040 -- Note: in the case where a debug source file is generated, the Sloc
7041 -- for this node points to the label name in the generated declaration.
7042
7043 ---------------------
7044 -- Itype_Reference --
7045 ---------------------
7046
7047 -- This node is used to create a reference to an Itype. The only purpose
7048 -- is to make sure the Itype is defined if this is the first reference.
7049
7050 -- A typical use of this node is when an Itype is to be referenced in
7051 -- two branches of an IF statement. In this case it is important that
7052 -- the first use of the Itype not be inside the conditional, since then
7053 -- it might not be defined if the other branch of the IF is taken, in
7054 -- the case where the definition generates elaboration code.
7055
7056 -- The Itype field points to the referenced Itype
7057
7058 -- Sprint syntax: reference itype-name
7059
7060 -- N_Itype_Reference
7061 -- Sloc points to the node generating the reference
7062 -- Itype (Node1-Sem)
7063
7064 -- Note: in the case where a debug source file is generated, the Sloc
7065 -- for this node points to the REFERENCE keyword in the file output.
7066
7067 ---------------------
7068 -- Raise_xxx_Error --
7069 ---------------------
7070
7071 -- One of these nodes is created during semantic analysis to replace
7072 -- a node for an expression that is determined to definitely raise
7073 -- the corresponding exception.
7074
7075 -- The N_Raise_xxx_Error node may also stand alone in place
7076 -- of a declaration or statement, in which case it simply causes
7077 -- the exception to be raised (i.e. it is equivalent to a raise
7078 -- statement that raises the corresponding exception). This use
7079 -- is distinguished by the fact that the Etype in this case is
7080 -- Standard_Void_Type, In the subexpression case, the Etype is the
7081 -- same as the type of the subexpression which it replaces.
7082
7083 -- If Condition is empty, then the raise is unconditional. If the
7084 -- Condition field is non-empty, it is a boolean expression which
7085 -- is first evaluated, and the exception is raised only if the
7086 -- value of the expression is True. In the unconditional case, the
7087 -- creation of this node is usually accompanied by a warning message
7088 -- error. The creation of this node will usually be accompanied by a
7089 -- message (unless it appears within the right operand of a short
7090 -- circuit form whose left argument is static and decisively
7091 -- eliminates elaboration of the raise operation. The condition field
7092 -- can ONLY be present when the node is used as a statement form, it
7093 -- may NOT be present in the case where the node appears within an
7094 -- expression.
7095
7096 -- The exception is generated with a message that contains the
7097 -- file name and line number, and then appended text. The Reason
7098 -- code shows the text to be added. The Reason code is an element
7099 -- of the type Types.RT_Exception_Code, and indicates both the
7100 -- message to be added, and the exception to be raised (which must
7101 -- match the node type). The value is stored by storing a Uint which
7102 -- is the Pos value of the enumeration element in this type.
7103
7104 -- Gigi restriction: This expander ensures that the type of the
7105 -- Condition field is always Standard.Boolean, even if the type
7106 -- in the source is some non-standard boolean type.
7107
7108 -- Sprint syntax: [xxx_error "msg"]
7109 -- or: [xxx_error when condition "msg"]
7110
7111 -- N_Raise_Constraint_Error
7112 -- Sloc references related construct
7113 -- Condition (Node1) (set to Empty if no condition)
7114 -- Reason (Uint3)
7115 -- plus fields for expression
7116
7117 -- N_Raise_Program_Error
7118 -- Sloc references related construct
7119 -- Condition (Node1) (set to Empty if no condition)
7120 -- Reason (Uint3)
7121 -- plus fields for expression
7122
7123 -- N_Raise_Storage_Error
7124 -- Sloc references related construct
7125 -- Condition (Node1) (set to Empty if no condition)
7126 -- Reason (Uint3)
7127 -- plus fields for expression
7128
7129 -- Note: Sloc is copied from the expression generating the exception.
7130 -- In the case where a debug source file is generated, the Sloc for
7131 -- this node points to the left bracket in the Sprint file output.
7132
7133 -- Note: the back end may be required to translate these nodes into
7134 -- appropriate goto statements. See description of N_Push/Pop_xxx_Label.
7135
7136 ---------------------------------------------
7137 -- Optimization of Exception Raise to Goto --
7138 ---------------------------------------------
7139
7140 -- In some cases, the front end will determine that any exception raised
7141 -- by the back end for a certain exception should be transformed into a
7142 -- goto statement.
7143
7144 -- There are three kinds of exceptions raised by the back end (note that
7145 -- for this purpose we consider gigi to be part of the back end in the
7146 -- gcc case):
7147
7148 -- 1. Exceptions resulting from N_Raise_xxx_Error nodes
7149 -- 2. Exceptions from checks triggered by Do_xxx_Check flags
7150 -- 3. Other cases not specifically marked by the front end
7151
7152 -- Normally all such exceptions are translated into calls to the proper
7153 -- Rcheck_xx procedure, where xx encodes both the exception to be raised
7154 -- and the exception message.
7155
7156 -- The front end may determine that for a particular sequence of code,
7157 -- exceptions in any of these three categories for a particular builtin
7158 -- exception should result in a goto, rather than a call to Rcheck_xx.
7159 -- The exact sequence to be generated is:
7160
7161 -- Local_Raise (exception'Identity);
7162 -- goto Label
7163
7164 -- The front end marks such a sequence of code by bracketing it with
7165 -- push and pop nodes:
7166
7167 -- N_Push_xxx_Label (referencing the label)
7168 -- ...
7169 -- (code where transformation is expected for exception xxx)
7170 -- ...
7171 -- N_Pop_xxx_Label
7172
7173 -- The use of push/pop reflects the fact that such regions can properly
7174 -- nest, and one special case is a subregion in which no transformation
7175 -- is allowed. Such a region is marked by a N_Push_xxx_Label node whose
7176 -- Exception_Label field is Empty.
7177
7178 -- N_Push_Constraint_Error_Label
7179 -- Sloc references first statement in region covered
7180 -- Exception_Label (Node5-Sem)
7181
7182 -- N_Push_Program_Error_Label
7183 -- Sloc references first statement in region covered
7184 -- Exception_Label (Node5-Sem)
7185
7186 -- N_Push_Storage_Error_Label
7187 -- Sloc references first statement in region covered
7188 -- Exception_Label (Node5-Sem)
7189
7190 -- N_Pop_Constraint_Error_Label
7191 -- Sloc references last statement in region covered
7192
7193 -- N_Pop_Program_Error_Label
7194 -- Sloc references last statement in region covered
7195
7196 -- N_Pop_Storage_Error_Label
7197 -- Sloc references last statement in region covered
7198
7199 ---------------
7200 -- Reference --
7201 ---------------
7202
7203 -- For a number of purposes, we need to construct references to objects.
7204 -- These references are subsequently treated as normal access values.
7205 -- An example is the construction of the parameter block passed to a
7206 -- task entry. The N_Reference node is provided for this purpose. It is
7207 -- similar in effect to the use of the Unrestricted_Access attribute,
7208 -- and like Unrestricted_Access can be applied to objects which would
7209 -- not be valid prefixes for the Unchecked_Access attribute (e.g.
7210 -- objects which are not aliased, and slices). In addition it can be
7211 -- applied to composite type values as well as objects, including string
7212 -- values and aggregates.
7213
7214 -- Note: we use the Prefix field for this expression so that the
7215 -- resulting node can be treated using common code with the attribute
7216 -- nodes for the 'Access and related attributes. Logically it would make
7217 -- more sense to call it an Expression field, but then we would have to
7218 -- special case the treatment of the N_Reference node.
7219
7220 -- Sprint syntax: prefix'reference
7221
7222 -- N_Reference
7223 -- Sloc is copied from the expression
7224 -- Prefix (Node3)
7225 -- plus fields for expression
7226
7227 -- Note: in the case where a debug source file is generated, the Sloc
7228 -- for this node points to the quote in the Sprint file output.
7229
7230 -----------------
7231 -- SCIL Nodes --
7232 -----------------
7233
7234 -- SCIL nodes are special nodes added to the tree when the CodePeer
7235 -- mode is active. They help the CodePeer backend to locate nodes that
7236 -- require special processing.
7237
7238 -- Major documentation on the general design of the SCIL interface, and
7239 -- in particular detailed description of these nodes is missing and is
7240 -- to be supplied in the future, when the design has finalized ???
7241
7242 -- Meanwhile these nodes should be considered in experimental form, and
7243 -- should be ignored by all code generating back ends. ???
7244
7245 -- N_SCIL_Dispatch_Table_Tag_Init
7246 -- Sloc references a node for a tag initialization
7247 -- SCIL_Entity (Node4-Sem)
7248
7249 -- N_SCIL_Dispatching_Call
7250 -- Sloc references the node of a dispatching call
7251 -- SCIL_Target_Prim (Node2-Sem)
7252 -- SCIL_Entity (Node4-Sem)
7253 -- SCIL_Controlling_Tag (Node5-Sem)
7254
7255 -- N_SCIL_Membership_Test
7256 -- Sloc references the node of a membership test
7257 -- SCIL_Tag_Value (Node5-Sem)
7258 -- SCIL_Entity (Node4-Sem)
7259
7260 ---------------------
7261 -- Subprogram_Info --
7262 ---------------------
7263
7264 -- This node generates the appropriate Subprogram_Info value for a
7265 -- given procedure. See Ada.Exceptions for further details
7266
7267 -- Sprint syntax: subprog'subprogram_info
7268
7269 -- N_Subprogram_Info
7270 -- Sloc points to the entity for the procedure
7271 -- Identifier (Node1) identifier referencing the procedure
7272 -- Etype (Node5-Sem) type (always set to Ada.Exceptions.Code_Loc
7273
7274 -- Note: in the case where a debug source file is generated, the Sloc
7275 -- for this node points to the quote in the Sprint file output.
7276
7277 --------------------------
7278 -- Unchecked Expression --
7279 --------------------------
7280
7281 -- An unchecked expression is one that must be analyzed and resolved
7282 -- with all checks off, regardless of the current setting of scope
7283 -- suppress flags.
7284
7285 -- Sprint syntax: `(expression)
7286
7287 -- Note: this node is always removed from the tree (and replaced by
7288 -- its constituent expression) on completion of analysis, so it only
7289 -- appears in intermediate trees, and will never be seen by Gigi.
7290
7291 -- N_Unchecked_Expression
7292 -- Sloc is a copy of the Sloc of the expression
7293 -- Expression (Node3)
7294 -- plus fields for expression
7295
7296 -- Note: in the case where a debug source file is generated, the Sloc
7297 -- for this node points to the back quote in the Sprint file output.
7298
7299 -------------------------------
7300 -- Unchecked Type Conversion --
7301 -------------------------------
7302
7303 -- An unchecked type conversion node represents the semantic action
7304 -- corresponding to a call to an instantiation of Unchecked_Conversion.
7305 -- It is generated as a result of actual use of Unchecked_Conversion
7306 -- and also the expander generates unchecked type conversion nodes
7307 -- directly for expansion of complex semantic actions.
7308
7309 -- Note: an unchecked type conversion is a variable as far as the
7310 -- semantics are concerned, which is convenient for the expander.
7311 -- This does not change what Ada source programs are legal, since
7312 -- clearly a function call to an instantiation of Unchecked_Conversion
7313 -- is not a variable in any case.
7314
7315 -- Sprint syntax: subtype-mark!(expression)
7316
7317 -- N_Unchecked_Type_Conversion
7318 -- Sloc points to related node in source
7319 -- Subtype_Mark (Node4)
7320 -- Expression (Node3)
7321 -- Kill_Range_Check (Flag11-Sem)
7322 -- No_Truncation (Flag17-Sem)
7323 -- plus fields for expression
7324
7325 -- Note: in the case where a debug source file is generated, the Sloc
7326 -- for this node points to the exclamation in the Sprint file output.
7327
7328 -----------------------------------
7329 -- Validate_Unchecked_Conversion --
7330 -----------------------------------
7331
7332 -- The front end does most of the validation of unchecked conversion,
7333 -- including checking sizes (this is done after the back end is called
7334 -- to take advantage of back-annotation of calculated sizes).
7335
7336 -- The front end also deals with specific cases that are not allowed
7337 -- e.g. involving unconstrained array types.
7338
7339 -- For the case of the standard gigi backend, this means that all
7340 -- checks are done in the front-end.
7341
7342 -- However, in the case of specialized back-ends, notably the JVM
7343 -- backend for JGNAT, additional requirements and restrictions apply
7344 -- to unchecked conversion, and these are most conveniently performed
7345 -- in the specialized back-end.
7346
7347 -- To accommodate this requirement, for such back ends, the following
7348 -- special node is generated recording an unchecked conversion that
7349 -- needs to be validated. The back end should post an appropriate
7350 -- error message if the unchecked conversion is invalid or warrants
7351 -- a special warning message.
7352
7353 -- Source_Type and Target_Type point to the entities for the two
7354 -- types involved in the unchecked conversion instantiation that
7355 -- is to be validated.
7356
7357 -- Sprint syntax: validate Unchecked_Conversion (source, target);
7358
7359 -- N_Validate_Unchecked_Conversion
7360 -- Sloc points to instantiation (location for warning message)
7361 -- Source_Type (Node1-Sem)
7362 -- Target_Type (Node2-Sem)
7363
7364 -- Note: in the case where a debug source file is generated, the Sloc
7365 -- for this node points to the VALIDATE keyword in the file output.
7366
7367 -----------
7368 -- Empty --
7369 -----------
7370
7371 -- Used as the contents of the Nkind field of the dummy Empty node
7372 -- and in some other situations to indicate an uninitialized value.
7373
7374 -- N_Empty
7375 -- Chars (Name1) is set to No_Name
7376
7377 -----------
7378 -- Error --
7379 -----------
7380
7381 -- Used as the contents of the Nkind field of the dummy Error node.
7382 -- Has an Etype field, which gets set to Any_Type later on, to help
7383 -- error recovery (Error_Posted is also set in the Error node).
7384
7385 -- N_Error
7386 -- Chars (Name1) is set to Error_Name
7387 -- Etype (Node5-Sem)
7388
7389 --------------------------
7390 -- Node Type Definition --
7391 --------------------------
7392
7393 -- The following is the definition of the Node_Kind type. As previously
7394 -- discussed, this is separated off to allow rearrangement of the order to
7395 -- facilitate definition of subtype ranges. The comments show the subtype
7396 -- classes which apply to each set of node kinds. The first entry in the
7397 -- comment characterizes the following list of nodes.
7398
7399 type Node_Kind is (
7400 N_Unused_At_Start,
7401
7402 -- N_Representation_Clause
7403
7404 N_At_Clause,
7405 N_Component_Clause,
7406 N_Enumeration_Representation_Clause,
7407 N_Mod_Clause,
7408 N_Record_Representation_Clause,
7409
7410 -- N_Representation_Clause, N_Has_Chars
7411
7412 N_Attribute_Definition_Clause,
7413
7414 -- N_Has_Chars
7415
7416 N_Empty,
7417 N_Pragma_Argument_Association,
7418
7419 -- N_Has_Etype
7420
7421 N_Error,
7422
7423 -- N_Entity, N_Has_Etype, N_Has_Chars
7424
7425 N_Defining_Character_Literal,
7426 N_Defining_Identifier,
7427 N_Defining_Operator_Symbol,
7428
7429 -- N_Subexpr, N_Has_Etype, N_Has_Chars, N_Has_Entity
7430
7431 N_Expanded_Name,
7432
7433 -- N_Direct_Name, N_Subexpr, N_Has_Etype,
7434 -- N_Has_Chars, N_Has_Entity
7435
7436 N_Identifier,
7437 N_Operator_Symbol,
7438
7439 -- N_Direct_Name, N_Subexpr, N_Has_Etype,
7440 -- N_Has_Chars, N_Has_Entity
7441
7442 N_Character_Literal,
7443
7444 -- N_Binary_Op, N_Op, N_Subexpr,
7445 -- N_Has_Etype, N_Has_Chars, N_Has_Entity
7446
7447 N_Op_Add,
7448 N_Op_Concat,
7449 N_Op_Expon,
7450 N_Op_Subtract,
7451
7452 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Treat_Fixed_As_Integer
7453 -- N_Has_Etype, N_Has_Chars, N_Has_Entity, N_Multiplying_Operator
7454
7455 N_Op_Divide,
7456 N_Op_Mod,
7457 N_Op_Multiply,
7458 N_Op_Rem,
7459
7460 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
7461 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean
7462
7463 N_Op_And,
7464
7465 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
7466 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean, N_Op_Compare
7467
7468 N_Op_Eq,
7469 N_Op_Ge,
7470 N_Op_Gt,
7471 N_Op_Le,
7472 N_Op_Lt,
7473 N_Op_Ne,
7474
7475 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
7476 -- N_Has_Entity, N_Has_Chars, N_Op_Boolean
7477
7478 N_Op_Or,
7479 N_Op_Xor,
7480
7481 -- N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype,
7482 -- N_Op_Shift, N_Has_Chars, N_Has_Entity
7483
7484 N_Op_Rotate_Left,
7485 N_Op_Rotate_Right,
7486 N_Op_Shift_Left,
7487 N_Op_Shift_Right,
7488 N_Op_Shift_Right_Arithmetic,
7489
7490 -- N_Unary_Op, N_Op, N_Subexpr, N_Has_Etype,
7491 -- N_Has_Chars, N_Has_Entity
7492
7493 N_Op_Abs,
7494 N_Op_Minus,
7495 N_Op_Not,
7496 N_Op_Plus,
7497
7498 -- N_Subexpr, N_Has_Etype, N_Has_Entity
7499
7500 N_Attribute_Reference,
7501
7502 -- N_Subexpr, N_Has_Etype, N_Membership_Test
7503
7504 N_In,
7505 N_Not_In,
7506
7507 -- N_Subexpr, N_Has_Etype, N_Short_Circuit
7508
7509 N_And_Then,
7510 N_Or_Else,
7511
7512 -- N_Subexpr, N_Has_Etype
7513
7514 N_Conditional_Expression,
7515 N_Explicit_Dereference,
7516 N_Expression_With_Actions,
7517 N_Function_Call,
7518 N_Indexed_Component,
7519 N_Integer_Literal,
7520 N_Null,
7521 N_Procedure_Call_Statement,
7522 N_Qualified_Expression,
7523 N_Quantified_Expression,
7524
7525 -- N_Raise_xxx_Error, N_Subexpr, N_Has_Etype
7526
7527 N_Raise_Constraint_Error,
7528 N_Raise_Program_Error,
7529 N_Raise_Storage_Error,
7530
7531 -- N_Subexpr, N_Has_Etype
7532
7533 N_Aggregate,
7534 N_Allocator,
7535 N_Case_Expression,
7536 N_Extension_Aggregate,
7537 N_Range,
7538 N_Real_Literal,
7539 N_Reference,
7540 N_Selected_Component,
7541 N_Slice,
7542 N_String_Literal,
7543 N_Subprogram_Info,
7544 N_Type_Conversion,
7545 N_Unchecked_Expression,
7546 N_Unchecked_Type_Conversion,
7547
7548 -- N_Has_Etype
7549
7550 N_Subtype_Indication,
7551
7552 -- N_Declaration
7553
7554 N_Component_Declaration,
7555 N_Entry_Declaration,
7556 N_Formal_Object_Declaration,
7557 N_Formal_Type_Declaration,
7558 N_Full_Type_Declaration,
7559 N_Incomplete_Type_Declaration,
7560 N_Iterator_Specification,
7561 N_Loop_Parameter_Specification,
7562 N_Object_Declaration,
7563 N_Parameterized_Expression,
7564 N_Protected_Type_Declaration,
7565 N_Private_Extension_Declaration,
7566 N_Private_Type_Declaration,
7567 N_Subtype_Declaration,
7568
7569 -- N_Subprogram_Specification, N_Declaration
7570
7571 N_Function_Specification,
7572 N_Procedure_Specification,
7573
7574 -- N_Access_To_Subprogram_Definition
7575
7576 N_Access_Function_Definition,
7577 N_Access_Procedure_Definition,
7578
7579 -- N_Later_Decl_Item
7580
7581 N_Task_Type_Declaration,
7582
7583 -- N_Body_Stub, N_Later_Decl_Item
7584
7585 N_Package_Body_Stub,
7586 N_Protected_Body_Stub,
7587 N_Subprogram_Body_Stub,
7588 N_Task_Body_Stub,
7589
7590 -- N_Generic_Instantiation, N_Later_Decl_Item
7591 -- N_Subprogram_Instantiation
7592
7593 N_Function_Instantiation,
7594 N_Procedure_Instantiation,
7595
7596 -- N_Generic_Instantiation, N_Later_Decl_Item
7597
7598 N_Package_Instantiation,
7599
7600 -- N_Unit_Body, N_Later_Decl_Item, N_Proper_Body
7601
7602 N_Package_Body,
7603 N_Subprogram_Body,
7604
7605 -- N_Later_Decl_Item, N_Proper_Body
7606
7607 N_Protected_Body,
7608 N_Task_Body,
7609
7610 -- N_Later_Decl_Item
7611
7612 N_Implicit_Label_Declaration,
7613 N_Package_Declaration,
7614 N_Single_Task_Declaration,
7615 N_Subprogram_Declaration,
7616 N_Use_Package_Clause,
7617
7618 -- N_Generic_Declaration, N_Later_Decl_Item
7619
7620 N_Generic_Package_Declaration,
7621 N_Generic_Subprogram_Declaration,
7622
7623 -- N_Array_Type_Definition
7624
7625 N_Constrained_Array_Definition,
7626 N_Unconstrained_Array_Definition,
7627
7628 -- N_Renaming_Declaration
7629
7630 N_Exception_Renaming_Declaration,
7631 N_Object_Renaming_Declaration,
7632 N_Package_Renaming_Declaration,
7633 N_Subprogram_Renaming_Declaration,
7634
7635 -- N_Generic_Renaming_Declaration, N_Renaming_Declaration
7636
7637 N_Generic_Function_Renaming_Declaration,
7638 N_Generic_Package_Renaming_Declaration,
7639 N_Generic_Procedure_Renaming_Declaration,
7640
7641 -- N_Statement_Other_Than_Procedure_Call
7642
7643 N_Abort_Statement,
7644 N_Accept_Statement,
7645 N_Assignment_Statement,
7646 N_Asynchronous_Select,
7647 N_Block_Statement,
7648 N_Case_Statement,
7649 N_Code_Statement,
7650 N_Conditional_Entry_Call,
7651
7652 -- N_Statement_Other_Than_Procedure_Call. N_Delay_Statement
7653
7654 N_Delay_Relative_Statement,
7655 N_Delay_Until_Statement,
7656
7657 -- N_Statement_Other_Than_Procedure_Call
7658
7659 N_Entry_Call_Statement,
7660 N_Free_Statement,
7661 N_Goto_Statement,
7662 N_Loop_Statement,
7663 N_Null_Statement,
7664 N_Raise_Statement,
7665 N_Requeue_Statement,
7666 N_Return_Statement, -- renamed as N_Simple_Return_Statement below
7667 N_Extended_Return_Statement,
7668 N_Selective_Accept,
7669 N_Timed_Entry_Call,
7670
7671 -- N_Statement_Other_Than_Procedure_Call, N_Has_Condition
7672
7673 N_Exit_Statement,
7674 N_If_Statement,
7675
7676 -- N_Has_Condition
7677
7678 N_Accept_Alternative,
7679 N_Delay_Alternative,
7680 N_Elsif_Part,
7681 N_Entry_Body_Formal_Part,
7682 N_Iteration_Scheme,
7683 N_Terminate_Alternative,
7684
7685 -- N_Formal_Subprogram_Declaration
7686
7687 N_Formal_Abstract_Subprogram_Declaration,
7688 N_Formal_Concrete_Subprogram_Declaration,
7689
7690 -- N_Push_xxx_Label, N_Push_Pop_xxx_Label
7691
7692 N_Push_Constraint_Error_Label,
7693 N_Push_Program_Error_Label,
7694 N_Push_Storage_Error_Label,
7695
7696 -- N_Pop_xxx_Label, N_Push_Pop_xxx_Label
7697
7698 N_Pop_Constraint_Error_Label,
7699 N_Pop_Program_Error_Label,
7700 N_Pop_Storage_Error_Label,
7701
7702 -- SCIL nodes
7703
7704 N_SCIL_Dispatch_Table_Tag_Init,
7705 N_SCIL_Dispatching_Call,
7706 N_SCIL_Membership_Test,
7707
7708 -- Other nodes (not part of any subtype class)
7709
7710 N_Abortable_Part,
7711 N_Abstract_Subprogram_Declaration,
7712 N_Access_Definition,
7713 N_Access_To_Object_Definition,
7714 N_Aspect_Specification,
7715 N_Case_Expression_Alternative,
7716 N_Case_Statement_Alternative,
7717 N_Compilation_Unit,
7718 N_Compilation_Unit_Aux,
7719 N_Component_Association,
7720 N_Component_Definition,
7721 N_Component_List,
7722 N_Derived_Type_Definition,
7723 N_Decimal_Fixed_Point_Definition,
7724 N_Defining_Program_Unit_Name,
7725 N_Delta_Constraint,
7726 N_Designator,
7727 N_Digits_Constraint,
7728 N_Discriminant_Association,
7729 N_Discriminant_Specification,
7730 N_Enumeration_Type_Definition,
7731 N_Entry_Body,
7732 N_Entry_Call_Alternative,
7733 N_Entry_Index_Specification,
7734 N_Exception_Declaration,
7735 N_Exception_Handler,
7736 N_Floating_Point_Definition,
7737 N_Formal_Decimal_Fixed_Point_Definition,
7738 N_Formal_Derived_Type_Definition,
7739 N_Formal_Discrete_Type_Definition,
7740 N_Formal_Floating_Point_Definition,
7741 N_Formal_Modular_Type_Definition,
7742 N_Formal_Ordinary_Fixed_Point_Definition,
7743 N_Formal_Package_Declaration,
7744 N_Formal_Private_Type_Definition,
7745 N_Formal_Signed_Integer_Type_Definition,
7746 N_Freeze_Entity,
7747 N_Generic_Association,
7748 N_Handled_Sequence_Of_Statements,
7749 N_Index_Or_Discriminant_Constraint,
7750 N_Itype_Reference,
7751 N_Label,
7752 N_Modular_Type_Definition,
7753 N_Number_Declaration,
7754 N_Ordinary_Fixed_Point_Definition,
7755 N_Others_Choice,
7756 N_Package_Specification,
7757 N_Parameter_Association,
7758 N_Parameter_Specification,
7759 N_Pragma,
7760 N_Protected_Definition,
7761 N_Range_Constraint,
7762 N_Real_Range_Specification,
7763 N_Record_Definition,
7764 N_Signed_Integer_Type_Definition,
7765 N_Single_Protected_Declaration,
7766 N_Subunit,
7767 N_Task_Definition,
7768 N_Triggering_Alternative,
7769 N_Use_Type_Clause,
7770 N_Validate_Unchecked_Conversion,
7771 N_Variant,
7772 N_Variant_Part,
7773 N_With_Clause,
7774 N_Unused_At_End);
7775
7776 for Node_Kind'Size use 8;
7777 -- The data structures in Atree assume this!
7778
7779 ----------------------------
7780 -- Node Class Definitions --
7781 ----------------------------
7782
7783 subtype N_Access_To_Subprogram_Definition is Node_Kind range
7784 N_Access_Function_Definition ..
7785 N_Access_Procedure_Definition;
7786
7787 subtype N_Array_Type_Definition is Node_Kind range
7788 N_Constrained_Array_Definition ..
7789 N_Unconstrained_Array_Definition;
7790
7791 subtype N_Binary_Op is Node_Kind range
7792 N_Op_Add ..
7793 N_Op_Shift_Right_Arithmetic;
7794
7795 subtype N_Body_Stub is Node_Kind range
7796 N_Package_Body_Stub ..
7797 N_Task_Body_Stub;
7798
7799 subtype N_Declaration is Node_Kind range
7800 N_Component_Declaration ..
7801 N_Procedure_Specification;
7802 -- Note: this includes all constructs normally thought of as declarations
7803 -- except those which are separately grouped as later declarations.
7804
7805 subtype N_Delay_Statement is Node_Kind range
7806 N_Delay_Relative_Statement ..
7807 N_Delay_Until_Statement;
7808
7809 subtype N_Direct_Name is Node_Kind range
7810 N_Identifier ..
7811 N_Character_Literal;
7812
7813 subtype N_Entity is Node_Kind range
7814 N_Defining_Character_Literal ..
7815 N_Defining_Operator_Symbol;
7816
7817 subtype N_Formal_Subprogram_Declaration is Node_Kind range
7818 N_Formal_Abstract_Subprogram_Declaration ..
7819 N_Formal_Concrete_Subprogram_Declaration;
7820
7821 subtype N_Generic_Declaration is Node_Kind range
7822 N_Generic_Package_Declaration ..
7823 N_Generic_Subprogram_Declaration;
7824
7825 subtype N_Generic_Instantiation is Node_Kind range
7826 N_Function_Instantiation ..
7827 N_Package_Instantiation;
7828
7829 subtype N_Generic_Renaming_Declaration is Node_Kind range
7830 N_Generic_Function_Renaming_Declaration ..
7831 N_Generic_Procedure_Renaming_Declaration;
7832
7833 subtype N_Has_Chars is Node_Kind range
7834 N_Attribute_Definition_Clause ..
7835 N_Op_Plus;
7836
7837 subtype N_Has_Entity is Node_Kind range
7838 N_Expanded_Name ..
7839 N_Attribute_Reference;
7840 -- Nodes that have Entity fields
7841 -- Warning: DOES NOT INCLUDE N_Freeze_Entity, N_Aspect_Specification,
7842 -- or N_Attribute_Definition_Clause.
7843
7844 subtype N_Has_Etype is Node_Kind range
7845 N_Error ..
7846 N_Subtype_Indication;
7847
7848 subtype N_Has_Treat_Fixed_As_Integer is Node_Kind range
7849 N_Op_Divide ..
7850 N_Op_Rem;
7851
7852 subtype N_Multiplying_Operator is Node_Kind range
7853 N_Op_Divide ..
7854 N_Op_Rem;
7855
7856 subtype N_Later_Decl_Item is Node_Kind range
7857 N_Task_Type_Declaration ..
7858 N_Generic_Subprogram_Declaration;
7859 -- Note: this is Ada 83 relevant only (see Ada 83 RM 3.9 (2)) and includes
7860 -- only those items which can appear as later declarative items. This also
7861 -- includes N_Implicit_Label_Declaration which is not specifically in the
7862 -- grammar but may appear as a valid later declarative items. It does NOT
7863 -- include N_Pragma which can also appear among later declarative items.
7864 -- It does however include N_Protected_Body, which is a bit peculiar, but
7865 -- harmless since this cannot appear in Ada 83 mode anyway.
7866
7867 subtype N_Membership_Test is Node_Kind range
7868 N_In ..
7869 N_Not_In;
7870
7871 subtype N_Op is Node_Kind range
7872 N_Op_Add ..
7873 N_Op_Plus;
7874
7875 subtype N_Op_Boolean is Node_Kind range
7876 N_Op_And ..
7877 N_Op_Xor;
7878 -- Binary operators which take operands of a boolean type, and yield
7879 -- a result of a boolean type.
7880
7881 subtype N_Op_Compare is Node_Kind range
7882 N_Op_Eq ..
7883 N_Op_Ne;
7884
7885 subtype N_Op_Shift is Node_Kind range
7886 N_Op_Rotate_Left ..
7887 N_Op_Shift_Right_Arithmetic;
7888
7889 subtype N_Proper_Body is Node_Kind range
7890 N_Package_Body ..
7891 N_Task_Body;
7892
7893 subtype N_Push_xxx_Label is Node_Kind range
7894 N_Push_Constraint_Error_Label ..
7895 N_Push_Storage_Error_Label;
7896
7897 subtype N_Pop_xxx_Label is Node_Kind range
7898 N_Pop_Constraint_Error_Label ..
7899 N_Pop_Storage_Error_Label;
7900
7901 subtype N_Push_Pop_xxx_Label is Node_Kind range
7902 N_Push_Constraint_Error_Label ..
7903 N_Pop_Storage_Error_Label;
7904
7905 subtype N_Raise_xxx_Error is Node_Kind range
7906 N_Raise_Constraint_Error ..
7907 N_Raise_Storage_Error;
7908
7909 subtype N_Renaming_Declaration is Node_Kind range
7910 N_Exception_Renaming_Declaration ..
7911 N_Generic_Procedure_Renaming_Declaration;
7912
7913 subtype N_Representation_Clause is Node_Kind range
7914 N_At_Clause ..
7915 N_Attribute_Definition_Clause;
7916
7917 subtype N_Short_Circuit is Node_Kind range
7918 N_And_Then ..
7919 N_Or_Else;
7920
7921 subtype N_SCIL_Node is Node_Kind range
7922 N_SCIL_Dispatch_Table_Tag_Init ..
7923 N_SCIL_Membership_Test;
7924
7925 subtype N_Statement_Other_Than_Procedure_Call is Node_Kind range
7926 N_Abort_Statement ..
7927 N_If_Statement;
7928 -- Note that this includes all statement types except for the cases of the
7929 -- N_Procedure_Call_Statement which is considered to be a subexpression
7930 -- (since overloading is possible, so it needs to go through the normal
7931 -- overloading resolution for expressions).
7932
7933 subtype N_Subprogram_Instantiation is Node_Kind range
7934 N_Function_Instantiation ..
7935 N_Procedure_Instantiation;
7936
7937 subtype N_Has_Condition is Node_Kind range
7938 N_Exit_Statement ..
7939 N_Terminate_Alternative;
7940 -- Nodes with condition fields (does not include N_Raise_xxx_Error)
7941
7942 subtype N_Subexpr is Node_Kind range
7943 N_Expanded_Name ..
7944 N_Unchecked_Type_Conversion;
7945 -- Nodes with expression fields
7946
7947 subtype N_Subprogram_Specification is Node_Kind range
7948 N_Function_Specification ..
7949 N_Procedure_Specification;
7950
7951 subtype N_Unary_Op is Node_Kind range
7952 N_Op_Abs ..
7953 N_Op_Plus;
7954
7955 subtype N_Unit_Body is Node_Kind range
7956 N_Package_Body ..
7957 N_Subprogram_Body;
7958
7959 ---------------------------
7960 -- Node Access Functions --
7961 ---------------------------
7962
7963 -- The following functions return the contents of the indicated field of
7964 -- the node referenced by the argument, which is a Node_Id. They provide
7965 -- logical access to fields in the node which could be accessed using the
7966 -- Atree.Unchecked_Access package, but the idea is always to use these
7967 -- higher level routines which preserve strong typing. In debug mode,
7968 -- these routines check that they are being applied to an appropriate
7969 -- node, as well as checking that the node is in range.
7970
7971 function ABE_Is_Certain
7972 (N : Node_Id) return Boolean; -- Flag18
7973
7974 function Abort_Present
7975 (N : Node_Id) return Boolean; -- Flag15
7976
7977 function Abortable_Part
7978 (N : Node_Id) return Node_Id; -- Node2
7979
7980 function Abstract_Present
7981 (N : Node_Id) return Boolean; -- Flag4
7982
7983 function Accept_Handler_Records
7984 (N : Node_Id) return List_Id; -- List5
7985
7986 function Accept_Statement
7987 (N : Node_Id) return Node_Id; -- Node2
7988
7989 function Access_Definition
7990 (N : Node_Id) return Node_Id; -- Node3
7991
7992 function Access_To_Subprogram_Definition
7993 (N : Node_Id) return Node_Id; -- Node3
7994
7995 function Access_Types_To_Process
7996 (N : Node_Id) return Elist_Id; -- Elist2
7997
7998 function Actions
7999 (N : Node_Id) return List_Id; -- List1
8000
8001 function Activation_Chain_Entity
8002 (N : Node_Id) return Node_Id; -- Node3
8003
8004 function Acts_As_Spec
8005 (N : Node_Id) return Boolean; -- Flag4
8006
8007 function Actual_Designated_Subtype
8008 (N : Node_Id) return Node_Id; -- Node4
8009
8010 function Address_Warning_Posted
8011 (N : Node_Id) return Boolean; -- Flag18
8012
8013 function Aggregate_Bounds
8014 (N : Node_Id) return Node_Id; -- Node3
8015
8016 function Aliased_Present
8017 (N : Node_Id) return Boolean; -- Flag4
8018
8019 function All_Others
8020 (N : Node_Id) return Boolean; -- Flag11
8021
8022 function All_Present
8023 (N : Node_Id) return Boolean; -- Flag15
8024
8025 function Alternatives
8026 (N : Node_Id) return List_Id; -- List4
8027
8028 function Ancestor_Part
8029 (N : Node_Id) return Node_Id; -- Node3
8030
8031 function Array_Aggregate
8032 (N : Node_Id) return Node_Id; -- Node3
8033
8034 function Aspect_Cancel
8035 (N : Node_Id) return Boolean; -- Flag11
8036
8037 function Aspect_Rep_Item
8038 (N : Node_Id) return Node_Id; -- Node2
8039
8040 function Assignment_OK
8041 (N : Node_Id) return Boolean; -- Flag15
8042
8043 function Associated_Node
8044 (N : Node_Id) return Node_Id; -- Node4
8045
8046 function At_End_Proc
8047 (N : Node_Id) return Node_Id; -- Node1
8048
8049 function Attribute_Name
8050 (N : Node_Id) return Name_Id; -- Name2
8051
8052 function Aux_Decls_Node
8053 (N : Node_Id) return Node_Id; -- Node5
8054
8055 function Backwards_OK
8056 (N : Node_Id) return Boolean; -- Flag6
8057
8058 function Bad_Is_Detected
8059 (N : Node_Id) return Boolean; -- Flag15
8060
8061 function By_Ref
8062 (N : Node_Id) return Boolean; -- Flag5
8063
8064 function Body_Required
8065 (N : Node_Id) return Boolean; -- Flag13
8066
8067 function Body_To_Inline
8068 (N : Node_Id) return Node_Id; -- Node3
8069
8070 function Box_Present
8071 (N : Node_Id) return Boolean; -- Flag15
8072
8073 function Char_Literal_Value
8074 (N : Node_Id) return Uint; -- Uint2
8075
8076 function Chars
8077 (N : Node_Id) return Name_Id; -- Name1
8078
8079 function Check_Address_Alignment
8080 (N : Node_Id) return Boolean; -- Flag11
8081
8082 function Choice_Parameter
8083 (N : Node_Id) return Node_Id; -- Node2
8084
8085 function Choices
8086 (N : Node_Id) return List_Id; -- List1
8087
8088 function Class_Present
8089 (N : Node_Id) return Boolean; -- Flag6
8090
8091 function Coextensions
8092 (N : Node_Id) return Elist_Id; -- Elist4
8093
8094 function Comes_From_Extended_Return_Statement
8095 (N : Node_Id) return Boolean; -- Flag18
8096
8097 function Compile_Time_Known_Aggregate
8098 (N : Node_Id) return Boolean; -- Flag18
8099
8100 function Component_Associations
8101 (N : Node_Id) return List_Id; -- List2
8102
8103 function Component_Clauses
8104 (N : Node_Id) return List_Id; -- List3
8105
8106 function Component_Definition
8107 (N : Node_Id) return Node_Id; -- Node4
8108
8109 function Component_Items
8110 (N : Node_Id) return List_Id; -- List3
8111
8112 function Component_List
8113 (N : Node_Id) return Node_Id; -- Node1
8114
8115 function Component_Name
8116 (N : Node_Id) return Node_Id; -- Node1
8117
8118 function Componentwise_Assignment
8119 (N : Node_Id) return Boolean; -- Flag14
8120
8121 function Condition
8122 (N : Node_Id) return Node_Id; -- Node1
8123
8124 function Condition_Actions
8125 (N : Node_Id) return List_Id; -- List3
8126
8127 function Config_Pragmas
8128 (N : Node_Id) return List_Id; -- List4
8129
8130 function Constant_Present
8131 (N : Node_Id) return Boolean; -- Flag17
8132
8133 function Constraint
8134 (N : Node_Id) return Node_Id; -- Node3
8135
8136 function Constraints
8137 (N : Node_Id) return List_Id; -- List1
8138
8139 function Context_Installed
8140 (N : Node_Id) return Boolean; -- Flag13
8141
8142 function Context_Pending
8143 (N : Node_Id) return Boolean; -- Flag16
8144
8145 function Context_Items
8146 (N : Node_Id) return List_Id; -- List1
8147
8148 function Controlling_Argument
8149 (N : Node_Id) return Node_Id; -- Node1
8150
8151 function Conversion_OK
8152 (N : Node_Id) return Boolean; -- Flag14
8153
8154 function Corresponding_Body
8155 (N : Node_Id) return Node_Id; -- Node5
8156
8157 function Corresponding_Formal_Spec
8158 (N : Node_Id) return Node_Id; -- Node3
8159
8160 function Corresponding_Generic_Association
8161 (N : Node_Id) return Node_Id; -- Node5
8162
8163 function Corresponding_Integer_Value
8164 (N : Node_Id) return Uint; -- Uint4
8165
8166 function Corresponding_Spec
8167 (N : Node_Id) return Node_Id; -- Node5
8168
8169 function Corresponding_Stub
8170 (N : Node_Id) return Node_Id; -- Node3
8171
8172 function Dcheck_Function
8173 (N : Node_Id) return Entity_Id; -- Node5
8174
8175 function Debug_Statement
8176 (N : Node_Id) return Node_Id; -- Node3
8177
8178 function Declarations
8179 (N : Node_Id) return List_Id; -- List2
8180
8181 function Default_Expression
8182 (N : Node_Id) return Node_Id; -- Node5
8183
8184 function Default_Storage_Pool
8185 (N : Node_Id) return Node_Id; -- Node3
8186
8187 function Default_Name
8188 (N : Node_Id) return Node_Id; -- Node2
8189
8190 function Defining_Identifier
8191 (N : Node_Id) return Entity_Id; -- Node1
8192
8193 function Defining_Unit_Name
8194 (N : Node_Id) return Node_Id; -- Node1
8195
8196 function Delay_Alternative
8197 (N : Node_Id) return Node_Id; -- Node4
8198
8199 function Delay_Statement
8200 (N : Node_Id) return Node_Id; -- Node2
8201
8202 function Delta_Expression
8203 (N : Node_Id) return Node_Id; -- Node3
8204
8205 function Digits_Expression
8206 (N : Node_Id) return Node_Id; -- Node2
8207
8208 function Discr_Check_Funcs_Built
8209 (N : Node_Id) return Boolean; -- Flag11
8210
8211 function Discrete_Choices
8212 (N : Node_Id) return List_Id; -- List4
8213
8214 function Discrete_Range
8215 (N : Node_Id) return Node_Id; -- Node4
8216
8217 function Discrete_Subtype_Definition
8218 (N : Node_Id) return Node_Id; -- Node4
8219
8220 function Discrete_Subtype_Definitions
8221 (N : Node_Id) return List_Id; -- List2
8222
8223 function Discriminant_Specifications
8224 (N : Node_Id) return List_Id; -- List4
8225
8226 function Discriminant_Type
8227 (N : Node_Id) return Node_Id; -- Node5
8228
8229 function Do_Accessibility_Check
8230 (N : Node_Id) return Boolean; -- Flag13
8231
8232 function Do_Discriminant_Check
8233 (N : Node_Id) return Boolean; -- Flag13
8234
8235 function Do_Division_Check
8236 (N : Node_Id) return Boolean; -- Flag13
8237
8238 function Do_Length_Check
8239 (N : Node_Id) return Boolean; -- Flag4
8240
8241 function Do_Overflow_Check
8242 (N : Node_Id) return Boolean; -- Flag17
8243
8244 function Do_Range_Check
8245 (N : Node_Id) return Boolean; -- Flag9
8246
8247 function Do_Storage_Check
8248 (N : Node_Id) return Boolean; -- Flag17
8249
8250 function Do_Tag_Check
8251 (N : Node_Id) return Boolean; -- Flag13
8252
8253 function Elaborate_All_Desirable
8254 (N : Node_Id) return Boolean; -- Flag9
8255
8256 function Elaborate_All_Present
8257 (N : Node_Id) return Boolean; -- Flag14
8258
8259 function Elaborate_Desirable
8260 (N : Node_Id) return Boolean; -- Flag11
8261
8262 function Elaborate_Present
8263 (N : Node_Id) return Boolean; -- Flag4
8264
8265 function Elaboration_Boolean
8266 (N : Node_Id) return Node_Id; -- Node2
8267
8268 function Else_Actions
8269 (N : Node_Id) return List_Id; -- List3
8270
8271 function Else_Statements
8272 (N : Node_Id) return List_Id; -- List4
8273
8274 function Elsif_Parts
8275 (N : Node_Id) return List_Id; -- List3
8276
8277 function Enclosing_Variant
8278 (N : Node_Id) return Node_Id; -- Node2
8279
8280 function End_Label
8281 (N : Node_Id) return Node_Id; -- Node4
8282
8283 function End_Span
8284 (N : Node_Id) return Uint; -- Uint5
8285
8286 function Entity
8287 (N : Node_Id) return Node_Id; -- Node4
8288
8289 function Entity_Or_Associated_Node
8290 (N : Node_Id) return Node_Id; -- Node4
8291
8292 function Entry_Body_Formal_Part
8293 (N : Node_Id) return Node_Id; -- Node5
8294
8295 function Entry_Call_Alternative
8296 (N : Node_Id) return Node_Id; -- Node1
8297
8298 function Entry_Call_Statement
8299 (N : Node_Id) return Node_Id; -- Node1
8300
8301 function Entry_Direct_Name
8302 (N : Node_Id) return Node_Id; -- Node1
8303
8304 function Entry_Index
8305 (N : Node_Id) return Node_Id; -- Node5
8306
8307 function Entry_Index_Specification
8308 (N : Node_Id) return Node_Id; -- Node4
8309
8310 function Etype
8311 (N : Node_Id) return Node_Id; -- Node5
8312
8313 function Exception_Choices
8314 (N : Node_Id) return List_Id; -- List4
8315
8316 function Exception_Handlers
8317 (N : Node_Id) return List_Id; -- List5
8318
8319 function Exception_Junk
8320 (N : Node_Id) return Boolean; -- Flag8
8321
8322 function Exception_Label
8323 (N : Node_Id) return Node_Id; -- Node5
8324
8325 function Explicit_Actual_Parameter
8326 (N : Node_Id) return Node_Id; -- Node3
8327
8328 function Expansion_Delayed
8329 (N : Node_Id) return Boolean; -- Flag11
8330
8331 function Explicit_Generic_Actual_Parameter
8332 (N : Node_Id) return Node_Id; -- Node1
8333
8334 function Expression
8335 (N : Node_Id) return Node_Id; -- Node3
8336
8337 function Expressions
8338 (N : Node_Id) return List_Id; -- List1
8339
8340 function First_Bit
8341 (N : Node_Id) return Node_Id; -- Node3
8342
8343 function First_Inlined_Subprogram
8344 (N : Node_Id) return Entity_Id; -- Node3
8345
8346 function First_Name
8347 (N : Node_Id) return Boolean; -- Flag5
8348
8349 function First_Named_Actual
8350 (N : Node_Id) return Node_Id; -- Node4
8351
8352 function First_Real_Statement
8353 (N : Node_Id) return Node_Id; -- Node2
8354
8355 function First_Subtype_Link
8356 (N : Node_Id) return Entity_Id; -- Node5
8357
8358 function Float_Truncate
8359 (N : Node_Id) return Boolean; -- Flag11
8360
8361 function Formal_Type_Definition
8362 (N : Node_Id) return Node_Id; -- Node3
8363
8364 function Forwards_OK
8365 (N : Node_Id) return Boolean; -- Flag5
8366
8367 function From_Aspect_Specification
8368 (N : Node_Id) return Boolean; -- Flag13
8369
8370 function From_At_End
8371 (N : Node_Id) return Boolean; -- Flag4
8372
8373 function From_At_Mod
8374 (N : Node_Id) return Boolean; -- Flag4
8375
8376 function From_Default
8377 (N : Node_Id) return Boolean; -- Flag6
8378
8379 function Generic_Associations
8380 (N : Node_Id) return List_Id; -- List3
8381
8382 function Generic_Formal_Declarations
8383 (N : Node_Id) return List_Id; -- List2
8384
8385 function Generic_Parent
8386 (N : Node_Id) return Node_Id; -- Node5
8387
8388 function Generic_Parent_Type
8389 (N : Node_Id) return Node_Id; -- Node4
8390
8391 function Handled_Statement_Sequence
8392 (N : Node_Id) return Node_Id; -- Node4
8393
8394 function Handler_List_Entry
8395 (N : Node_Id) return Node_Id; -- Node2
8396
8397 function Has_Created_Identifier
8398 (N : Node_Id) return Boolean; -- Flag15
8399
8400 function Has_Dynamic_Length_Check
8401 (N : Node_Id) return Boolean; -- Flag10
8402
8403 function Has_Dynamic_Range_Check
8404 (N : Node_Id) return Boolean; -- Flag12
8405
8406 function Has_Init_Expression
8407 (N : Node_Id) return Boolean; -- Flag14
8408
8409 function Has_Local_Raise
8410 (N : Node_Id) return Boolean; -- Flag8
8411
8412 function Has_No_Elaboration_Code
8413 (N : Node_Id) return Boolean; -- Flag17
8414
8415 function Has_Pragma_CPU
8416 (N : Node_Id) return Boolean; -- Flag14
8417
8418 function Has_Pragma_Priority
8419 (N : Node_Id) return Boolean; -- Flag6
8420
8421 function Has_Pragma_Suppress_All
8422 (N : Node_Id) return Boolean; -- Flag14
8423
8424 function Has_Private_View
8425 (N : Node_Id) return Boolean; -- Flag11
8426
8427 function Has_Relative_Deadline_Pragma
8428 (N : Node_Id) return Boolean; -- Flag9
8429
8430 function Has_Self_Reference
8431 (N : Node_Id) return Boolean; -- Flag13
8432
8433 function Has_Storage_Size_Pragma
8434 (N : Node_Id) return Boolean; -- Flag5
8435
8436 function Has_Task_Info_Pragma
8437 (N : Node_Id) return Boolean; -- Flag7
8438
8439 function Has_Task_Name_Pragma
8440 (N : Node_Id) return Boolean; -- Flag8
8441
8442 function Has_Wide_Character
8443 (N : Node_Id) return Boolean; -- Flag11
8444
8445 function Has_Wide_Wide_Character
8446 (N : Node_Id) return Boolean; -- Flag13
8447
8448 function Hidden_By_Use_Clause
8449 (N : Node_Id) return Elist_Id; -- Elist4
8450
8451 function High_Bound
8452 (N : Node_Id) return Node_Id; -- Node2
8453
8454 function Identifier
8455 (N : Node_Id) return Node_Id; -- Node1
8456
8457 function Interface_List
8458 (N : Node_Id) return List_Id; -- List2
8459
8460 function Interface_Present
8461 (N : Node_Id) return Boolean; -- Flag16
8462
8463 function Implicit_With
8464 (N : Node_Id) return Boolean; -- Flag16
8465
8466 function Import_Interface_Present
8467 (N : Node_Id) return Boolean; -- Flag16
8468
8469 function In_Present
8470 (N : Node_Id) return Boolean; -- Flag15
8471
8472 function Includes_Infinities
8473 (N : Node_Id) return Boolean; -- Flag11
8474
8475 function Inherited_Discriminant
8476 (N : Node_Id) return Boolean; -- Flag13
8477
8478 function Instance_Spec
8479 (N : Node_Id) return Node_Id; -- Node5
8480
8481 function Intval
8482 (N : Node_Id) return Uint; -- Uint3
8483
8484 function Is_Accessibility_Actual
8485 (N : Node_Id) return Boolean; -- Flag13
8486
8487 function Is_Asynchronous_Call_Block
8488 (N : Node_Id) return Boolean; -- Flag7
8489
8490 function Is_Component_Left_Opnd
8491 (N : Node_Id) return Boolean; -- Flag13
8492
8493 function Is_Component_Right_Opnd
8494 (N : Node_Id) return Boolean; -- Flag14
8495
8496 function Is_Controlling_Actual
8497 (N : Node_Id) return Boolean; -- Flag16
8498
8499 function Is_Delayed_Aspect
8500 (N : Node_Id) return Boolean; -- Flag14
8501
8502 function Is_Dynamic_Coextension
8503 (N : Node_Id) return Boolean; -- Flag18
8504
8505 function Is_Elsif
8506 (N : Node_Id) return Boolean; -- Flag13
8507
8508 function Is_Entry_Barrier_Function
8509 (N : Node_Id) return Boolean; -- Flag8
8510
8511 function Is_Expanded_Build_In_Place_Call
8512 (N : Node_Id) return Boolean; -- Flag11
8513
8514 function Is_Folded_In_Parser
8515 (N : Node_Id) return Boolean; -- Flag4
8516
8517 function Is_In_Discriminant_Check
8518 (N : Node_Id) return Boolean; -- Flag11
8519
8520 function Is_Machine_Number
8521 (N : Node_Id) return Boolean; -- Flag11
8522
8523 function Is_Null_Loop
8524 (N : Node_Id) return Boolean; -- Flag16
8525
8526 function Is_Overloaded
8527 (N : Node_Id) return Boolean; -- Flag5
8528
8529 function Is_Power_Of_2_For_Shift
8530 (N : Node_Id) return Boolean; -- Flag13
8531
8532 function Is_Protected_Subprogram_Body
8533 (N : Node_Id) return Boolean; -- Flag7
8534
8535 function Is_Static_Coextension
8536 (N : Node_Id) return Boolean; -- Flag14
8537
8538 function Is_Static_Expression
8539 (N : Node_Id) return Boolean; -- Flag6
8540
8541 function Is_Subprogram_Descriptor
8542 (N : Node_Id) return Boolean; -- Flag16
8543
8544 function Is_Task_Allocation_Block
8545 (N : Node_Id) return Boolean; -- Flag6
8546
8547 function Is_Task_Master
8548 (N : Node_Id) return Boolean; -- Flag5
8549
8550 function Iteration_Scheme
8551 (N : Node_Id) return Node_Id; -- Node2
8552
8553 function Iterator_Specification
8554 (N : Node_Id) return Node_Id; -- Node2
8555
8556 function Itype
8557 (N : Node_Id) return Entity_Id; -- Node1
8558
8559 function Kill_Range_Check
8560 (N : Node_Id) return Boolean; -- Flag11
8561
8562 function Label_Construct
8563 (N : Node_Id) return Node_Id; -- Node2
8564
8565 function Left_Opnd
8566 (N : Node_Id) return Node_Id; -- Node2
8567
8568 function Last_Bit
8569 (N : Node_Id) return Node_Id; -- Node4
8570
8571 function Last_Name
8572 (N : Node_Id) return Boolean; -- Flag6
8573
8574 function Library_Unit
8575 (N : Node_Id) return Node_Id; -- Node4
8576
8577 function Limited_View_Installed
8578 (N : Node_Id) return Boolean; -- Flag18
8579
8580 function Limited_Present
8581 (N : Node_Id) return Boolean; -- Flag17
8582
8583 function Literals
8584 (N : Node_Id) return List_Id; -- List1
8585
8586 function Local_Raise_Not_OK
8587 (N : Node_Id) return Boolean; -- Flag7
8588
8589 function Local_Raise_Statements
8590 (N : Node_Id) return Elist_Id; -- Elist1
8591
8592 function Loop_Actions
8593 (N : Node_Id) return List_Id; -- List2
8594
8595 function Loop_Parameter_Specification
8596 (N : Node_Id) return Node_Id; -- Node4
8597
8598 function Low_Bound
8599 (N : Node_Id) return Node_Id; -- Node1
8600
8601 function Mod_Clause
8602 (N : Node_Id) return Node_Id; -- Node2
8603
8604 function More_Ids
8605 (N : Node_Id) return Boolean; -- Flag5
8606
8607 function Must_Be_Byte_Aligned
8608 (N : Node_Id) return Boolean; -- Flag14
8609
8610 function Must_Not_Freeze
8611 (N : Node_Id) return Boolean; -- Flag8
8612
8613 function Must_Not_Override
8614 (N : Node_Id) return Boolean; -- Flag15
8615
8616 function Must_Override
8617 (N : Node_Id) return Boolean; -- Flag14
8618
8619 function Name
8620 (N : Node_Id) return Node_Id; -- Node2
8621
8622 function Names
8623 (N : Node_Id) return List_Id; -- List2
8624
8625 function Next_Entity
8626 (N : Node_Id) return Node_Id; -- Node2
8627
8628 function Next_Exit_Statement
8629 (N : Node_Id) return Node_Id; -- Node3
8630
8631 function Next_Implicit_With
8632 (N : Node_Id) return Node_Id; -- Node3
8633
8634 function Next_Named_Actual
8635 (N : Node_Id) return Node_Id; -- Node4
8636
8637 function Next_Pragma
8638 (N : Node_Id) return Node_Id; -- Node1
8639
8640 function Next_Rep_Item
8641 (N : Node_Id) return Node_Id; -- Node5
8642
8643 function Next_Use_Clause
8644 (N : Node_Id) return Node_Id; -- Node3
8645
8646 function No_Ctrl_Actions
8647 (N : Node_Id) return Boolean; -- Flag7
8648
8649 function No_Elaboration_Check
8650 (N : Node_Id) return Boolean; -- Flag14
8651
8652 function No_Entities_Ref_In_Spec
8653 (N : Node_Id) return Boolean; -- Flag8
8654
8655 function No_Initialization
8656 (N : Node_Id) return Boolean; -- Flag13
8657
8658 function No_Truncation
8659 (N : Node_Id) return Boolean; -- Flag17
8660
8661 function Null_Present
8662 (N : Node_Id) return Boolean; -- Flag13
8663
8664 function Null_Exclusion_Present
8665 (N : Node_Id) return Boolean; -- Flag11
8666
8667 function Null_Exclusion_In_Return_Present
8668 (N : Node_Id) return Boolean; -- Flag14
8669
8670 function Null_Record_Present
8671 (N : Node_Id) return Boolean; -- Flag17
8672
8673 function Object_Definition
8674 (N : Node_Id) return Node_Id; -- Node4
8675
8676 function Of_Present
8677 (N : Node_Id) return Boolean; -- Flag16
8678
8679 function Original_Discriminant
8680 (N : Node_Id) return Node_Id; -- Node2
8681
8682 function Original_Entity
8683 (N : Node_Id) return Entity_Id; -- Node2
8684
8685 function Others_Discrete_Choices
8686 (N : Node_Id) return List_Id; -- List1
8687
8688 function Out_Present
8689 (N : Node_Id) return Boolean; -- Flag17
8690
8691 function Parameter_Associations
8692 (N : Node_Id) return List_Id; -- List3
8693
8694 function Parameter_List_Truncated
8695 (N : Node_Id) return Boolean; -- Flag17
8696
8697 function Parameter_Specifications
8698 (N : Node_Id) return List_Id; -- List3
8699
8700 function Parameter_Type
8701 (N : Node_Id) return Node_Id; -- Node2
8702
8703 function Parent_Spec
8704 (N : Node_Id) return Node_Id; -- Node4
8705
8706 function Position
8707 (N : Node_Id) return Node_Id; -- Node2
8708
8709 function Pragma_Argument_Associations
8710 (N : Node_Id) return List_Id; -- List2
8711
8712 function Pragma_Enabled
8713 (N : Node_Id) return Boolean; -- Flag5
8714
8715 function Pragma_Identifier
8716 (N : Node_Id) return Node_Id; -- Node4
8717
8718 function Pragmas_After
8719 (N : Node_Id) return List_Id; -- List5
8720
8721 function Pragmas_Before
8722 (N : Node_Id) return List_Id; -- List4
8723
8724 function Prefix
8725 (N : Node_Id) return Node_Id; -- Node3
8726
8727 function Present_Expr
8728 (N : Node_Id) return Uint; -- Uint3
8729
8730 function Prev_Ids
8731 (N : Node_Id) return Boolean; -- Flag6
8732
8733 function Print_In_Hex
8734 (N : Node_Id) return Boolean; -- Flag13
8735
8736 function Private_Declarations
8737 (N : Node_Id) return List_Id; -- List3
8738
8739 function Private_Present
8740 (N : Node_Id) return Boolean; -- Flag15
8741
8742 function Procedure_To_Call
8743 (N : Node_Id) return Node_Id; -- Node2
8744
8745 function Proper_Body
8746 (N : Node_Id) return Node_Id; -- Node1
8747
8748 function Protected_Definition
8749 (N : Node_Id) return Node_Id; -- Node3
8750
8751 function Protected_Present
8752 (N : Node_Id) return Boolean; -- Flag6
8753
8754 function Raises_Constraint_Error
8755 (N : Node_Id) return Boolean; -- Flag7
8756
8757 function Range_Constraint
8758 (N : Node_Id) return Node_Id; -- Node4
8759
8760 function Range_Expression
8761 (N : Node_Id) return Node_Id; -- Node4
8762
8763 function Real_Range_Specification
8764 (N : Node_Id) return Node_Id; -- Node4
8765
8766 function Realval
8767 (N : Node_Id) return Ureal; -- Ureal3
8768
8769 function Reason
8770 (N : Node_Id) return Uint; -- Uint3
8771
8772 function Record_Extension_Part
8773 (N : Node_Id) return Node_Id; -- Node3
8774
8775 function Redundant_Use
8776 (N : Node_Id) return Boolean; -- Flag13
8777
8778 function Renaming_Exception
8779 (N : Node_Id) return Node_Id; -- Node2
8780
8781 function Result_Definition
8782 (N : Node_Id) return Node_Id; -- Node4
8783
8784 function Return_Object_Declarations
8785 (N : Node_Id) return List_Id; -- List3
8786
8787 function Return_Statement_Entity
8788 (N : Node_Id) return Node_Id; -- Node5
8789
8790 function Reverse_Present
8791 (N : Node_Id) return Boolean; -- Flag15
8792
8793 function Right_Opnd
8794 (N : Node_Id) return Node_Id; -- Node3
8795
8796 function Rounded_Result
8797 (N : Node_Id) return Boolean; -- Flag18
8798
8799 function SCIL_Controlling_Tag
8800 (N : Node_Id) return Node_Id; -- Node5
8801
8802 function SCIL_Entity
8803 (N : Node_Id) return Node_Id; -- Node4
8804
8805 function SCIL_Tag_Value
8806 (N : Node_Id) return Node_Id; -- Node5
8807
8808 function SCIL_Target_Prim
8809 (N : Node_Id) return Node_Id; -- Node2
8810
8811 function Scope
8812 (N : Node_Id) return Node_Id; -- Node3
8813
8814 function Select_Alternatives
8815 (N : Node_Id) return List_Id; -- List1
8816
8817 function Selector_Name
8818 (N : Node_Id) return Node_Id; -- Node2
8819
8820 function Selector_Names
8821 (N : Node_Id) return List_Id; -- List1
8822
8823 function Shift_Count_OK
8824 (N : Node_Id) return Boolean; -- Flag4
8825
8826 function Source_Type
8827 (N : Node_Id) return Entity_Id; -- Node1
8828
8829 function Specification
8830 (N : Node_Id) return Node_Id; -- Node1
8831
8832 function Split_PPC
8833 (N : Node_Id) return Boolean; -- Flag17
8834
8835 function Statements
8836 (N : Node_Id) return List_Id; -- List3
8837
8838 function Static_Processing_OK
8839 (N : Node_Id) return Boolean; -- Flag4
8840
8841 function Storage_Pool
8842 (N : Node_Id) return Node_Id; -- Node1
8843
8844 function Strval
8845 (N : Node_Id) return String_Id; -- Str3
8846
8847 function Subtype_Indication
8848 (N : Node_Id) return Node_Id; -- Node5
8849
8850 function Subtype_Mark
8851 (N : Node_Id) return Node_Id; -- Node4
8852
8853 function Subtype_Marks
8854 (N : Node_Id) return List_Id; -- List2
8855
8856 function Suppress_Assignment_Checks
8857 (N : Node_Id) return Boolean; -- Flag18
8858
8859 function Suppress_Loop_Warnings
8860 (N : Node_Id) return Boolean; -- Flag17
8861
8862 function Synchronized_Present
8863 (N : Node_Id) return Boolean; -- Flag7
8864
8865 function Tagged_Present
8866 (N : Node_Id) return Boolean; -- Flag15
8867
8868 function Target_Type
8869 (N : Node_Id) return Entity_Id; -- Node2
8870
8871 function Task_Definition
8872 (N : Node_Id) return Node_Id; -- Node3
8873
8874 function Task_Present
8875 (N : Node_Id) return Boolean; -- Flag5
8876
8877 function Then_Actions
8878 (N : Node_Id) return List_Id; -- List2
8879
8880 function Then_Statements
8881 (N : Node_Id) return List_Id; -- List2
8882
8883 function Treat_Fixed_As_Integer
8884 (N : Node_Id) return Boolean; -- Flag14
8885
8886 function Triggering_Alternative
8887 (N : Node_Id) return Node_Id; -- Node1
8888
8889 function Triggering_Statement
8890 (N : Node_Id) return Node_Id; -- Node1
8891
8892 function TSS_Elist
8893 (N : Node_Id) return Elist_Id; -- Elist3
8894
8895 function Type_Definition
8896 (N : Node_Id) return Node_Id; -- Node3
8897
8898 function Unit
8899 (N : Node_Id) return Node_Id; -- Node2
8900
8901 function Unknown_Discriminants_Present
8902 (N : Node_Id) return Boolean; -- Flag13
8903
8904 function Unreferenced_In_Spec
8905 (N : Node_Id) return Boolean; -- Flag7
8906
8907 function Variant_Part
8908 (N : Node_Id) return Node_Id; -- Node4
8909
8910 function Variants
8911 (N : Node_Id) return List_Id; -- List1
8912
8913 function Visible_Declarations
8914 (N : Node_Id) return List_Id; -- List2
8915
8916 function Was_Originally_Stub
8917 (N : Node_Id) return Boolean; -- Flag13
8918
8919 function Withed_Body
8920 (N : Node_Id) return Node_Id; -- Node1
8921
8922 function Zero_Cost_Handling
8923 (N : Node_Id) return Boolean; -- Flag5
8924
8925 -- End functions (note used by xsinfo utility program to end processing)
8926
8927 ----------------------------
8928 -- Node Update Procedures --
8929 ----------------------------
8930
8931 -- These are the corresponding node update routines, which again provide
8932 -- a high level logical access with type checking. In addition to setting
8933 -- the indicated field of the node N to the given Val, in the case of
8934 -- tree pointers (List1-4), the parent pointer of the Val node is set to
8935 -- point back to node N. This automates the setting of the parent pointer.
8936
8937 procedure Set_ABE_Is_Certain
8938 (N : Node_Id; Val : Boolean := True); -- Flag18
8939
8940 procedure Set_Abort_Present
8941 (N : Node_Id; Val : Boolean := True); -- Flag15
8942
8943 procedure Set_Abortable_Part
8944 (N : Node_Id; Val : Node_Id); -- Node2
8945
8946 procedure Set_Abstract_Present
8947 (N : Node_Id; Val : Boolean := True); -- Flag4
8948
8949 procedure Set_Accept_Handler_Records
8950 (N : Node_Id; Val : List_Id); -- List5
8951
8952 procedure Set_Accept_Statement
8953 (N : Node_Id; Val : Node_Id); -- Node2
8954
8955 procedure Set_Access_Definition
8956 (N : Node_Id; Val : Node_Id); -- Node3
8957
8958 procedure Set_Access_To_Subprogram_Definition
8959 (N : Node_Id; Val : Node_Id); -- Node3
8960
8961 procedure Set_Access_Types_To_Process
8962 (N : Node_Id; Val : Elist_Id); -- Elist2
8963
8964 procedure Set_Actions
8965 (N : Node_Id; Val : List_Id); -- List1
8966
8967 procedure Set_Activation_Chain_Entity
8968 (N : Node_Id; Val : Node_Id); -- Node3
8969
8970 procedure Set_Acts_As_Spec
8971 (N : Node_Id; Val : Boolean := True); -- Flag4
8972
8973 procedure Set_Actual_Designated_Subtype
8974 (N : Node_Id; Val : Node_Id); -- Node4
8975
8976 procedure Set_Address_Warning_Posted
8977 (N : Node_Id; Val : Boolean := True); -- Flag18
8978
8979 procedure Set_Aggregate_Bounds
8980 (N : Node_Id; Val : Node_Id); -- Node3
8981
8982 procedure Set_Aliased_Present
8983 (N : Node_Id; Val : Boolean := True); -- Flag4
8984
8985 procedure Set_All_Others
8986 (N : Node_Id; Val : Boolean := True); -- Flag11
8987
8988 procedure Set_All_Present
8989 (N : Node_Id; Val : Boolean := True); -- Flag15
8990
8991 procedure Set_Alternatives
8992 (N : Node_Id; Val : List_Id); -- List4
8993
8994 procedure Set_Ancestor_Part
8995 (N : Node_Id; Val : Node_Id); -- Node3
8996
8997 procedure Set_Array_Aggregate
8998 (N : Node_Id; Val : Node_Id); -- Node3
8999
9000 procedure Set_Aspect_Cancel
9001 (N : Node_Id; Val : Boolean := True); -- Flag11
9002
9003 procedure Set_Aspect_Rep_Item
9004 (N : Node_Id; Val : Node_Id); -- Node2
9005
9006 procedure Set_Assignment_OK
9007 (N : Node_Id; Val : Boolean := True); -- Flag15
9008
9009 procedure Set_Associated_Node
9010 (N : Node_Id; Val : Node_Id); -- Node4
9011
9012 procedure Set_Attribute_Name
9013 (N : Node_Id; Val : Name_Id); -- Name2
9014
9015 procedure Set_At_End_Proc
9016 (N : Node_Id; Val : Node_Id); -- Node1
9017
9018 procedure Set_Aux_Decls_Node
9019 (N : Node_Id; Val : Node_Id); -- Node5
9020
9021 procedure Set_Backwards_OK
9022 (N : Node_Id; Val : Boolean := True); -- Flag6
9023
9024 procedure Set_Bad_Is_Detected
9025 (N : Node_Id; Val : Boolean := True); -- Flag15
9026
9027 procedure Set_Body_Required
9028 (N : Node_Id; Val : Boolean := True); -- Flag13
9029
9030 procedure Set_Body_To_Inline
9031 (N : Node_Id; Val : Node_Id); -- Node3
9032
9033 procedure Set_Box_Present
9034 (N : Node_Id; Val : Boolean := True); -- Flag15
9035
9036 procedure Set_By_Ref
9037 (N : Node_Id; Val : Boolean := True); -- Flag5
9038
9039 procedure Set_Char_Literal_Value
9040 (N : Node_Id; Val : Uint); -- Uint2
9041
9042 procedure Set_Chars
9043 (N : Node_Id; Val : Name_Id); -- Name1
9044
9045 procedure Set_Check_Address_Alignment
9046 (N : Node_Id; Val : Boolean := True); -- Flag11
9047
9048 procedure Set_Choice_Parameter
9049 (N : Node_Id; Val : Node_Id); -- Node2
9050
9051 procedure Set_Choices
9052 (N : Node_Id; Val : List_Id); -- List1
9053
9054 procedure Set_Class_Present
9055 (N : Node_Id; Val : Boolean := True); -- Flag6
9056
9057 procedure Set_Coextensions
9058 (N : Node_Id; Val : Elist_Id); -- Elist4
9059
9060 procedure Set_Comes_From_Extended_Return_Statement
9061 (N : Node_Id; Val : Boolean := True); -- Flag18
9062
9063 procedure Set_Compile_Time_Known_Aggregate
9064 (N : Node_Id; Val : Boolean := True); -- Flag18
9065
9066 procedure Set_Component_Associations
9067 (N : Node_Id; Val : List_Id); -- List2
9068
9069 procedure Set_Component_Clauses
9070 (N : Node_Id; Val : List_Id); -- List3
9071
9072 procedure Set_Component_Definition
9073 (N : Node_Id; Val : Node_Id); -- Node4
9074
9075 procedure Set_Component_Items
9076 (N : Node_Id; Val : List_Id); -- List3
9077
9078 procedure Set_Component_List
9079 (N : Node_Id; Val : Node_Id); -- Node1
9080
9081 procedure Set_Component_Name
9082 (N : Node_Id; Val : Node_Id); -- Node1
9083
9084 procedure Set_Componentwise_Assignment
9085 (N : Node_Id; Val : Boolean := True); -- Flag14
9086
9087 procedure Set_Condition
9088 (N : Node_Id; Val : Node_Id); -- Node1
9089
9090 procedure Set_Condition_Actions
9091 (N : Node_Id; Val : List_Id); -- List3
9092
9093 procedure Set_Config_Pragmas
9094 (N : Node_Id; Val : List_Id); -- List4
9095
9096 procedure Set_Constant_Present
9097 (N : Node_Id; Val : Boolean := True); -- Flag17
9098
9099 procedure Set_Constraint
9100 (N : Node_Id; Val : Node_Id); -- Node3
9101
9102 procedure Set_Constraints
9103 (N : Node_Id; Val : List_Id); -- List1
9104
9105 procedure Set_Context_Installed
9106 (N : Node_Id; Val : Boolean := True); -- Flag13
9107
9108 procedure Set_Context_Items
9109 (N : Node_Id; Val : List_Id); -- List1
9110
9111 procedure Set_Context_Pending
9112 (N : Node_Id; Val : Boolean := True); -- Flag16
9113
9114 procedure Set_Controlling_Argument
9115 (N : Node_Id; Val : Node_Id); -- Node1
9116
9117 procedure Set_Conversion_OK
9118 (N : Node_Id; Val : Boolean := True); -- Flag14
9119
9120 procedure Set_Corresponding_Body
9121 (N : Node_Id; Val : Node_Id); -- Node5
9122
9123 procedure Set_Corresponding_Formal_Spec
9124 (N : Node_Id; Val : Node_Id); -- Node3
9125
9126 procedure Set_Corresponding_Generic_Association
9127 (N : Node_Id; Val : Node_Id); -- Node5
9128
9129 procedure Set_Corresponding_Integer_Value
9130 (N : Node_Id; Val : Uint); -- Uint4
9131
9132 procedure Set_Corresponding_Spec
9133 (N : Node_Id; Val : Node_Id); -- Node5
9134
9135 procedure Set_Corresponding_Stub
9136 (N : Node_Id; Val : Node_Id); -- Node3
9137
9138 procedure Set_Dcheck_Function
9139 (N : Node_Id; Val : Entity_Id); -- Node5
9140
9141 procedure Set_Debug_Statement
9142 (N : Node_Id; Val : Node_Id); -- Node3
9143
9144 procedure Set_Declarations
9145 (N : Node_Id; Val : List_Id); -- List2
9146
9147 procedure Set_Default_Expression
9148 (N : Node_Id; Val : Node_Id); -- Node5
9149
9150 procedure Set_Default_Storage_Pool
9151 (N : Node_Id; Val : Node_Id); -- Node3
9152
9153 procedure Set_Default_Name
9154 (N : Node_Id; Val : Node_Id); -- Node2
9155
9156 procedure Set_Defining_Identifier
9157 (N : Node_Id; Val : Entity_Id); -- Node1
9158
9159 procedure Set_Defining_Unit_Name
9160 (N : Node_Id; Val : Node_Id); -- Node1
9161
9162 procedure Set_Delay_Alternative
9163 (N : Node_Id; Val : Node_Id); -- Node4
9164
9165 procedure Set_Delay_Statement
9166 (N : Node_Id; Val : Node_Id); -- Node2
9167
9168 procedure Set_Delta_Expression
9169 (N : Node_Id; Val : Node_Id); -- Node3
9170
9171 procedure Set_Digits_Expression
9172 (N : Node_Id; Val : Node_Id); -- Node2
9173
9174 procedure Set_Discr_Check_Funcs_Built
9175 (N : Node_Id; Val : Boolean := True); -- Flag11
9176
9177 procedure Set_Discrete_Choices
9178 (N : Node_Id; Val : List_Id); -- List4
9179
9180 procedure Set_Discrete_Range
9181 (N : Node_Id; Val : Node_Id); -- Node4
9182
9183 procedure Set_Discrete_Subtype_Definition
9184 (N : Node_Id; Val : Node_Id); -- Node4
9185
9186 procedure Set_Discrete_Subtype_Definitions
9187 (N : Node_Id; Val : List_Id); -- List2
9188
9189 procedure Set_Discriminant_Specifications
9190 (N : Node_Id; Val : List_Id); -- List4
9191
9192 procedure Set_Discriminant_Type
9193 (N : Node_Id; Val : Node_Id); -- Node5
9194
9195 procedure Set_Do_Accessibility_Check
9196 (N : Node_Id; Val : Boolean := True); -- Flag13
9197
9198 procedure Set_Do_Discriminant_Check
9199 (N : Node_Id; Val : Boolean := True); -- Flag13
9200
9201 procedure Set_Do_Division_Check
9202 (N : Node_Id; Val : Boolean := True); -- Flag13
9203
9204 procedure Set_Do_Length_Check
9205 (N : Node_Id; Val : Boolean := True); -- Flag4
9206
9207 procedure Set_Do_Overflow_Check
9208 (N : Node_Id; Val : Boolean := True); -- Flag17
9209
9210 procedure Set_Do_Range_Check
9211 (N : Node_Id; Val : Boolean := True); -- Flag9
9212
9213 procedure Set_Do_Storage_Check
9214 (N : Node_Id; Val : Boolean := True); -- Flag17
9215
9216 procedure Set_Do_Tag_Check
9217 (N : Node_Id; Val : Boolean := True); -- Flag13
9218
9219 procedure Set_Elaborate_All_Desirable
9220 (N : Node_Id; Val : Boolean := True); -- Flag9
9221
9222 procedure Set_Elaborate_All_Present
9223 (N : Node_Id; Val : Boolean := True); -- Flag14
9224
9225 procedure Set_Elaborate_Desirable
9226 (N : Node_Id; Val : Boolean := True); -- Flag11
9227
9228 procedure Set_Elaborate_Present
9229 (N : Node_Id; Val : Boolean := True); -- Flag4
9230
9231 procedure Set_Elaboration_Boolean
9232 (N : Node_Id; Val : Node_Id); -- Node2
9233
9234 procedure Set_Else_Actions
9235 (N : Node_Id; Val : List_Id); -- List3
9236
9237 procedure Set_Else_Statements
9238 (N : Node_Id; Val : List_Id); -- List4
9239
9240 procedure Set_Elsif_Parts
9241 (N : Node_Id; Val : List_Id); -- List3
9242
9243 procedure Set_Enclosing_Variant
9244 (N : Node_Id; Val : Node_Id); -- Node2
9245
9246 procedure Set_End_Label
9247 (N : Node_Id; Val : Node_Id); -- Node4
9248
9249 procedure Set_End_Span
9250 (N : Node_Id; Val : Uint); -- Uint5
9251
9252 procedure Set_Entity
9253 (N : Node_Id; Val : Node_Id); -- Node4
9254
9255 procedure Set_Entry_Body_Formal_Part
9256 (N : Node_Id; Val : Node_Id); -- Node5
9257
9258 procedure Set_Entry_Call_Alternative
9259 (N : Node_Id; Val : Node_Id); -- Node1
9260
9261 procedure Set_Entry_Call_Statement
9262 (N : Node_Id; Val : Node_Id); -- Node1
9263
9264 procedure Set_Entry_Direct_Name
9265 (N : Node_Id; Val : Node_Id); -- Node1
9266
9267 procedure Set_Entry_Index
9268 (N : Node_Id; Val : Node_Id); -- Node5
9269
9270 procedure Set_Entry_Index_Specification
9271 (N : Node_Id; Val : Node_Id); -- Node4
9272
9273 procedure Set_Etype
9274 (N : Node_Id; Val : Node_Id); -- Node5
9275
9276 procedure Set_Exception_Choices
9277 (N : Node_Id; Val : List_Id); -- List4
9278
9279 procedure Set_Exception_Handlers
9280 (N : Node_Id; Val : List_Id); -- List5
9281
9282 procedure Set_Exception_Junk
9283 (N : Node_Id; Val : Boolean := True); -- Flag8
9284
9285 procedure Set_Exception_Label
9286 (N : Node_Id; Val : Node_Id); -- Node5
9287
9288 procedure Set_Expansion_Delayed
9289 (N : Node_Id; Val : Boolean := True); -- Flag11
9290
9291 procedure Set_Explicit_Actual_Parameter
9292 (N : Node_Id; Val : Node_Id); -- Node3
9293
9294 procedure Set_Explicit_Generic_Actual_Parameter
9295 (N : Node_Id; Val : Node_Id); -- Node1
9296
9297 procedure Set_Expression
9298 (N : Node_Id; Val : Node_Id); -- Node3
9299
9300 procedure Set_Expressions
9301 (N : Node_Id; Val : List_Id); -- List1
9302
9303 procedure Set_First_Bit
9304 (N : Node_Id; Val : Node_Id); -- Node3
9305
9306 procedure Set_First_Inlined_Subprogram
9307 (N : Node_Id; Val : Entity_Id); -- Node3
9308
9309 procedure Set_First_Name
9310 (N : Node_Id; Val : Boolean := True); -- Flag5
9311
9312 procedure Set_First_Named_Actual
9313 (N : Node_Id; Val : Node_Id); -- Node4
9314
9315 procedure Set_First_Real_Statement
9316 (N : Node_Id; Val : Node_Id); -- Node2
9317
9318 procedure Set_First_Subtype_Link
9319 (N : Node_Id; Val : Entity_Id); -- Node5
9320
9321 procedure Set_Float_Truncate
9322 (N : Node_Id; Val : Boolean := True); -- Flag11
9323
9324 procedure Set_Formal_Type_Definition
9325 (N : Node_Id; Val : Node_Id); -- Node3
9326
9327 procedure Set_Forwards_OK
9328 (N : Node_Id; Val : Boolean := True); -- Flag5
9329
9330 procedure Set_From_At_Mod
9331 (N : Node_Id; Val : Boolean := True); -- Flag4
9332
9333 procedure Set_From_Aspect_Specification
9334 (N : Node_Id; Val : Boolean := True); -- Flag13
9335
9336 procedure Set_From_At_End
9337 (N : Node_Id; Val : Boolean := True); -- Flag4
9338
9339 procedure Set_From_Default
9340 (N : Node_Id; Val : Boolean := True); -- Flag6
9341
9342 procedure Set_Generic_Associations
9343 (N : Node_Id; Val : List_Id); -- List3
9344
9345 procedure Set_Generic_Formal_Declarations
9346 (N : Node_Id; Val : List_Id); -- List2
9347
9348 procedure Set_Generic_Parent
9349 (N : Node_Id; Val : Node_Id); -- Node5
9350
9351 procedure Set_Generic_Parent_Type
9352 (N : Node_Id; Val : Node_Id); -- Node4
9353
9354 procedure Set_Handled_Statement_Sequence
9355 (N : Node_Id; Val : Node_Id); -- Node4
9356
9357 procedure Set_Handler_List_Entry
9358 (N : Node_Id; Val : Node_Id); -- Node2
9359
9360 procedure Set_Has_Created_Identifier
9361 (N : Node_Id; Val : Boolean := True); -- Flag15
9362
9363 procedure Set_Has_Dynamic_Length_Check
9364 (N : Node_Id; Val : Boolean := True); -- Flag10
9365
9366 procedure Set_Has_Dynamic_Range_Check
9367 (N : Node_Id; Val : Boolean := True); -- Flag12
9368
9369 procedure Set_Has_Init_Expression
9370 (N : Node_Id; Val : Boolean := True); -- Flag14
9371
9372 procedure Set_Has_Local_Raise
9373 (N : Node_Id; Val : Boolean := True); -- Flag8
9374
9375 procedure Set_Has_No_Elaboration_Code
9376 (N : Node_Id; Val : Boolean := True); -- Flag17
9377
9378 procedure Set_Has_Pragma_CPU
9379 (N : Node_Id; Val : Boolean := True); -- Flag14
9380
9381 procedure Set_Has_Pragma_Priority
9382 (N : Node_Id; Val : Boolean := True); -- Flag6
9383
9384 procedure Set_Has_Pragma_Suppress_All
9385 (N : Node_Id; Val : Boolean := True); -- Flag14
9386
9387 procedure Set_Has_Private_View
9388 (N : Node_Id; Val : Boolean := True); -- Flag11
9389
9390 procedure Set_Has_Relative_Deadline_Pragma
9391 (N : Node_Id; Val : Boolean := True); -- Flag9
9392
9393 procedure Set_Has_Self_Reference
9394 (N : Node_Id; Val : Boolean := True); -- Flag13
9395
9396 procedure Set_Has_Storage_Size_Pragma
9397 (N : Node_Id; Val : Boolean := True); -- Flag5
9398
9399 procedure Set_Has_Task_Info_Pragma
9400 (N : Node_Id; Val : Boolean := True); -- Flag7
9401
9402 procedure Set_Has_Task_Name_Pragma
9403 (N : Node_Id; Val : Boolean := True); -- Flag8
9404
9405 procedure Set_Has_Wide_Character
9406 (N : Node_Id; Val : Boolean := True); -- Flag11
9407
9408 procedure Set_Has_Wide_Wide_Character
9409 (N : Node_Id; Val : Boolean := True); -- Flag13
9410
9411 procedure Set_Hidden_By_Use_Clause
9412 (N : Node_Id; Val : Elist_Id); -- Elist4
9413
9414 procedure Set_High_Bound
9415 (N : Node_Id; Val : Node_Id); -- Node2
9416
9417 procedure Set_Identifier
9418 (N : Node_Id; Val : Node_Id); -- Node1
9419
9420 procedure Set_Interface_List
9421 (N : Node_Id; Val : List_Id); -- List2
9422
9423 procedure Set_Interface_Present
9424 (N : Node_Id; Val : Boolean := True); -- Flag16
9425
9426 procedure Set_Implicit_With
9427 (N : Node_Id; Val : Boolean := True); -- Flag16
9428
9429 procedure Set_Import_Interface_Present
9430 (N : Node_Id; Val : Boolean := True); -- Flag16
9431
9432 procedure Set_In_Present
9433 (N : Node_Id; Val : Boolean := True); -- Flag15
9434
9435 procedure Set_Includes_Infinities
9436 (N : Node_Id; Val : Boolean := True); -- Flag11
9437
9438 procedure Set_Inherited_Discriminant
9439 (N : Node_Id; Val : Boolean := True); -- Flag13
9440
9441 procedure Set_Instance_Spec
9442 (N : Node_Id; Val : Node_Id); -- Node5
9443
9444 procedure Set_Intval
9445 (N : Node_Id; Val : Uint); -- Uint3
9446
9447 procedure Set_Is_Accessibility_Actual
9448 (N : Node_Id; Val : Boolean := True); -- Flag13
9449
9450 procedure Set_Is_Asynchronous_Call_Block
9451 (N : Node_Id; Val : Boolean := True); -- Flag7
9452
9453 procedure Set_Is_Component_Left_Opnd
9454 (N : Node_Id; Val : Boolean := True); -- Flag13
9455
9456 procedure Set_Is_Component_Right_Opnd
9457 (N : Node_Id; Val : Boolean := True); -- Flag14
9458
9459 procedure Set_Is_Controlling_Actual
9460 (N : Node_Id; Val : Boolean := True); -- Flag16
9461
9462 procedure Set_Is_Delayed_Aspect
9463 (N : Node_Id; Val : Boolean := True); -- Flag14
9464
9465 procedure Set_Is_Dynamic_Coextension
9466 (N : Node_Id; Val : Boolean := True); -- Flag18
9467
9468 procedure Set_Is_Elsif
9469 (N : Node_Id; Val : Boolean := True); -- Flag13
9470
9471 procedure Set_Is_Entry_Barrier_Function
9472 (N : Node_Id; Val : Boolean := True); -- Flag8
9473
9474 procedure Set_Is_Expanded_Build_In_Place_Call
9475 (N : Node_Id; Val : Boolean := True); -- Flag11
9476
9477 procedure Set_Is_Folded_In_Parser
9478 (N : Node_Id; Val : Boolean := True); -- Flag4
9479
9480 procedure Set_Is_In_Discriminant_Check
9481 (N : Node_Id; Val : Boolean := True); -- Flag11
9482
9483 procedure Set_Is_Machine_Number
9484 (N : Node_Id; Val : Boolean := True); -- Flag11
9485
9486 procedure Set_Is_Null_Loop
9487 (N : Node_Id; Val : Boolean := True); -- Flag16
9488
9489 procedure Set_Is_Overloaded
9490 (N : Node_Id; Val : Boolean := True); -- Flag5
9491
9492 procedure Set_Is_Power_Of_2_For_Shift
9493 (N : Node_Id; Val : Boolean := True); -- Flag13
9494
9495 procedure Set_Is_Protected_Subprogram_Body
9496 (N : Node_Id; Val : Boolean := True); -- Flag7
9497
9498 procedure Set_Is_Static_Coextension
9499 (N : Node_Id; Val : Boolean := True); -- Flag14
9500
9501 procedure Set_Is_Static_Expression
9502 (N : Node_Id; Val : Boolean := True); -- Flag6
9503
9504 procedure Set_Is_Subprogram_Descriptor
9505 (N : Node_Id; Val : Boolean := True); -- Flag16
9506
9507 procedure Set_Is_Task_Allocation_Block
9508 (N : Node_Id; Val : Boolean := True); -- Flag6
9509
9510 procedure Set_Is_Task_Master
9511 (N : Node_Id; Val : Boolean := True); -- Flag5
9512
9513 procedure Set_Iteration_Scheme
9514 (N : Node_Id; Val : Node_Id); -- Node2
9515
9516 procedure Set_Iterator_Specification
9517 (N : Node_Id; Val : Node_Id); -- Node2
9518
9519 procedure Set_Itype
9520 (N : Node_Id; Val : Entity_Id); -- Node1
9521
9522 procedure Set_Kill_Range_Check
9523 (N : Node_Id; Val : Boolean := True); -- Flag11
9524
9525 procedure Set_Last_Bit
9526 (N : Node_Id; Val : Node_Id); -- Node4
9527
9528 procedure Set_Last_Name
9529 (N : Node_Id; Val : Boolean := True); -- Flag6
9530
9531 procedure Set_Library_Unit
9532 (N : Node_Id; Val : Node_Id); -- Node4
9533
9534 procedure Set_Label_Construct
9535 (N : Node_Id; Val : Node_Id); -- Node2
9536
9537 procedure Set_Left_Opnd
9538 (N : Node_Id; Val : Node_Id); -- Node2
9539
9540 procedure Set_Limited_View_Installed
9541 (N : Node_Id; Val : Boolean := True); -- Flag18
9542
9543 procedure Set_Limited_Present
9544 (N : Node_Id; Val : Boolean := True); -- Flag17
9545
9546 procedure Set_Literals
9547 (N : Node_Id; Val : List_Id); -- List1
9548
9549 procedure Set_Local_Raise_Not_OK
9550 (N : Node_Id; Val : Boolean := True); -- Flag7
9551
9552 procedure Set_Local_Raise_Statements
9553 (N : Node_Id; Val : Elist_Id); -- Elist1
9554
9555 procedure Set_Loop_Actions
9556 (N : Node_Id; Val : List_Id); -- List2
9557
9558 procedure Set_Loop_Parameter_Specification
9559 (N : Node_Id; Val : Node_Id); -- Node4
9560
9561 procedure Set_Low_Bound
9562 (N : Node_Id; Val : Node_Id); -- Node1
9563
9564 procedure Set_Mod_Clause
9565 (N : Node_Id; Val : Node_Id); -- Node2
9566
9567 procedure Set_More_Ids
9568 (N : Node_Id; Val : Boolean := True); -- Flag5
9569
9570 procedure Set_Must_Be_Byte_Aligned
9571 (N : Node_Id; Val : Boolean := True); -- Flag14
9572
9573 procedure Set_Must_Not_Freeze
9574 (N : Node_Id; Val : Boolean := True); -- Flag8
9575
9576 procedure Set_Must_Not_Override
9577 (N : Node_Id; Val : Boolean := True); -- Flag15
9578
9579 procedure Set_Must_Override
9580 (N : Node_Id; Val : Boolean := True); -- Flag14
9581
9582 procedure Set_Name
9583 (N : Node_Id; Val : Node_Id); -- Node2
9584
9585 procedure Set_Names
9586 (N : Node_Id; Val : List_Id); -- List2
9587
9588 procedure Set_Next_Entity
9589 (N : Node_Id; Val : Node_Id); -- Node2
9590
9591 procedure Set_Next_Exit_Statement
9592 (N : Node_Id; Val : Node_Id); -- Node3
9593
9594 procedure Set_Next_Implicit_With
9595 (N : Node_Id; Val : Node_Id); -- Node3
9596
9597 procedure Set_Next_Named_Actual
9598 (N : Node_Id; Val : Node_Id); -- Node4
9599
9600 procedure Set_Next_Pragma
9601 (N : Node_Id; Val : Node_Id); -- Node1
9602
9603 procedure Set_Next_Rep_Item
9604 (N : Node_Id; Val : Node_Id); -- Node5
9605
9606 procedure Set_Next_Use_Clause
9607 (N : Node_Id; Val : Node_Id); -- Node3
9608
9609 procedure Set_No_Ctrl_Actions
9610 (N : Node_Id; Val : Boolean := True); -- Flag7
9611
9612 procedure Set_No_Elaboration_Check
9613 (N : Node_Id; Val : Boolean := True); -- Flag14
9614
9615 procedure Set_No_Entities_Ref_In_Spec
9616 (N : Node_Id; Val : Boolean := True); -- Flag8
9617
9618 procedure Set_No_Initialization
9619 (N : Node_Id; Val : Boolean := True); -- Flag13
9620
9621 procedure Set_No_Truncation
9622 (N : Node_Id; Val : Boolean := True); -- Flag17
9623
9624 procedure Set_Null_Present
9625 (N : Node_Id; Val : Boolean := True); -- Flag13
9626
9627 procedure Set_Null_Exclusion_Present
9628 (N : Node_Id; Val : Boolean := True); -- Flag11
9629
9630 procedure Set_Null_Exclusion_In_Return_Present
9631 (N : Node_Id; Val : Boolean := True); -- Flag14
9632
9633 procedure Set_Null_Record_Present
9634 (N : Node_Id; Val : Boolean := True); -- Flag17
9635
9636 procedure Set_Object_Definition
9637 (N : Node_Id; Val : Node_Id); -- Node4
9638
9639 procedure Set_Of_Present
9640 (N : Node_Id; Val : Boolean := True); -- Flag16
9641
9642 procedure Set_Original_Discriminant
9643 (N : Node_Id; Val : Node_Id); -- Node2
9644
9645 procedure Set_Original_Entity
9646 (N : Node_Id; Val : Entity_Id); -- Node2
9647
9648 procedure Set_Others_Discrete_Choices
9649 (N : Node_Id; Val : List_Id); -- List1
9650
9651 procedure Set_Out_Present
9652 (N : Node_Id; Val : Boolean := True); -- Flag17
9653
9654 procedure Set_Parameter_Associations
9655 (N : Node_Id; Val : List_Id); -- List3
9656
9657 procedure Set_Parameter_List_Truncated
9658 (N : Node_Id; Val : Boolean := True); -- Flag17
9659
9660 procedure Set_Parameter_Specifications
9661 (N : Node_Id; Val : List_Id); -- List3
9662
9663 procedure Set_Parameter_Type
9664 (N : Node_Id; Val : Node_Id); -- Node2
9665
9666 procedure Set_Parent_Spec
9667 (N : Node_Id; Val : Node_Id); -- Node4
9668
9669 procedure Set_Position
9670 (N : Node_Id; Val : Node_Id); -- Node2
9671
9672 procedure Set_Pragma_Argument_Associations
9673 (N : Node_Id; Val : List_Id); -- List2
9674
9675 procedure Set_Pragma_Enabled
9676 (N : Node_Id; Val : Boolean := True); -- Flag5
9677
9678 procedure Set_Pragma_Identifier
9679 (N : Node_Id; Val : Node_Id); -- Node4
9680
9681 procedure Set_Pragmas_After
9682 (N : Node_Id; Val : List_Id); -- List5
9683
9684 procedure Set_Pragmas_Before
9685 (N : Node_Id; Val : List_Id); -- List4
9686
9687 procedure Set_Prefix
9688 (N : Node_Id; Val : Node_Id); -- Node3
9689
9690 procedure Set_Present_Expr
9691 (N : Node_Id; Val : Uint); -- Uint3
9692
9693 procedure Set_Prev_Ids
9694 (N : Node_Id; Val : Boolean := True); -- Flag6
9695
9696 procedure Set_Print_In_Hex
9697 (N : Node_Id; Val : Boolean := True); -- Flag13
9698
9699 procedure Set_Private_Declarations
9700 (N : Node_Id; Val : List_Id); -- List3
9701
9702 procedure Set_Private_Present
9703 (N : Node_Id; Val : Boolean := True); -- Flag15
9704
9705 procedure Set_Procedure_To_Call
9706 (N : Node_Id; Val : Node_Id); -- Node2
9707
9708 procedure Set_Proper_Body
9709 (N : Node_Id; Val : Node_Id); -- Node1
9710
9711 procedure Set_Protected_Definition
9712 (N : Node_Id; Val : Node_Id); -- Node3
9713
9714 procedure Set_Protected_Present
9715 (N : Node_Id; Val : Boolean := True); -- Flag6
9716
9717 procedure Set_Raises_Constraint_Error
9718 (N : Node_Id; Val : Boolean := True); -- Flag7
9719
9720 procedure Set_Range_Constraint
9721 (N : Node_Id; Val : Node_Id); -- Node4
9722
9723 procedure Set_Range_Expression
9724 (N : Node_Id; Val : Node_Id); -- Node4
9725
9726 procedure Set_Real_Range_Specification
9727 (N : Node_Id; Val : Node_Id); -- Node4
9728
9729 procedure Set_Realval
9730 (N : Node_Id; Val : Ureal); -- Ureal3
9731
9732 procedure Set_Reason
9733 (N : Node_Id; Val : Uint); -- Uint3
9734
9735 procedure Set_Record_Extension_Part
9736 (N : Node_Id; Val : Node_Id); -- Node3
9737
9738 procedure Set_Redundant_Use
9739 (N : Node_Id; Val : Boolean := True); -- Flag13
9740
9741 procedure Set_Renaming_Exception
9742 (N : Node_Id; Val : Node_Id); -- Node2
9743
9744 procedure Set_Result_Definition
9745 (N : Node_Id; Val : Node_Id); -- Node4
9746
9747 procedure Set_Return_Object_Declarations
9748 (N : Node_Id; Val : List_Id); -- List3
9749
9750 procedure Set_Return_Statement_Entity
9751 (N : Node_Id; Val : Node_Id); -- Node5
9752
9753 procedure Set_Reverse_Present
9754 (N : Node_Id; Val : Boolean := True); -- Flag15
9755
9756 procedure Set_Right_Opnd
9757 (N : Node_Id; Val : Node_Id); -- Node3
9758
9759 procedure Set_Rounded_Result
9760 (N : Node_Id; Val : Boolean := True); -- Flag18
9761
9762 procedure Set_SCIL_Controlling_Tag
9763 (N : Node_Id; Val : Node_Id); -- Node5
9764
9765 procedure Set_SCIL_Entity
9766 (N : Node_Id; Val : Node_Id); -- Node4
9767
9768 procedure Set_SCIL_Tag_Value
9769 (N : Node_Id; Val : Node_Id); -- Node5
9770
9771 procedure Set_SCIL_Target_Prim
9772 (N : Node_Id; Val : Node_Id); -- Node2
9773
9774 procedure Set_Scope
9775 (N : Node_Id; Val : Node_Id); -- Node3
9776
9777 procedure Set_Select_Alternatives
9778 (N : Node_Id; Val : List_Id); -- List1
9779
9780 procedure Set_Selector_Name
9781 (N : Node_Id; Val : Node_Id); -- Node2
9782
9783 procedure Set_Selector_Names
9784 (N : Node_Id; Val : List_Id); -- List1
9785
9786 procedure Set_Shift_Count_OK
9787 (N : Node_Id; Val : Boolean := True); -- Flag4
9788
9789 procedure Set_Source_Type
9790 (N : Node_Id; Val : Entity_Id); -- Node1
9791
9792 procedure Set_Specification
9793 (N : Node_Id; Val : Node_Id); -- Node1
9794
9795 procedure Set_Split_PPC
9796 (N : Node_Id; Val : Boolean); -- Flag17
9797
9798 procedure Set_Statements
9799 (N : Node_Id; Val : List_Id); -- List3
9800
9801 procedure Set_Static_Processing_OK
9802 (N : Node_Id; Val : Boolean); -- Flag4
9803
9804 procedure Set_Storage_Pool
9805 (N : Node_Id; Val : Node_Id); -- Node1
9806
9807 procedure Set_Strval
9808 (N : Node_Id; Val : String_Id); -- Str3
9809
9810 procedure Set_Subtype_Indication
9811 (N : Node_Id; Val : Node_Id); -- Node5
9812
9813 procedure Set_Subtype_Mark
9814 (N : Node_Id; Val : Node_Id); -- Node4
9815
9816 procedure Set_Subtype_Marks
9817 (N : Node_Id; Val : List_Id); -- List2
9818
9819 procedure Set_Suppress_Assignment_Checks
9820 (N : Node_Id; Val : Boolean := True); -- Flag18
9821
9822 procedure Set_Suppress_Loop_Warnings
9823 (N : Node_Id; Val : Boolean := True); -- Flag17
9824
9825 procedure Set_Synchronized_Present
9826 (N : Node_Id; Val : Boolean := True); -- Flag7
9827
9828 procedure Set_Tagged_Present
9829 (N : Node_Id; Val : Boolean := True); -- Flag15
9830
9831 procedure Set_Target_Type
9832 (N : Node_Id; Val : Entity_Id); -- Node2
9833
9834 procedure Set_Task_Definition
9835 (N : Node_Id; Val : Node_Id); -- Node3
9836
9837 procedure Set_Task_Present
9838 (N : Node_Id; Val : Boolean := True); -- Flag5
9839
9840 procedure Set_Then_Actions
9841 (N : Node_Id; Val : List_Id); -- List2
9842
9843 procedure Set_Then_Statements
9844 (N : Node_Id; Val : List_Id); -- List2
9845
9846 procedure Set_Treat_Fixed_As_Integer
9847 (N : Node_Id; Val : Boolean := True); -- Flag14
9848
9849 procedure Set_Triggering_Alternative
9850 (N : Node_Id; Val : Node_Id); -- Node1
9851
9852 procedure Set_Triggering_Statement
9853 (N : Node_Id; Val : Node_Id); -- Node1
9854
9855 procedure Set_TSS_Elist
9856 (N : Node_Id; Val : Elist_Id); -- Elist3
9857
9858 procedure Set_Type_Definition
9859 (N : Node_Id; Val : Node_Id); -- Node3
9860
9861 procedure Set_Unit
9862 (N : Node_Id; Val : Node_Id); -- Node2
9863
9864 procedure Set_Unknown_Discriminants_Present
9865 (N : Node_Id; Val : Boolean := True); -- Flag13
9866
9867 procedure Set_Unreferenced_In_Spec
9868 (N : Node_Id; Val : Boolean := True); -- Flag7
9869
9870 procedure Set_Variant_Part
9871 (N : Node_Id; Val : Node_Id); -- Node4
9872
9873 procedure Set_Variants
9874 (N : Node_Id; Val : List_Id); -- List1
9875
9876 procedure Set_Visible_Declarations
9877 (N : Node_Id; Val : List_Id); -- List2
9878
9879 procedure Set_Was_Originally_Stub
9880 (N : Node_Id; Val : Boolean := True); -- Flag13
9881
9882 procedure Set_Withed_Body
9883 (N : Node_Id; Val : Node_Id); -- Node1
9884
9885 procedure Set_Zero_Cost_Handling
9886 (N : Node_Id; Val : Boolean := True); -- Flag5
9887
9888 -------------------------
9889 -- Iterator Procedures --
9890 -------------------------
9891
9892 -- The call to Next_xxx (N) is equivalent to N := Next_xxx (N)
9893
9894 procedure Next_Entity (N : in out Node_Id);
9895 procedure Next_Named_Actual (N : in out Node_Id);
9896 procedure Next_Rep_Item (N : in out Node_Id);
9897 procedure Next_Use_Clause (N : in out Node_Id);
9898
9899 -------------------------------------------
9900 -- Miscellaneous Tree Access Subprograms --
9901 -------------------------------------------
9902
9903 function End_Location (N : Node_Id) return Source_Ptr;
9904 -- N is an N_If_Statement or N_Case_Statement node, and this function
9905 -- returns the location of the IF token in the END IF sequence by
9906 -- translating the value of the End_Span field.
9907
9908 procedure Set_End_Location (N : Node_Id; S : Source_Ptr);
9909 -- N is an N_If_Statement or N_Case_Statement node. This procedure sets
9910 -- the End_Span field to correspond to the given value S. In other words,
9911 -- End_Span is set to the difference between S and Sloc (N), the starting
9912 -- location.
9913
9914 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id;
9915 -- Given an argument to a pragma Arg, this function returns the expression
9916 -- for the argument. This is Arg itself, or, in the case where Arg is a
9917 -- pragma argument association node, the expression from this node.
9918
9919 --------------------------------
9920 -- Node_Kind Membership Tests --
9921 --------------------------------
9922
9923 -- The following functions allow a convenient notation for testing whether
9924 -- a Node_Kind value matches any one of a list of possible values. In each
9925 -- case True is returned if the given T argument is equal to any of the V
9926 -- arguments. Note that there is a similar set of functions defined in
9927 -- Atree where the first argument is a Node_Id whose Nkind field is tested.
9928
9929 function Nkind_In
9930 (T : Node_Kind;
9931 V1 : Node_Kind;
9932 V2 : Node_Kind) return Boolean;
9933
9934 function Nkind_In
9935 (T : Node_Kind;
9936 V1 : Node_Kind;
9937 V2 : Node_Kind;
9938 V3 : Node_Kind) return Boolean;
9939
9940 function Nkind_In
9941 (T : Node_Kind;
9942 V1 : Node_Kind;
9943 V2 : Node_Kind;
9944 V3 : Node_Kind;
9945 V4 : Node_Kind) return Boolean;
9946
9947 function Nkind_In
9948 (T : Node_Kind;
9949 V1 : Node_Kind;
9950 V2 : Node_Kind;
9951 V3 : Node_Kind;
9952 V4 : Node_Kind;
9953 V5 : Node_Kind) return Boolean;
9954
9955 function Nkind_In
9956 (T : Node_Kind;
9957 V1 : Node_Kind;
9958 V2 : Node_Kind;
9959 V3 : Node_Kind;
9960 V4 : Node_Kind;
9961 V5 : Node_Kind;
9962 V6 : Node_Kind) return Boolean;
9963
9964 function Nkind_In
9965 (T : Node_Kind;
9966 V1 : Node_Kind;
9967 V2 : Node_Kind;
9968 V3 : Node_Kind;
9969 V4 : Node_Kind;
9970 V5 : Node_Kind;
9971 V6 : Node_Kind;
9972 V7 : Node_Kind) return Boolean;
9973
9974 function Nkind_In
9975 (T : Node_Kind;
9976 V1 : Node_Kind;
9977 V2 : Node_Kind;
9978 V3 : Node_Kind;
9979 V4 : Node_Kind;
9980 V5 : Node_Kind;
9981 V6 : Node_Kind;
9982 V7 : Node_Kind;
9983 V8 : Node_Kind) return Boolean;
9984
9985 function Nkind_In
9986 (T : Node_Kind;
9987 V1 : Node_Kind;
9988 V2 : Node_Kind;
9989 V3 : Node_Kind;
9990 V4 : Node_Kind;
9991 V5 : Node_Kind;
9992 V6 : Node_Kind;
9993 V7 : Node_Kind;
9994 V8 : Node_Kind;
9995 V9 : Node_Kind) return Boolean;
9996
9997 pragma Inline (Nkind_In);
9998 -- Inline all above functions
9999
10000 -----------------------
10001 -- Utility Functions --
10002 -----------------------
10003
10004 function Pragma_Name (N : Node_Id) return Name_Id;
10005 pragma Inline (Pragma_Name);
10006 -- Convenient function to obtain Chars field of Pragma_Identifier
10007
10008 -----------------------------
10009 -- Syntactic Parent Tables --
10010 -----------------------------
10011
10012 -- These tables show for each node, and for each of the five fields,
10013 -- whether the corresponding field is syntactic (True) or semantic (False).
10014 -- Unused entries are also set to False.
10015
10016 subtype Field_Num is Natural range 1 .. 5;
10017
10018 Is_Syntactic_Field : constant array (Node_Kind, Field_Num) of Boolean := (
10019
10020 -- Following entries can be built automatically from the sinfo sources
10021 -- using the makeisf utility (currently this program is in spitbol).
10022
10023 N_Identifier =>
10024 (1 => True, -- Chars (Name1)
10025 2 => False, -- Original_Discriminant (Node2-Sem)
10026 3 => False, -- unused
10027 4 => False, -- Entity (Node4-Sem)
10028 5 => False), -- Etype (Node5-Sem)
10029
10030 N_Integer_Literal =>
10031 (1 => False, -- unused
10032 2 => False, -- Original_Entity (Node2-Sem)
10033 3 => True, -- Intval (Uint3)
10034 4 => False, -- unused
10035 5 => False), -- Etype (Node5-Sem)
10036
10037 N_Real_Literal =>
10038 (1 => False, -- unused
10039 2 => False, -- Original_Entity (Node2-Sem)
10040 3 => True, -- Realval (Ureal3)
10041 4 => False, -- Corresponding_Integer_Value (Uint4-Sem)
10042 5 => False), -- Etype (Node5-Sem)
10043
10044 N_Character_Literal =>
10045 (1 => True, -- Chars (Name1)
10046 2 => True, -- Char_Literal_Value (Uint2)
10047 3 => False, -- unused
10048 4 => False, -- Entity (Node4-Sem)
10049 5 => False), -- Etype (Node5-Sem)
10050
10051 N_String_Literal =>
10052 (1 => False, -- unused
10053 2 => False, -- unused
10054 3 => True, -- Strval (Str3)
10055 4 => False, -- unused
10056 5 => False), -- Etype (Node5-Sem)
10057
10058 N_Pragma =>
10059 (1 => False, -- Next_Pragma (Node1-Sem)
10060 2 => True, -- Pragma_Argument_Associations (List2)
10061 3 => True, -- Debug_Statement (Node3)
10062 4 => True, -- Pragma_Identifier (Node4)
10063 5 => False), -- Next_Rep_Item (Node5-Sem)
10064
10065 N_Pragma_Argument_Association =>
10066 (1 => True, -- Chars (Name1)
10067 2 => False, -- unused
10068 3 => True, -- Expression (Node3)
10069 4 => False, -- unused
10070 5 => False), -- unused
10071
10072 N_Defining_Identifier =>
10073 (1 => True, -- Chars (Name1)
10074 2 => False, -- Next_Entity (Node2-Sem)
10075 3 => False, -- Scope (Node3-Sem)
10076 4 => False, -- unused
10077 5 => False), -- Etype (Node5-Sem)
10078
10079 N_Full_Type_Declaration =>
10080 (1 => True, -- Defining_Identifier (Node1)
10081 2 => False, -- unused
10082 3 => True, -- Type_Definition (Node3)
10083 4 => True, -- Discriminant_Specifications (List4)
10084 5 => False), -- unused
10085
10086 N_Subtype_Declaration =>
10087 (1 => True, -- Defining_Identifier (Node1)
10088 2 => False, -- unused
10089 3 => False, -- unused
10090 4 => False, -- Generic_Parent_Type (Node4-Sem)
10091 5 => True), -- Subtype_Indication (Node5)
10092
10093 N_Subtype_Indication =>
10094 (1 => False, -- unused
10095 2 => False, -- unused
10096 3 => True, -- Constraint (Node3)
10097 4 => True, -- Subtype_Mark (Node4)
10098 5 => False), -- Etype (Node5-Sem)
10099
10100 N_Object_Declaration =>
10101 (1 => True, -- Defining_Identifier (Node1)
10102 2 => False, -- Handler_List_Entry (Node2-Sem)
10103 3 => True, -- Expression (Node3)
10104 4 => True, -- Object_Definition (Node4)
10105 5 => False), -- Corresponding_Generic_Association (Node5-Sem)
10106
10107 N_Number_Declaration =>
10108 (1 => True, -- Defining_Identifier (Node1)
10109 2 => False, -- unused
10110 3 => True, -- Expression (Node3)
10111 4 => False, -- unused
10112 5 => False), -- unused
10113
10114 N_Derived_Type_Definition =>
10115 (1 => False, -- unused
10116 2 => True, -- Interface_List (List2)
10117 3 => True, -- Record_Extension_Part (Node3)
10118 4 => False, -- unused
10119 5 => True), -- Subtype_Indication (Node5)
10120
10121 N_Range_Constraint =>
10122 (1 => False, -- unused
10123 2 => False, -- unused
10124 3 => False, -- unused
10125 4 => True, -- Range_Expression (Node4)
10126 5 => False), -- unused
10127
10128 N_Range =>
10129 (1 => True, -- Low_Bound (Node1)
10130 2 => True, -- High_Bound (Node2)
10131 3 => False, -- unused
10132 4 => False, -- unused
10133 5 => False), -- Etype (Node5-Sem)
10134
10135 N_Enumeration_Type_Definition =>
10136 (1 => True, -- Literals (List1)
10137 2 => False, -- unused
10138 3 => False, -- unused
10139 4 => True, -- End_Label (Node4)
10140 5 => False), -- unused
10141
10142 N_Defining_Character_Literal =>
10143 (1 => True, -- Chars (Name1)
10144 2 => False, -- Next_Entity (Node2-Sem)
10145 3 => False, -- Scope (Node3-Sem)
10146 4 => False, -- unused
10147 5 => False), -- Etype (Node5-Sem)
10148
10149 N_Signed_Integer_Type_Definition =>
10150 (1 => True, -- Low_Bound (Node1)
10151 2 => True, -- High_Bound (Node2)
10152 3 => False, -- unused
10153 4 => False, -- unused
10154 5 => False), -- unused
10155
10156 N_Modular_Type_Definition =>
10157 (1 => False, -- unused
10158 2 => False, -- unused
10159 3 => True, -- Expression (Node3)
10160 4 => False, -- unused
10161 5 => False), -- unused
10162
10163 N_Floating_Point_Definition =>
10164 (1 => False, -- unused
10165 2 => True, -- Digits_Expression (Node2)
10166 3 => False, -- unused
10167 4 => True, -- Real_Range_Specification (Node4)
10168 5 => False), -- unused
10169
10170 N_Real_Range_Specification =>
10171 (1 => True, -- Low_Bound (Node1)
10172 2 => True, -- High_Bound (Node2)
10173 3 => False, -- unused
10174 4 => False, -- unused
10175 5 => False), -- unused
10176
10177 N_Ordinary_Fixed_Point_Definition =>
10178 (1 => False, -- unused
10179 2 => False, -- unused
10180 3 => True, -- Delta_Expression (Node3)
10181 4 => True, -- Real_Range_Specification (Node4)
10182 5 => False), -- unused
10183
10184 N_Decimal_Fixed_Point_Definition =>
10185 (1 => False, -- unused
10186 2 => True, -- Digits_Expression (Node2)
10187 3 => True, -- Delta_Expression (Node3)
10188 4 => True, -- Real_Range_Specification (Node4)
10189 5 => False), -- unused
10190
10191 N_Digits_Constraint =>
10192 (1 => False, -- unused
10193 2 => True, -- Digits_Expression (Node2)
10194 3 => False, -- unused
10195 4 => True, -- Range_Constraint (Node4)
10196 5 => False), -- unused
10197
10198 N_Unconstrained_Array_Definition =>
10199 (1 => False, -- unused
10200 2 => True, -- Subtype_Marks (List2)
10201 3 => False, -- unused
10202 4 => True, -- Component_Definition (Node4)
10203 5 => False), -- unused
10204
10205 N_Constrained_Array_Definition =>
10206 (1 => False, -- unused
10207 2 => True, -- Discrete_Subtype_Definitions (List2)
10208 3 => False, -- unused
10209 4 => True, -- Component_Definition (Node4)
10210 5 => False), -- unused
10211
10212 N_Component_Definition =>
10213 (1 => False, -- unused
10214 2 => False, -- unused
10215 3 => True, -- Access_Definition (Node3)
10216 4 => False, -- unused
10217 5 => True), -- Subtype_Indication (Node5)
10218
10219 N_Discriminant_Specification =>
10220 (1 => True, -- Defining_Identifier (Node1)
10221 2 => False, -- unused
10222 3 => True, -- Expression (Node3)
10223 4 => False, -- unused
10224 5 => True), -- Discriminant_Type (Node5)
10225
10226 N_Index_Or_Discriminant_Constraint =>
10227 (1 => True, -- Constraints (List1)
10228 2 => False, -- unused
10229 3 => False, -- unused
10230 4 => False, -- unused
10231 5 => False), -- unused
10232
10233 N_Discriminant_Association =>
10234 (1 => True, -- Selector_Names (List1)
10235 2 => False, -- unused
10236 3 => True, -- Expression (Node3)
10237 4 => False, -- unused
10238 5 => False), -- unused
10239
10240 N_Record_Definition =>
10241 (1 => True, -- Component_List (Node1)
10242 2 => True, -- Interface_List (List2)
10243 3 => False, -- unused
10244 4 => True, -- End_Label (Node4)
10245 5 => False), -- unused
10246
10247 N_Component_List =>
10248 (1 => False, -- unused
10249 2 => False, -- unused
10250 3 => True, -- Component_Items (List3)
10251 4 => True, -- Variant_Part (Node4)
10252 5 => False), -- unused
10253
10254 N_Component_Declaration =>
10255 (1 => True, -- Defining_Identifier (Node1)
10256 2 => False, -- unused
10257 3 => True, -- Expression (Node3)
10258 4 => True, -- Component_Definition (Node4)
10259 5 => False), -- unused
10260
10261 N_Variant_Part =>
10262 (1 => True, -- Variants (List1)
10263 2 => True, -- Name (Node2)
10264 3 => False, -- unused
10265 4 => False, -- unused
10266 5 => False), -- unused
10267
10268 N_Variant =>
10269 (1 => True, -- Component_List (Node1)
10270 2 => False, -- Enclosing_Variant (Node2-Sem)
10271 3 => False, -- Present_Expr (Uint3-Sem)
10272 4 => True, -- Discrete_Choices (List4)
10273 5 => False), -- Dcheck_Function (Node5-Sem)
10274
10275 N_Others_Choice =>
10276 (1 => False, -- Others_Discrete_Choices (List1-Sem)
10277 2 => False, -- unused
10278 3 => False, -- unused
10279 4 => False, -- unused
10280 5 => False), -- unused
10281
10282 N_Access_To_Object_Definition =>
10283 (1 => False, -- unused
10284 2 => False, -- unused
10285 3 => False, -- unused
10286 4 => False, -- unused
10287 5 => True), -- Subtype_Indication (Node5)
10288
10289 N_Access_Function_Definition =>
10290 (1 => False, -- unused
10291 2 => False, -- unused
10292 3 => True, -- Parameter_Specifications (List3)
10293 4 => True, -- Result_Definition (Node4)
10294 5 => False), -- unused
10295
10296 N_Access_Procedure_Definition =>
10297 (1 => False, -- unused
10298 2 => False, -- unused
10299 3 => True, -- Parameter_Specifications (List3)
10300 4 => False, -- unused
10301 5 => False), -- unused
10302
10303 N_Access_Definition =>
10304 (1 => False, -- unused
10305 2 => False, -- unused
10306 3 => True, -- Access_To_Subprogram_Definition (Node3)
10307 4 => True, -- Subtype_Mark (Node4)
10308 5 => False), -- unused
10309
10310 N_Incomplete_Type_Declaration =>
10311 (1 => True, -- Defining_Identifier (Node1)
10312 2 => False, -- unused
10313 3 => False, -- unused
10314 4 => True, -- Discriminant_Specifications (List4)
10315 5 => False), -- unused
10316
10317 N_Explicit_Dereference =>
10318 (1 => False, -- unused
10319 2 => False, -- unused
10320 3 => True, -- Prefix (Node3)
10321 4 => False, -- Actual_Designated_Subtype (Node4-Sem)
10322 5 => False), -- Etype (Node5-Sem)
10323
10324 N_Indexed_Component =>
10325 (1 => True, -- Expressions (List1)
10326 2 => False, -- unused
10327 3 => True, -- Prefix (Node3)
10328 4 => False, -- unused
10329 5 => False), -- Etype (Node5-Sem)
10330
10331 N_Slice =>
10332 (1 => False, -- unused
10333 2 => False, -- unused
10334 3 => True, -- Prefix (Node3)
10335 4 => True, -- Discrete_Range (Node4)
10336 5 => False), -- Etype (Node5-Sem)
10337
10338 N_Selected_Component =>
10339 (1 => False, -- unused
10340 2 => True, -- Selector_Name (Node2)
10341 3 => True, -- Prefix (Node3)
10342 4 => False, -- unused
10343 5 => False), -- Etype (Node5-Sem)
10344
10345 N_Attribute_Reference =>
10346 (1 => True, -- Expressions (List1)
10347 2 => True, -- Attribute_Name (Name2)
10348 3 => True, -- Prefix (Node3)
10349 4 => False, -- Entity (Node4-Sem)
10350 5 => False), -- Etype (Node5-Sem)
10351
10352 N_Aggregate =>
10353 (1 => True, -- Expressions (List1)
10354 2 => True, -- Component_Associations (List2)
10355 3 => False, -- Aggregate_Bounds (Node3-Sem)
10356 4 => False, -- unused
10357 5 => False), -- Etype (Node5-Sem)
10358
10359 N_Component_Association =>
10360 (1 => True, -- Choices (List1)
10361 2 => False, -- Loop_Actions (List2-Sem)
10362 3 => True, -- Expression (Node3)
10363 4 => False, -- unused
10364 5 => False), -- unused
10365
10366 N_Extension_Aggregate =>
10367 (1 => True, -- Expressions (List1)
10368 2 => True, -- Component_Associations (List2)
10369 3 => True, -- Ancestor_Part (Node3)
10370 4 => False, -- unused
10371 5 => False), -- Etype (Node5-Sem)
10372
10373 N_Null =>
10374 (1 => False, -- unused
10375 2 => False, -- unused
10376 3 => False, -- unused
10377 4 => False, -- unused
10378 5 => False), -- Etype (Node5-Sem)
10379
10380 N_And_Then =>
10381 (1 => False, -- Actions (List1-Sem)
10382 2 => True, -- Left_Opnd (Node2)
10383 3 => True, -- Right_Opnd (Node3)
10384 4 => False, -- unused
10385 5 => False), -- Etype (Node5-Sem)
10386
10387 N_Or_Else =>
10388 (1 => False, -- Actions (List1-Sem)
10389 2 => True, -- Left_Opnd (Node2)
10390 3 => True, -- Right_Opnd (Node3)
10391 4 => False, -- unused
10392 5 => False), -- Etype (Node5-Sem)
10393
10394 N_In =>
10395 (1 => False, -- unused
10396 2 => True, -- Left_Opnd (Node2)
10397 3 => True, -- Right_Opnd (Node3)
10398 4 => True, -- Alternatives (List4)
10399 5 => False), -- Etype (Node5-Sem)
10400
10401 N_Not_In =>
10402 (1 => False, -- unused
10403 2 => True, -- Left_Opnd (Node2)
10404 3 => True, -- Right_Opnd (Node3)
10405 4 => True, -- Alternatives (List4)
10406 5 => False), -- Etype (Node5-Sem)
10407
10408 N_Op_And =>
10409 (1 => True, -- Chars (Name1)
10410 2 => True, -- Left_Opnd (Node2)
10411 3 => True, -- Right_Opnd (Node3)
10412 4 => False, -- Entity (Node4-Sem)
10413 5 => False), -- Etype (Node5-Sem)
10414
10415 N_Op_Or =>
10416 (1 => True, -- Chars (Name1)
10417 2 => True, -- Left_Opnd (Node2)
10418 3 => True, -- Right_Opnd (Node3)
10419 4 => False, -- Entity (Node4-Sem)
10420 5 => False), -- Etype (Node5-Sem)
10421
10422 N_Op_Xor =>
10423 (1 => True, -- Chars (Name1)
10424 2 => True, -- Left_Opnd (Node2)
10425 3 => True, -- Right_Opnd (Node3)
10426 4 => False, -- Entity (Node4-Sem)
10427 5 => False), -- Etype (Node5-Sem)
10428
10429 N_Op_Eq =>
10430 (1 => True, -- Chars (Name1)
10431 2 => True, -- Left_Opnd (Node2)
10432 3 => True, -- Right_Opnd (Node3)
10433 4 => False, -- Entity (Node4-Sem)
10434 5 => False), -- Etype (Node5-Sem)
10435
10436 N_Op_Ne =>
10437 (1 => True, -- Chars (Name1)
10438 2 => True, -- Left_Opnd (Node2)
10439 3 => True, -- Right_Opnd (Node3)
10440 4 => False, -- Entity (Node4-Sem)
10441 5 => False), -- Etype (Node5-Sem)
10442
10443 N_Op_Lt =>
10444 (1 => True, -- Chars (Name1)
10445 2 => True, -- Left_Opnd (Node2)
10446 3 => True, -- Right_Opnd (Node3)
10447 4 => False, -- Entity (Node4-Sem)
10448 5 => False), -- Etype (Node5-Sem)
10449
10450 N_Op_Le =>
10451 (1 => True, -- Chars (Name1)
10452 2 => True, -- Left_Opnd (Node2)
10453 3 => True, -- Right_Opnd (Node3)
10454 4 => False, -- Entity (Node4-Sem)
10455 5 => False), -- Etype (Node5-Sem)
10456
10457 N_Op_Gt =>
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)
10463
10464 N_Op_Ge =>
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)
10470
10471 N_Op_Add =>
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)
10477
10478 N_Op_Subtract =>
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)
10484
10485 N_Op_Concat =>
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)
10491
10492 N_Op_Multiply =>
10493 (1 => True, -- Chars (Name1)
10494 2 => True, -- Left_Opnd (Node2)
10495 3 => True, -- Right_Opnd (Node3)
10496 4 => False, -- Entity (Node4-Sem)
10497 5 => False), -- Etype (Node5-Sem)
10498
10499 N_Op_Divide =>
10500 (1 => True, -- Chars (Name1)
10501 2 => True, -- Left_Opnd (Node2)
10502 3 => True, -- Right_Opnd (Node3)
10503 4 => False, -- Entity (Node4-Sem)
10504 5 => False), -- Etype (Node5-Sem)
10505
10506 N_Op_Mod =>
10507 (1 => True, -- Chars (Name1)
10508 2 => True, -- Left_Opnd (Node2)
10509 3 => True, -- Right_Opnd (Node3)
10510 4 => False, -- Entity (Node4-Sem)
10511 5 => False), -- Etype (Node5-Sem)
10512
10513 N_Op_Rem =>
10514 (1 => True, -- Chars (Name1)
10515 2 => True, -- Left_Opnd (Node2)
10516 3 => True, -- Right_Opnd (Node3)
10517 4 => False, -- Entity (Node4-Sem)
10518 5 => False), -- Etype (Node5-Sem)
10519
10520 N_Op_Expon =>
10521 (1 => True, -- Chars (Name1)
10522 2 => True, -- Left_Opnd (Node2)
10523 3 => True, -- Right_Opnd (Node3)
10524 4 => False, -- Entity (Node4-Sem)
10525 5 => False), -- Etype (Node5-Sem)
10526
10527 N_Op_Plus =>
10528 (1 => True, -- Chars (Name1)
10529 2 => False, -- unused
10530 3 => True, -- Right_Opnd (Node3)
10531 4 => False, -- Entity (Node4-Sem)
10532 5 => False), -- Etype (Node5-Sem)
10533
10534 N_Op_Minus =>
10535 (1 => True, -- Chars (Name1)
10536 2 => False, -- unused
10537 3 => True, -- Right_Opnd (Node3)
10538 4 => False, -- Entity (Node4-Sem)
10539 5 => False), -- Etype (Node5-Sem)
10540
10541 N_Op_Abs =>
10542 (1 => True, -- Chars (Name1)
10543 2 => False, -- unused
10544 3 => True, -- Right_Opnd (Node3)
10545 4 => False, -- Entity (Node4-Sem)
10546 5 => False), -- Etype (Node5-Sem)
10547
10548 N_Op_Not =>
10549 (1 => True, -- Chars (Name1)
10550 2 => False, -- unused
10551 3 => True, -- Right_Opnd (Node3)
10552 4 => False, -- Entity (Node4-Sem)
10553 5 => False), -- Etype (Node5-Sem)
10554
10555 N_Type_Conversion =>
10556 (1 => False, -- unused
10557 2 => False, -- unused
10558 3 => True, -- Expression (Node3)
10559 4 => True, -- Subtype_Mark (Node4)
10560 5 => False), -- Etype (Node5-Sem)
10561
10562 N_Qualified_Expression =>
10563 (1 => False, -- unused
10564 2 => False, -- unused
10565 3 => True, -- Expression (Node3)
10566 4 => True, -- Subtype_Mark (Node4)
10567 5 => False), -- Etype (Node5-Sem)
10568
10569 N_Quantified_Expression =>
10570 (1 => True, -- Condition (Node1)
10571 2 => True, -- Iterator_Specification
10572 3 => False, -- unused
10573 4 => True, -- Loop_Parameter_Specification (Node4)
10574 5 => False), -- Etype (Node5-Sem)
10575
10576 N_Allocator =>
10577 (1 => False, -- Storage_Pool (Node1-Sem)
10578 2 => False, -- Procedure_To_Call (Node2-Sem)
10579 3 => True, -- Expression (Node3)
10580 4 => False, -- Coextensions (Elist4-Sem)
10581 5 => False), -- Etype (Node5-Sem)
10582
10583 N_Null_Statement =>
10584 (1 => False, -- unused
10585 2 => False, -- unused
10586 3 => False, -- unused
10587 4 => False, -- unused
10588 5 => False), -- unused
10589
10590 N_Label =>
10591 (1 => True, -- Identifier (Node1)
10592 2 => False, -- unused
10593 3 => False, -- unused
10594 4 => False, -- unused
10595 5 => False), -- unused
10596
10597 N_Assignment_Statement =>
10598 (1 => False, -- unused
10599 2 => True, -- Name (Node2)
10600 3 => True, -- Expression (Node3)
10601 4 => False, -- unused
10602 5 => False), -- unused
10603
10604 N_If_Statement =>
10605 (1 => True, -- Condition (Node1)
10606 2 => True, -- Then_Statements (List2)
10607 3 => True, -- Elsif_Parts (List3)
10608 4 => True, -- Else_Statements (List4)
10609 5 => True), -- End_Span (Uint5)
10610
10611 N_Elsif_Part =>
10612 (1 => True, -- Condition (Node1)
10613 2 => True, -- Then_Statements (List2)
10614 3 => False, -- Condition_Actions (List3-Sem)
10615 4 => False, -- unused
10616 5 => False), -- unused
10617
10618 N_Case_Expression =>
10619 (1 => False, -- unused
10620 2 => False, -- unused
10621 3 => True, -- Expression (Node3)
10622 4 => True, -- Alternatives (List4)
10623 5 => False), -- unused
10624
10625 N_Case_Expression_Alternative =>
10626 (1 => False, -- Actions (List1-Sem)
10627 2 => False, -- unused
10628 3 => True, -- Statements (List3)
10629 4 => True, -- Expression (Node4)
10630 5 => False), -- unused
10631
10632 N_Case_Statement =>
10633 (1 => False, -- unused
10634 2 => False, -- unused
10635 3 => True, -- Expression (Node3)
10636 4 => True, -- Alternatives (List4)
10637 5 => True), -- End_Span (Uint5)
10638
10639 N_Case_Statement_Alternative =>
10640 (1 => False, -- unused
10641 2 => False, -- unused
10642 3 => True, -- Statements (List3)
10643 4 => True, -- Discrete_Choices (List4)
10644 5 => False), -- unused
10645
10646 N_Loop_Statement =>
10647 (1 => True, -- Identifier (Node1)
10648 2 => True, -- Iteration_Scheme (Node2)
10649 3 => True, -- Statements (List3)
10650 4 => True, -- End_Label (Node4)
10651 5 => False), -- unused
10652
10653 N_Iteration_Scheme =>
10654 (1 => True, -- Condition (Node1)
10655 2 => True, -- Iterator_Specification (Node2)
10656 3 => False, -- Condition_Actions (List3-Sem)
10657 4 => True, -- Loop_Parameter_Specification (Node4)
10658 5 => False), -- unused
10659
10660 N_Loop_Parameter_Specification =>
10661 (1 => True, -- Defining_Identifier (Node1)
10662 2 => False, -- unused
10663 3 => False, -- unused
10664 4 => True, -- Discrete_Subtype_Definition (Node4)
10665 5 => False), -- unused
10666
10667 N_Iterator_Specification =>
10668 (1 => True, -- Defining_Identifier (Node1)
10669 2 => True, -- Name (Node2)
10670 3 => False, -- Unused
10671 4 => False, -- Unused
10672 5 => True), -- Subtype_Indication (Node5)
10673
10674 N_Block_Statement =>
10675 (1 => True, -- Identifier (Node1)
10676 2 => True, -- Declarations (List2)
10677 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10678 4 => True, -- Handled_Statement_Sequence (Node4)
10679 5 => False), -- unused
10680
10681 N_Exit_Statement =>
10682 (1 => True, -- Condition (Node1)
10683 2 => True, -- Name (Node2)
10684 3 => False, -- unused
10685 4 => False, -- unused
10686 5 => False), -- unused
10687
10688 N_Goto_Statement =>
10689 (1 => False, -- unused
10690 2 => True, -- Name (Node2)
10691 3 => False, -- unused
10692 4 => False, -- unused
10693 5 => False), -- unused
10694
10695 N_Subprogram_Declaration =>
10696 (1 => True, -- Specification (Node1)
10697 2 => False, -- unused
10698 3 => False, -- Body_To_Inline (Node3-Sem)
10699 4 => False, -- Parent_Spec (Node4-Sem)
10700 5 => False), -- Corresponding_Body (Node5-Sem)
10701
10702 N_Abstract_Subprogram_Declaration =>
10703 (1 => True, -- Specification (Node1)
10704 2 => False, -- unused
10705 3 => False, -- unused
10706 4 => False, -- unused
10707 5 => False), -- unused
10708
10709 N_Function_Specification =>
10710 (1 => True, -- Defining_Unit_Name (Node1)
10711 2 => False, -- Elaboration_Boolean (Node2-Sem)
10712 3 => True, -- Parameter_Specifications (List3)
10713 4 => True, -- Result_Definition (Node4)
10714 5 => False), -- Generic_Parent (Node5-Sem)
10715
10716 N_Procedure_Specification =>
10717 (1 => True, -- Defining_Unit_Name (Node1)
10718 2 => False, -- Elaboration_Boolean (Node2-Sem)
10719 3 => True, -- Parameter_Specifications (List3)
10720 4 => False, -- unused
10721 5 => False), -- Generic_Parent (Node5-Sem)
10722
10723 N_Designator =>
10724 (1 => True, -- Identifier (Node1)
10725 2 => True, -- Name (Node2)
10726 3 => False, -- unused
10727 4 => False, -- unused
10728 5 => False), -- unused
10729
10730 N_Defining_Program_Unit_Name =>
10731 (1 => True, -- Defining_Identifier (Node1)
10732 2 => True, -- Name (Node2)
10733 3 => False, -- unused
10734 4 => False, -- unused
10735 5 => False), -- unused
10736
10737 N_Operator_Symbol =>
10738 (1 => True, -- Chars (Name1)
10739 2 => False, -- unused
10740 3 => True, -- Strval (Str3)
10741 4 => False, -- Entity (Node4-Sem)
10742 5 => False), -- Etype (Node5-Sem)
10743
10744 N_Defining_Operator_Symbol =>
10745 (1 => True, -- Chars (Name1)
10746 2 => False, -- Next_Entity (Node2-Sem)
10747 3 => False, -- Scope (Node3-Sem)
10748 4 => False, -- unused
10749 5 => False), -- Etype (Node5-Sem)
10750
10751 N_Parameter_Specification =>
10752 (1 => True, -- Defining_Identifier (Node1)
10753 2 => True, -- Parameter_Type (Node2)
10754 3 => True, -- Expression (Node3)
10755 4 => False, -- unused
10756 5 => False), -- Default_Expression (Node5-Sem)
10757
10758 N_Subprogram_Body =>
10759 (1 => True, -- Specification (Node1)
10760 2 => True, -- Declarations (List2)
10761 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10762 4 => True, -- Handled_Statement_Sequence (Node4)
10763 5 => False), -- Corresponding_Spec (Node5-Sem)
10764
10765 N_Parameterized_Expression =>
10766 (1 => True, -- Specification (Node1)
10767 2 => False, -- unused
10768 3 => True, -- Expression (Node3)
10769 4 => False, -- unused
10770 5 => False), -- unused
10771
10772 N_Procedure_Call_Statement =>
10773 (1 => False, -- Controlling_Argument (Node1-Sem)
10774 2 => True, -- Name (Node2)
10775 3 => True, -- Parameter_Associations (List3)
10776 4 => False, -- First_Named_Actual (Node4-Sem)
10777 5 => False), -- Etype (Node5-Sem)
10778
10779 N_Function_Call =>
10780 (1 => False, -- Controlling_Argument (Node1-Sem)
10781 2 => True, -- Name (Node2)
10782 3 => True, -- Parameter_Associations (List3)
10783 4 => False, -- First_Named_Actual (Node4-Sem)
10784 5 => False), -- Etype (Node5-Sem)
10785
10786 N_Parameter_Association =>
10787 (1 => False, -- unused
10788 2 => True, -- Selector_Name (Node2)
10789 3 => True, -- Explicit_Actual_Parameter (Node3)
10790 4 => False, -- Next_Named_Actual (Node4-Sem)
10791 5 => False), -- unused
10792
10793 N_Return_Statement =>
10794 (1 => False, -- Storage_Pool (Node1-Sem)
10795 2 => False, -- Procedure_To_Call (Node2-Sem)
10796 3 => True, -- Expression (Node3)
10797 4 => False, -- unused
10798 5 => False), -- Return_Statement_Entity (Node5-Sem)
10799
10800 N_Extended_Return_Statement =>
10801 (1 => False, -- Storage_Pool (Node1-Sem)
10802 2 => False, -- Procedure_To_Call (Node2-Sem)
10803 3 => True, -- Return_Object_Declarations (List3)
10804 4 => True, -- Handled_Statement_Sequence (Node4)
10805 5 => False), -- Return_Statement_Entity (Node5-Sem)
10806
10807 N_Package_Declaration =>
10808 (1 => True, -- Specification (Node1)
10809 2 => False, -- unused
10810 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10811 4 => False, -- Parent_Spec (Node4-Sem)
10812 5 => False), -- Corresponding_Body (Node5-Sem)
10813
10814 N_Package_Specification =>
10815 (1 => True, -- Defining_Unit_Name (Node1)
10816 2 => True, -- Visible_Declarations (List2)
10817 3 => True, -- Private_Declarations (List3)
10818 4 => True, -- End_Label (Node4)
10819 5 => False), -- Generic_Parent (Node5-Sem)
10820
10821 N_Package_Body =>
10822 (1 => True, -- Defining_Unit_Name (Node1)
10823 2 => True, -- Declarations (List2)
10824 3 => False, -- unused
10825 4 => True, -- Handled_Statement_Sequence (Node4)
10826 5 => False), -- Corresponding_Spec (Node5-Sem)
10827
10828 N_Private_Type_Declaration =>
10829 (1 => True, -- Defining_Identifier (Node1)
10830 2 => False, -- unused
10831 3 => False, -- unused
10832 4 => True, -- Discriminant_Specifications (List4)
10833 5 => False), -- unused
10834
10835 N_Private_Extension_Declaration =>
10836 (1 => True, -- Defining_Identifier (Node1)
10837 2 => True, -- Interface_List (List2)
10838 3 => False, -- unused
10839 4 => True, -- Discriminant_Specifications (List4)
10840 5 => True), -- Subtype_Indication (Node5)
10841
10842 N_Use_Package_Clause =>
10843 (1 => False, -- unused
10844 2 => True, -- Names (List2)
10845 3 => False, -- Next_Use_Clause (Node3-Sem)
10846 4 => False, -- Hidden_By_Use_Clause (Elist4-Sem)
10847 5 => False), -- unused
10848
10849 N_Use_Type_Clause =>
10850 (1 => False, -- unused
10851 2 => True, -- Subtype_Marks (List2)
10852 3 => False, -- Next_Use_Clause (Node3-Sem)
10853 4 => False, -- Hidden_By_Use_Clause (Elist4-Sem)
10854 5 => False), -- unused
10855
10856 N_Object_Renaming_Declaration =>
10857 (1 => True, -- Defining_Identifier (Node1)
10858 2 => True, -- Name (Node2)
10859 3 => True, -- Access_Definition (Node3)
10860 4 => True, -- Subtype_Mark (Node4)
10861 5 => False), -- Corresponding_Generic_Association (Node5-Sem)
10862
10863 N_Exception_Renaming_Declaration =>
10864 (1 => True, -- Defining_Identifier (Node1)
10865 2 => True, -- Name (Node2)
10866 3 => False, -- unused
10867 4 => False, -- unused
10868 5 => False), -- unused
10869
10870 N_Package_Renaming_Declaration =>
10871 (1 => True, -- Defining_Unit_Name (Node1)
10872 2 => True, -- Name (Node2)
10873 3 => False, -- unused
10874 4 => False, -- Parent_Spec (Node4-Sem)
10875 5 => False), -- unused
10876
10877 N_Subprogram_Renaming_Declaration =>
10878 (1 => True, -- Specification (Node1)
10879 2 => True, -- Name (Node2)
10880 3 => False, -- Corresponding_Formal_Spec (Node3-Sem)
10881 4 => False, -- Parent_Spec (Node4-Sem)
10882 5 => False), -- Corresponding_Spec (Node5-Sem)
10883
10884 N_Generic_Package_Renaming_Declaration =>
10885 (1 => True, -- Defining_Unit_Name (Node1)
10886 2 => True, -- Name (Node2)
10887 3 => False, -- unused
10888 4 => False, -- Parent_Spec (Node4-Sem)
10889 5 => False), -- unused
10890
10891 N_Generic_Procedure_Renaming_Declaration =>
10892 (1 => True, -- Defining_Unit_Name (Node1)
10893 2 => True, -- Name (Node2)
10894 3 => False, -- unused
10895 4 => False, -- Parent_Spec (Node4-Sem)
10896 5 => False), -- unused
10897
10898 N_Generic_Function_Renaming_Declaration =>
10899 (1 => True, -- Defining_Unit_Name (Node1)
10900 2 => True, -- Name (Node2)
10901 3 => False, -- unused
10902 4 => False, -- Parent_Spec (Node4-Sem)
10903 5 => False), -- unused
10904
10905 N_Task_Type_Declaration =>
10906 (1 => True, -- Defining_Identifier (Node1)
10907 2 => True, -- Interface_List (List2)
10908 3 => True, -- Task_Definition (Node3)
10909 4 => True, -- Discriminant_Specifications (List4)
10910 5 => False), -- Corresponding_Body (Node5-Sem)
10911
10912 N_Single_Task_Declaration =>
10913 (1 => True, -- Defining_Identifier (Node1)
10914 2 => True, -- Interface_List (List2)
10915 3 => True, -- Task_Definition (Node3)
10916 4 => False, -- unused
10917 5 => False), -- unused
10918
10919 N_Task_Definition =>
10920 (1 => False, -- unused
10921 2 => True, -- Visible_Declarations (List2)
10922 3 => True, -- Private_Declarations (List3)
10923 4 => True, -- End_Label (Node4)
10924 5 => False), -- unused
10925
10926 N_Task_Body =>
10927 (1 => True, -- Defining_Identifier (Node1)
10928 2 => True, -- Declarations (List2)
10929 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10930 4 => True, -- Handled_Statement_Sequence (Node4)
10931 5 => False), -- Corresponding_Spec (Node5-Sem)
10932
10933 N_Protected_Type_Declaration =>
10934 (1 => True, -- Defining_Identifier (Node1)
10935 2 => True, -- Interface_List (List2)
10936 3 => True, -- Protected_Definition (Node3)
10937 4 => True, -- Discriminant_Specifications (List4)
10938 5 => False), -- Corresponding_Body (Node5-Sem)
10939
10940 N_Single_Protected_Declaration =>
10941 (1 => True, -- Defining_Identifier (Node1)
10942 2 => True, -- Interface_List (List2)
10943 3 => True, -- Protected_Definition (Node3)
10944 4 => False, -- unused
10945 5 => False), -- unused
10946
10947 N_Protected_Definition =>
10948 (1 => False, -- unused
10949 2 => True, -- Visible_Declarations (List2)
10950 3 => True, -- Private_Declarations (List3)
10951 4 => True, -- End_Label (Node4)
10952 5 => False), -- unused
10953
10954 N_Protected_Body =>
10955 (1 => True, -- Defining_Identifier (Node1)
10956 2 => True, -- Declarations (List2)
10957 3 => False, -- unused
10958 4 => True, -- End_Label (Node4)
10959 5 => False), -- Corresponding_Spec (Node5-Sem)
10960
10961 N_Entry_Declaration =>
10962 (1 => True, -- Defining_Identifier (Node1)
10963 2 => False, -- unused
10964 3 => True, -- Parameter_Specifications (List3)
10965 4 => True, -- Discrete_Subtype_Definition (Node4)
10966 5 => False), -- Corresponding_Body (Node5-Sem)
10967
10968 N_Accept_Statement =>
10969 (1 => True, -- Entry_Direct_Name (Node1)
10970 2 => True, -- Declarations (List2)
10971 3 => True, -- Parameter_Specifications (List3)
10972 4 => True, -- Handled_Statement_Sequence (Node4)
10973 5 => True), -- Entry_Index (Node5)
10974
10975 N_Entry_Body =>
10976 (1 => True, -- Defining_Identifier (Node1)
10977 2 => True, -- Declarations (List2)
10978 3 => False, -- Activation_Chain_Entity (Node3-Sem)
10979 4 => True, -- Handled_Statement_Sequence (Node4)
10980 5 => True), -- Entry_Body_Formal_Part (Node5)
10981
10982 N_Entry_Body_Formal_Part =>
10983 (1 => True, -- Condition (Node1)
10984 2 => False, -- unused
10985 3 => True, -- Parameter_Specifications (List3)
10986 4 => True, -- Entry_Index_Specification (Node4)
10987 5 => False), -- unused
10988
10989 N_Entry_Index_Specification =>
10990 (1 => True, -- Defining_Identifier (Node1)
10991 2 => False, -- unused
10992 3 => False, -- unused
10993 4 => True, -- Discrete_Subtype_Definition (Node4)
10994 5 => False), -- unused
10995
10996 N_Entry_Call_Statement =>
10997 (1 => False, -- unused
10998 2 => True, -- Name (Node2)
10999 3 => True, -- Parameter_Associations (List3)
11000 4 => False, -- First_Named_Actual (Node4-Sem)
11001 5 => False), -- unused
11002
11003 N_Requeue_Statement =>
11004 (1 => False, -- unused
11005 2 => True, -- Name (Node2)
11006 3 => False, -- unused
11007 4 => False, -- unused
11008 5 => False), -- unused
11009
11010 N_Delay_Until_Statement =>
11011 (1 => False, -- unused
11012 2 => False, -- unused
11013 3 => True, -- Expression (Node3)
11014 4 => False, -- unused
11015 5 => False), -- unused
11016
11017 N_Delay_Relative_Statement =>
11018 (1 => False, -- unused
11019 2 => False, -- unused
11020 3 => True, -- Expression (Node3)
11021 4 => False, -- unused
11022 5 => False), -- unused
11023
11024 N_Selective_Accept =>
11025 (1 => True, -- Select_Alternatives (List1)
11026 2 => False, -- unused
11027 3 => False, -- unused
11028 4 => True, -- Else_Statements (List4)
11029 5 => False), -- unused
11030
11031 N_Accept_Alternative =>
11032 (1 => True, -- Condition (Node1)
11033 2 => True, -- Accept_Statement (Node2)
11034 3 => True, -- Statements (List3)
11035 4 => True, -- Pragmas_Before (List4)
11036 5 => False), -- Accept_Handler_Records (List5-Sem)
11037
11038 N_Delay_Alternative =>
11039 (1 => True, -- Condition (Node1)
11040 2 => True, -- Delay_Statement (Node2)
11041 3 => True, -- Statements (List3)
11042 4 => True, -- Pragmas_Before (List4)
11043 5 => False), -- unused
11044
11045 N_Terminate_Alternative =>
11046 (1 => True, -- Condition (Node1)
11047 2 => False, -- unused
11048 3 => False, -- unused
11049 4 => True, -- Pragmas_Before (List4)
11050 5 => True), -- Pragmas_After (List5)
11051
11052 N_Timed_Entry_Call =>
11053 (1 => True, -- Entry_Call_Alternative (Node1)
11054 2 => False, -- unused
11055 3 => False, -- unused
11056 4 => True, -- Delay_Alternative (Node4)
11057 5 => False), -- unused
11058
11059 N_Entry_Call_Alternative =>
11060 (1 => True, -- Entry_Call_Statement (Node1)
11061 2 => False, -- unused
11062 3 => True, -- Statements (List3)
11063 4 => True, -- Pragmas_Before (List4)
11064 5 => False), -- unused
11065
11066 N_Conditional_Entry_Call =>
11067 (1 => True, -- Entry_Call_Alternative (Node1)
11068 2 => False, -- unused
11069 3 => False, -- unused
11070 4 => True, -- Else_Statements (List4)
11071 5 => False), -- unused
11072
11073 N_Asynchronous_Select =>
11074 (1 => True, -- Triggering_Alternative (Node1)
11075 2 => True, -- Abortable_Part (Node2)
11076 3 => False, -- unused
11077 4 => False, -- unused
11078 5 => False), -- unused
11079
11080 N_Triggering_Alternative =>
11081 (1 => True, -- Triggering_Statement (Node1)
11082 2 => False, -- unused
11083 3 => True, -- Statements (List3)
11084 4 => True, -- Pragmas_Before (List4)
11085 5 => False), -- unused
11086
11087 N_Abortable_Part =>
11088 (1 => False, -- unused
11089 2 => False, -- unused
11090 3 => True, -- Statements (List3)
11091 4 => False, -- unused
11092 5 => False), -- unused
11093
11094 N_Abort_Statement =>
11095 (1 => False, -- unused
11096 2 => True, -- Names (List2)
11097 3 => False, -- unused
11098 4 => False, -- unused
11099 5 => False), -- unused
11100
11101 N_Compilation_Unit =>
11102 (1 => True, -- Context_Items (List1)
11103 2 => True, -- Unit (Node2)
11104 3 => False, -- First_Inlined_Subprogram (Node3-Sem)
11105 4 => False, -- Library_Unit (Node4-Sem)
11106 5 => True), -- Aux_Decls_Node (Node5)
11107
11108 N_Compilation_Unit_Aux =>
11109 (1 => True, -- Actions (List1)
11110 2 => True, -- Declarations (List2)
11111 3 => False, -- Default_Storage_Pool (Node3)
11112 4 => True, -- Config_Pragmas (List4)
11113 5 => True), -- Pragmas_After (List5)
11114
11115 N_With_Clause =>
11116 (1 => False, -- unused
11117 2 => True, -- Name (Node2)
11118 3 => False, -- unused
11119 4 => False, -- Library_Unit (Node4-Sem)
11120 5 => False), -- Corresponding_Spec (Node5-Sem)
11121
11122 N_Subprogram_Body_Stub =>
11123 (1 => True, -- Specification (Node1)
11124 2 => False, -- unused
11125 3 => False, -- unused
11126 4 => False, -- Library_Unit (Node4-Sem)
11127 5 => False), -- Corresponding_Body (Node5-Sem)
11128
11129 N_Package_Body_Stub =>
11130 (1 => True, -- Defining_Identifier (Node1)
11131 2 => False, -- unused
11132 3 => False, -- unused
11133 4 => False, -- Library_Unit (Node4-Sem)
11134 5 => False), -- Corresponding_Body (Node5-Sem)
11135
11136 N_Task_Body_Stub =>
11137 (1 => True, -- Defining_Identifier (Node1)
11138 2 => False, -- unused
11139 3 => False, -- unused
11140 4 => False, -- Library_Unit (Node4-Sem)
11141 5 => False), -- Corresponding_Body (Node5-Sem)
11142
11143 N_Protected_Body_Stub =>
11144 (1 => True, -- Defining_Identifier (Node1)
11145 2 => False, -- unused
11146 3 => False, -- unused
11147 4 => False, -- Library_Unit (Node4-Sem)
11148 5 => False), -- Corresponding_Body (Node5-Sem)
11149
11150 N_Subunit =>
11151 (1 => True, -- Proper_Body (Node1)
11152 2 => True, -- Name (Node2)
11153 3 => False, -- Corresponding_Stub (Node3-Sem)
11154 4 => False, -- unused
11155 5 => False), -- unused
11156
11157 N_Exception_Declaration =>
11158 (1 => True, -- Defining_Identifier (Node1)
11159 2 => False, -- unused
11160 3 => False, -- Expression (Node3-Sem)
11161 4 => False, -- unused
11162 5 => False), -- unused
11163
11164 N_Handled_Sequence_Of_Statements =>
11165 (1 => True, -- At_End_Proc (Node1)
11166 2 => False, -- First_Real_Statement (Node2-Sem)
11167 3 => True, -- Statements (List3)
11168 4 => True, -- End_Label (Node4)
11169 5 => True), -- Exception_Handlers (List5)
11170
11171 N_Exception_Handler =>
11172 (1 => False, -- Local_Raise_Statements (Elist1)
11173 2 => True, -- Choice_Parameter (Node2)
11174 3 => True, -- Statements (List3)
11175 4 => True, -- Exception_Choices (List4)
11176 5 => False), -- Exception_Label (Node5)
11177
11178 N_Raise_Statement =>
11179 (1 => False, -- unused
11180 2 => True, -- Name (Node2)
11181 3 => True, -- Expression (Node3)
11182 4 => False, -- unused
11183 5 => False), -- unused
11184
11185 N_Generic_Subprogram_Declaration =>
11186 (1 => True, -- Specification (Node1)
11187 2 => True, -- Generic_Formal_Declarations (List2)
11188 3 => False, -- unused
11189 4 => False, -- Parent_Spec (Node4-Sem)
11190 5 => False), -- Corresponding_Body (Node5-Sem)
11191
11192 N_Generic_Package_Declaration =>
11193 (1 => True, -- Specification (Node1)
11194 2 => True, -- Generic_Formal_Declarations (List2)
11195 3 => False, -- Activation_Chain_Entity (Node3-Sem)
11196 4 => False, -- Parent_Spec (Node4-Sem)
11197 5 => False), -- Corresponding_Body (Node5-Sem)
11198
11199 N_Package_Instantiation =>
11200 (1 => True, -- Defining_Unit_Name (Node1)
11201 2 => True, -- Name (Node2)
11202 3 => True, -- Generic_Associations (List3)
11203 4 => False, -- Parent_Spec (Node4-Sem)
11204 5 => False), -- Instance_Spec (Node5-Sem)
11205
11206 N_Procedure_Instantiation =>
11207 (1 => True, -- Defining_Unit_Name (Node1)
11208 2 => True, -- Name (Node2)
11209 3 => True, -- Generic_Associations (List3)
11210 4 => False, -- Parent_Spec (Node4-Sem)
11211 5 => False), -- Instance_Spec (Node5-Sem)
11212
11213 N_Function_Instantiation =>
11214 (1 => True, -- Defining_Unit_Name (Node1)
11215 2 => True, -- Name (Node2)
11216 3 => True, -- Generic_Associations (List3)
11217 4 => False, -- Parent_Spec (Node4-Sem)
11218 5 => False), -- Instance_Spec (Node5-Sem)
11219
11220 N_Generic_Association =>
11221 (1 => True, -- Explicit_Generic_Actual_Parameter (Node1)
11222 2 => True, -- Selector_Name (Node2)
11223 3 => False, -- unused
11224 4 => False, -- unused
11225 5 => False), -- unused
11226
11227 N_Formal_Object_Declaration =>
11228 (1 => True, -- Defining_Identifier (Node1)
11229 2 => False, -- unused
11230 3 => True, -- Access_Definition (Node3)
11231 4 => True, -- Subtype_Mark (Node4)
11232 5 => True), -- Default_Expression (Node5)
11233
11234 N_Formal_Type_Declaration =>
11235 (1 => True, -- Defining_Identifier (Node1)
11236 2 => False, -- unused
11237 3 => True, -- Formal_Type_Definition (Node3)
11238 4 => True, -- Discriminant_Specifications (List4)
11239 5 => False), -- unused
11240
11241 N_Formal_Private_Type_Definition =>
11242 (1 => False, -- unused
11243 2 => False, -- unused
11244 3 => False, -- unused
11245 4 => False, -- unused
11246 5 => False), -- unused
11247
11248 N_Formal_Derived_Type_Definition =>
11249 (1 => False, -- unused
11250 2 => True, -- Interface_List (List2)
11251 3 => False, -- unused
11252 4 => True, -- Subtype_Mark (Node4)
11253 5 => False), -- unused
11254
11255 N_Formal_Discrete_Type_Definition =>
11256 (1 => False, -- unused
11257 2 => False, -- unused
11258 3 => False, -- unused
11259 4 => False, -- unused
11260 5 => False), -- unused
11261
11262 N_Formal_Signed_Integer_Type_Definition =>
11263 (1 => False, -- unused
11264 2 => False, -- unused
11265 3 => False, -- unused
11266 4 => False, -- unused
11267 5 => False), -- unused
11268
11269 N_Formal_Modular_Type_Definition =>
11270 (1 => False, -- unused
11271 2 => False, -- unused
11272 3 => False, -- unused
11273 4 => False, -- unused
11274 5 => False), -- unused
11275
11276 N_Formal_Floating_Point_Definition =>
11277 (1 => False, -- unused
11278 2 => False, -- unused
11279 3 => False, -- unused
11280 4 => False, -- unused
11281 5 => False), -- unused
11282
11283 N_Formal_Ordinary_Fixed_Point_Definition =>
11284 (1 => False, -- unused
11285 2 => False, -- unused
11286 3 => False, -- unused
11287 4 => False, -- unused
11288 5 => False), -- unused
11289
11290 N_Formal_Decimal_Fixed_Point_Definition =>
11291 (1 => False, -- unused
11292 2 => False, -- unused
11293 3 => False, -- unused
11294 4 => False, -- unused
11295 5 => False), -- unused
11296
11297 N_Formal_Concrete_Subprogram_Declaration =>
11298 (1 => True, -- Specification (Node1)
11299 2 => True, -- Default_Name (Node2)
11300 3 => False, -- unused
11301 4 => False, -- unused
11302 5 => False), -- unused
11303
11304 N_Formal_Abstract_Subprogram_Declaration =>
11305 (1 => True, -- Specification (Node1)
11306 2 => True, -- Default_Name (Node2)
11307 3 => False, -- unused
11308 4 => False, -- unused
11309 5 => False), -- unused
11310
11311 N_Formal_Package_Declaration =>
11312 (1 => True, -- Defining_Identifier (Node1)
11313 2 => True, -- Name (Node2)
11314 3 => True, -- Generic_Associations (List3)
11315 4 => False, -- unused
11316 5 => False), -- Instance_Spec (Node5-Sem)
11317
11318 N_Attribute_Definition_Clause =>
11319 (1 => True, -- Chars (Name1)
11320 2 => True, -- Name (Node2)
11321 3 => True, -- Expression (Node3)
11322 4 => False, -- unused
11323 5 => False), -- Next_Rep_Item (Node5-Sem)
11324
11325 N_Aspect_Specification =>
11326 (1 => True, -- Identifier (Node1)
11327 2 => False, -- Aspect_Rep_Item (Node2-Sem)
11328 3 => True, -- Expression (Node3)
11329 4 => False, -- Entity (Node4-Sem)
11330 5 => False), -- Next_Rep_Item (Node5-Sem)
11331
11332 N_Enumeration_Representation_Clause =>
11333 (1 => True, -- Identifier (Node1)
11334 2 => False, -- unused
11335 3 => True, -- Array_Aggregate (Node3)
11336 4 => False, -- unused
11337 5 => False), -- Next_Rep_Item (Node5-Sem)
11338
11339 N_Record_Representation_Clause =>
11340 (1 => True, -- Identifier (Node1)
11341 2 => True, -- Mod_Clause (Node2)
11342 3 => True, -- Component_Clauses (List3)
11343 4 => False, -- unused
11344 5 => False), -- Next_Rep_Item (Node5-Sem)
11345
11346 N_Component_Clause =>
11347 (1 => True, -- Component_Name (Node1)
11348 2 => True, -- Position (Node2)
11349 3 => True, -- First_Bit (Node3)
11350 4 => True, -- Last_Bit (Node4)
11351 5 => False), -- unused
11352
11353 N_Code_Statement =>
11354 (1 => False, -- unused
11355 2 => False, -- unused
11356 3 => True, -- Expression (Node3)
11357 4 => False, -- unused
11358 5 => False), -- unused
11359
11360 N_Op_Rotate_Left =>
11361 (1 => True, -- Chars (Name1)
11362 2 => True, -- Left_Opnd (Node2)
11363 3 => True, -- Right_Opnd (Node3)
11364 4 => False, -- Entity (Node4-Sem)
11365 5 => False), -- Etype (Node5-Sem)
11366
11367 N_Op_Rotate_Right =>
11368 (1 => True, -- Chars (Name1)
11369 2 => True, -- Left_Opnd (Node2)
11370 3 => True, -- Right_Opnd (Node3)
11371 4 => False, -- Entity (Node4-Sem)
11372 5 => False), -- Etype (Node5-Sem)
11373
11374 N_Op_Shift_Left =>
11375 (1 => True, -- Chars (Name1)
11376 2 => True, -- Left_Opnd (Node2)
11377 3 => True, -- Right_Opnd (Node3)
11378 4 => False, -- Entity (Node4-Sem)
11379 5 => False), -- Etype (Node5-Sem)
11380
11381 N_Op_Shift_Right_Arithmetic =>
11382 (1 => True, -- Chars (Name1)
11383 2 => True, -- Left_Opnd (Node2)
11384 3 => True, -- Right_Opnd (Node3)
11385 4 => False, -- Entity (Node4-Sem)
11386 5 => False), -- Etype (Node5-Sem)
11387
11388 N_Op_Shift_Right =>
11389 (1 => True, -- Chars (Name1)
11390 2 => True, -- Left_Opnd (Node2)
11391 3 => True, -- Right_Opnd (Node3)
11392 4 => False, -- Entity (Node4-Sem)
11393 5 => False), -- Etype (Node5-Sem)
11394
11395 N_Delta_Constraint =>
11396 (1 => False, -- unused
11397 2 => False, -- unused
11398 3 => True, -- Delta_Expression (Node3)
11399 4 => True, -- Range_Constraint (Node4)
11400 5 => False), -- unused
11401
11402 N_At_Clause =>
11403 (1 => True, -- Identifier (Node1)
11404 2 => False, -- unused
11405 3 => True, -- Expression (Node3)
11406 4 => False, -- unused
11407 5 => False), -- unused
11408
11409 N_Mod_Clause =>
11410 (1 => False, -- unused
11411 2 => False, -- unused
11412 3 => True, -- Expression (Node3)
11413 4 => True, -- Pragmas_Before (List4)
11414 5 => False), -- unused
11415
11416 N_Conditional_Expression =>
11417 (1 => True, -- Expressions (List1)
11418 2 => False, -- Then_Actions (List2-Sem)
11419 3 => False, -- Else_Actions (List3-Sem)
11420 4 => False, -- unused
11421 5 => False), -- Etype (Node5-Sem)
11422
11423 N_Expanded_Name =>
11424 (1 => True, -- Chars (Name1)
11425 2 => True, -- Selector_Name (Node2)
11426 3 => True, -- Prefix (Node3)
11427 4 => False, -- Entity (Node4-Sem)
11428 5 => False), -- Etype (Node5-Sem)
11429
11430 N_Expression_With_Actions =>
11431 (1 => True, -- Actions (List1)
11432 2 => False, -- unused
11433 3 => True, -- Expression (Node3)
11434 4 => False, -- unused
11435 5 => False), -- unused
11436
11437 N_Free_Statement =>
11438 (1 => False, -- Storage_Pool (Node1-Sem)
11439 2 => False, -- Procedure_To_Call (Node2-Sem)
11440 3 => True, -- Expression (Node3)
11441 4 => False, -- Actual_Designated_Subtype (Node4-Sem)
11442 5 => False), -- unused
11443
11444 N_Freeze_Entity =>
11445 (1 => True, -- Actions (List1)
11446 2 => False, -- Access_Types_To_Process (Elist2-Sem)
11447 3 => False, -- TSS_Elist (Elist3-Sem)
11448 4 => False, -- Entity (Node4-Sem)
11449 5 => False), -- First_Subtype_Link (Node5-Sem)
11450
11451 N_Implicit_Label_Declaration =>
11452 (1 => True, -- Defining_Identifier (Node1)
11453 2 => False, -- Label_Construct (Node2-Sem)
11454 3 => False, -- unused
11455 4 => False, -- unused
11456 5 => False), -- unused
11457
11458 N_Itype_Reference =>
11459 (1 => False, -- Itype (Node1-Sem)
11460 2 => False, -- unused
11461 3 => False, -- unused
11462 4 => False, -- unused
11463 5 => False), -- unused
11464
11465 N_Raise_Constraint_Error =>
11466 (1 => True, -- Condition (Node1)
11467 2 => False, -- unused
11468 3 => True, -- Reason (Uint3)
11469 4 => False, -- unused
11470 5 => False), -- Etype (Node5-Sem)
11471
11472 N_Raise_Program_Error =>
11473 (1 => True, -- Condition (Node1)
11474 2 => False, -- unused
11475 3 => True, -- Reason (Uint3)
11476 4 => False, -- unused
11477 5 => False), -- Etype (Node5-Sem)
11478
11479 N_Raise_Storage_Error =>
11480 (1 => True, -- Condition (Node1)
11481 2 => False, -- unused
11482 3 => True, -- Reason (Uint3)
11483 4 => False, -- unused
11484 5 => False), -- Etype (Node5-Sem)
11485
11486 N_Push_Constraint_Error_Label =>
11487 (1 => False, -- unused
11488 2 => False, -- unused
11489 3 => False, -- unused
11490 4 => False, -- unused
11491 5 => False), -- unused
11492
11493 N_Push_Program_Error_Label =>
11494 (1 => False, -- Exception_Label
11495 2 => False, -- unused
11496 3 => False, -- unused
11497 4 => False, -- unused
11498 5 => False), -- Exception_Label
11499
11500 N_Push_Storage_Error_Label =>
11501 (1 => False, -- Exception_Label
11502 2 => False, -- unused
11503 3 => False, -- unused
11504 4 => False, -- unused
11505 5 => False), -- Exception_Label
11506
11507 N_Pop_Constraint_Error_Label =>
11508 (1 => False, -- unused
11509 2 => False, -- unused
11510 3 => False, -- unused
11511 4 => False, -- unused
11512 5 => False), -- unused
11513
11514 N_Pop_Program_Error_Label =>
11515 (1 => False, -- unused
11516 2 => False, -- unused
11517 3 => False, -- unused
11518 4 => False, -- unused
11519 5 => False), -- unused
11520
11521 N_Pop_Storage_Error_Label =>
11522 (1 => False, -- unused
11523 2 => False, -- unused
11524 3 => False, -- unused
11525 4 => False, -- unused
11526 5 => False), -- unused
11527
11528 N_Reference =>
11529 (1 => False, -- unused
11530 2 => False, -- unused
11531 3 => True, -- Prefix (Node3)
11532 4 => False, -- unused
11533 5 => False), -- Etype (Node5-Sem)
11534
11535 N_Subprogram_Info =>
11536 (1 => True, -- Identifier (Node1)
11537 2 => False, -- unused
11538 3 => False, -- unused
11539 4 => False, -- unused
11540 5 => False), -- Etype (Node5-Sem)
11541
11542 N_Unchecked_Expression =>
11543 (1 => False, -- unused
11544 2 => False, -- unused
11545 3 => True, -- Expression (Node3)
11546 4 => False, -- unused
11547 5 => False), -- Etype (Node5-Sem)
11548
11549 N_Unchecked_Type_Conversion =>
11550 (1 => False, -- unused
11551 2 => False, -- unused
11552 3 => True, -- Expression (Node3)
11553 4 => True, -- Subtype_Mark (Node4)
11554 5 => False), -- Etype (Node5-Sem)
11555
11556 N_Validate_Unchecked_Conversion =>
11557 (1 => False, -- Source_Type (Node1-Sem)
11558 2 => False, -- Target_Type (Node2-Sem)
11559 3 => False, -- unused
11560 4 => False, -- unused
11561 5 => False), -- unused
11562
11563 -- Entries for SCIL nodes
11564
11565 N_SCIL_Dispatch_Table_Tag_Init =>
11566 (1 => False, -- unused
11567 2 => False, -- unused
11568 3 => False, -- unused
11569 4 => False, -- SCIL_Entity (Node4-Sem)
11570 5 => False), -- unused
11571
11572 N_SCIL_Dispatching_Call =>
11573 (1 => False, -- unused
11574 2 => False, -- SCIL_Target_Prim (Node2-Sem)
11575 3 => False, -- unused
11576 4 => False, -- SCIL_Entity (Node4-Sem)
11577 5 => False), -- SCIL_Controlling_Tag (Node5-Sem)
11578
11579 N_SCIL_Membership_Test =>
11580 (1 => False, -- unused
11581 2 => False, -- unused
11582 3 => False, -- unused
11583 4 => False, -- SCIL_Entity (Node4-Sem)
11584 5 => False), -- SCIL_Tag_Value (Node5-Sem)
11585
11586 -- Entries for Empty, Error and Unused. Even thought these have a Chars
11587 -- field for debugging purposes, they are not really syntactic fields, so
11588 -- we mark all fields as unused.
11589
11590 N_Empty =>
11591 (1 => False, -- unused
11592 2 => False, -- unused
11593 3 => False, -- unused
11594 4 => False, -- unused
11595 5 => False), -- unused
11596
11597 N_Error =>
11598 (1 => False, -- unused
11599 2 => False, -- unused
11600 3 => False, -- unused
11601 4 => False, -- unused
11602 5 => False), -- unused
11603
11604 N_Unused_At_Start =>
11605 (1 => False, -- unused
11606 2 => False, -- unused
11607 3 => False, -- unused
11608 4 => False, -- unused
11609 5 => False), -- unused
11610
11611 N_Unused_At_End =>
11612 (1 => False, -- unused
11613 2 => False, -- unused
11614 3 => False, -- unused
11615 4 => False, -- unused
11616 5 => False)); -- unused
11617
11618 --------------------
11619 -- Inline Pragmas --
11620 --------------------
11621
11622 pragma Inline (ABE_Is_Certain);
11623 pragma Inline (Abort_Present);
11624 pragma Inline (Abortable_Part);
11625 pragma Inline (Abstract_Present);
11626 pragma Inline (Accept_Handler_Records);
11627 pragma Inline (Accept_Statement);
11628 pragma Inline (Access_Definition);
11629 pragma Inline (Access_To_Subprogram_Definition);
11630 pragma Inline (Access_Types_To_Process);
11631 pragma Inline (Actions);
11632 pragma Inline (Activation_Chain_Entity);
11633 pragma Inline (Acts_As_Spec);
11634 pragma Inline (Actual_Designated_Subtype);
11635 pragma Inline (Address_Warning_Posted);
11636 pragma Inline (Aggregate_Bounds);
11637 pragma Inline (Aliased_Present);
11638 pragma Inline (All_Others);
11639 pragma Inline (All_Present);
11640 pragma Inline (Alternatives);
11641 pragma Inline (Ancestor_Part);
11642 pragma Inline (Array_Aggregate);
11643 pragma Inline (Aspect_Cancel);
11644 pragma Inline (Aspect_Rep_Item);
11645 pragma Inline (Assignment_OK);
11646 pragma Inline (Associated_Node);
11647 pragma Inline (At_End_Proc);
11648 pragma Inline (Attribute_Name);
11649 pragma Inline (Aux_Decls_Node);
11650 pragma Inline (Backwards_OK);
11651 pragma Inline (Bad_Is_Detected);
11652 pragma Inline (Body_To_Inline);
11653 pragma Inline (Body_Required);
11654 pragma Inline (By_Ref);
11655 pragma Inline (Box_Present);
11656 pragma Inline (Char_Literal_Value);
11657 pragma Inline (Chars);
11658 pragma Inline (Check_Address_Alignment);
11659 pragma Inline (Choice_Parameter);
11660 pragma Inline (Choices);
11661 pragma Inline (Class_Present);
11662 pragma Inline (Coextensions);
11663 pragma Inline (Comes_From_Extended_Return_Statement);
11664 pragma Inline (Compile_Time_Known_Aggregate);
11665 pragma Inline (Component_Associations);
11666 pragma Inline (Component_Clauses);
11667 pragma Inline (Component_Definition);
11668 pragma Inline (Component_Items);
11669 pragma Inline (Component_List);
11670 pragma Inline (Component_Name);
11671 pragma Inline (Componentwise_Assignment);
11672 pragma Inline (Condition);
11673 pragma Inline (Condition_Actions);
11674 pragma Inline (Config_Pragmas);
11675 pragma Inline (Constant_Present);
11676 pragma Inline (Constraint);
11677 pragma Inline (Constraints);
11678 pragma Inline (Context_Installed);
11679 pragma Inline (Context_Items);
11680 pragma Inline (Context_Pending);
11681 pragma Inline (Controlling_Argument);
11682 pragma Inline (Conversion_OK);
11683 pragma Inline (Corresponding_Body);
11684 pragma Inline (Corresponding_Formal_Spec);
11685 pragma Inline (Corresponding_Generic_Association);
11686 pragma Inline (Corresponding_Integer_Value);
11687 pragma Inline (Corresponding_Spec);
11688 pragma Inline (Corresponding_Stub);
11689 pragma Inline (Dcheck_Function);
11690 pragma Inline (Debug_Statement);
11691 pragma Inline (Declarations);
11692 pragma Inline (Default_Expression);
11693 pragma Inline (Default_Storage_Pool);
11694 pragma Inline (Default_Name);
11695 pragma Inline (Defining_Identifier);
11696 pragma Inline (Defining_Unit_Name);
11697 pragma Inline (Delay_Alternative);
11698 pragma Inline (Delay_Statement);
11699 pragma Inline (Delta_Expression);
11700 pragma Inline (Digits_Expression);
11701 pragma Inline (Discr_Check_Funcs_Built);
11702 pragma Inline (Discrete_Choices);
11703 pragma Inline (Discrete_Range);
11704 pragma Inline (Discrete_Subtype_Definition);
11705 pragma Inline (Discrete_Subtype_Definitions);
11706 pragma Inline (Discriminant_Specifications);
11707 pragma Inline (Discriminant_Type);
11708 pragma Inline (Do_Accessibility_Check);
11709 pragma Inline (Do_Discriminant_Check);
11710 pragma Inline (Do_Length_Check);
11711 pragma Inline (Do_Division_Check);
11712 pragma Inline (Do_Overflow_Check);
11713 pragma Inline (Do_Range_Check);
11714 pragma Inline (Do_Storage_Check);
11715 pragma Inline (Do_Tag_Check);
11716 pragma Inline (Elaborate_Present);
11717 pragma Inline (Elaborate_All_Desirable);
11718 pragma Inline (Elaborate_All_Present);
11719 pragma Inline (Elaborate_Desirable);
11720 pragma Inline (Elaboration_Boolean);
11721 pragma Inline (Else_Actions);
11722 pragma Inline (Else_Statements);
11723 pragma Inline (Elsif_Parts);
11724 pragma Inline (Enclosing_Variant);
11725 pragma Inline (End_Label);
11726 pragma Inline (End_Span);
11727 pragma Inline (Entity);
11728 pragma Inline (Entity_Or_Associated_Node);
11729 pragma Inline (Entry_Body_Formal_Part);
11730 pragma Inline (Entry_Call_Alternative);
11731 pragma Inline (Entry_Call_Statement);
11732 pragma Inline (Entry_Direct_Name);
11733 pragma Inline (Entry_Index);
11734 pragma Inline (Entry_Index_Specification);
11735 pragma Inline (Etype);
11736 pragma Inline (Exception_Choices);
11737 pragma Inline (Exception_Handlers);
11738 pragma Inline (Exception_Junk);
11739 pragma Inline (Exception_Label);
11740 pragma Inline (Expansion_Delayed);
11741 pragma Inline (Explicit_Actual_Parameter);
11742 pragma Inline (Explicit_Generic_Actual_Parameter);
11743 pragma Inline (Expression);
11744 pragma Inline (Expressions);
11745 pragma Inline (First_Bit);
11746 pragma Inline (First_Inlined_Subprogram);
11747 pragma Inline (First_Name);
11748 pragma Inline (First_Named_Actual);
11749 pragma Inline (First_Real_Statement);
11750 pragma Inline (First_Subtype_Link);
11751 pragma Inline (Float_Truncate);
11752 pragma Inline (Formal_Type_Definition);
11753 pragma Inline (Forwards_OK);
11754 pragma Inline (From_Aspect_Specification);
11755 pragma Inline (From_At_End);
11756 pragma Inline (From_At_Mod);
11757 pragma Inline (From_Default);
11758 pragma Inline (Generic_Associations);
11759 pragma Inline (Generic_Formal_Declarations);
11760 pragma Inline (Generic_Parent);
11761 pragma Inline (Generic_Parent_Type);
11762 pragma Inline (Handled_Statement_Sequence);
11763 pragma Inline (Handler_List_Entry);
11764 pragma Inline (Has_Created_Identifier);
11765 pragma Inline (Has_Dynamic_Length_Check);
11766 pragma Inline (Has_Dynamic_Range_Check);
11767 pragma Inline (Has_Init_Expression);
11768 pragma Inline (Has_Local_Raise);
11769 pragma Inline (Has_Self_Reference);
11770 pragma Inline (Has_No_Elaboration_Code);
11771 pragma Inline (Has_Pragma_CPU);
11772 pragma Inline (Has_Pragma_Priority);
11773 pragma Inline (Has_Pragma_Suppress_All);
11774 pragma Inline (Has_Private_View);
11775 pragma Inline (Has_Relative_Deadline_Pragma);
11776 pragma Inline (Has_Storage_Size_Pragma);
11777 pragma Inline (Has_Task_Info_Pragma);
11778 pragma Inline (Has_Task_Name_Pragma);
11779 pragma Inline (Has_Wide_Character);
11780 pragma Inline (Has_Wide_Wide_Character);
11781 pragma Inline (Hidden_By_Use_Clause);
11782 pragma Inline (High_Bound);
11783 pragma Inline (Identifier);
11784 pragma Inline (Implicit_With);
11785 pragma Inline (Interface_List);
11786 pragma Inline (Interface_Present);
11787 pragma Inline (Includes_Infinities);
11788 pragma Inline (Import_Interface_Present);
11789 pragma Inline (In_Present);
11790 pragma Inline (Inherited_Discriminant);
11791 pragma Inline (Instance_Spec);
11792 pragma Inline (Intval);
11793 pragma Inline (Iterator_Specification);
11794 pragma Inline (Is_Accessibility_Actual);
11795 pragma Inline (Is_Asynchronous_Call_Block);
11796 pragma Inline (Is_Component_Left_Opnd);
11797 pragma Inline (Is_Component_Right_Opnd);
11798 pragma Inline (Is_Controlling_Actual);
11799 pragma Inline (Is_Delayed_Aspect);
11800 pragma Inline (Is_Dynamic_Coextension);
11801 pragma Inline (Is_Elsif);
11802 pragma Inline (Is_Entry_Barrier_Function);
11803 pragma Inline (Is_Expanded_Build_In_Place_Call);
11804 pragma Inline (Is_Folded_In_Parser);
11805 pragma Inline (Is_In_Discriminant_Check);
11806 pragma Inline (Is_Machine_Number);
11807 pragma Inline (Is_Null_Loop);
11808 pragma Inline (Is_Overloaded);
11809 pragma Inline (Is_Power_Of_2_For_Shift);
11810 pragma Inline (Is_Protected_Subprogram_Body);
11811 pragma Inline (Is_Static_Coextension);
11812 pragma Inline (Is_Static_Expression);
11813 pragma Inline (Is_Subprogram_Descriptor);
11814 pragma Inline (Is_Task_Allocation_Block);
11815 pragma Inline (Is_Task_Master);
11816 pragma Inline (Iteration_Scheme);
11817 pragma Inline (Itype);
11818 pragma Inline (Kill_Range_Check);
11819 pragma Inline (Last_Bit);
11820 pragma Inline (Last_Name);
11821 pragma Inline (Library_Unit);
11822 pragma Inline (Label_Construct);
11823 pragma Inline (Left_Opnd);
11824 pragma Inline (Limited_View_Installed);
11825 pragma Inline (Limited_Present);
11826 pragma Inline (Literals);
11827 pragma Inline (Local_Raise_Not_OK);
11828 pragma Inline (Local_Raise_Statements);
11829 pragma Inline (Loop_Actions);
11830 pragma Inline (Loop_Parameter_Specification);
11831 pragma Inline (Low_Bound);
11832 pragma Inline (Mod_Clause);
11833 pragma Inline (More_Ids);
11834 pragma Inline (Must_Be_Byte_Aligned);
11835 pragma Inline (Must_Not_Freeze);
11836 pragma Inline (Must_Not_Override);
11837 pragma Inline (Must_Override);
11838 pragma Inline (Name);
11839 pragma Inline (Names);
11840 pragma Inline (Next_Entity);
11841 pragma Inline (Next_Exit_Statement);
11842 pragma Inline (Next_Implicit_With);
11843 pragma Inline (Next_Named_Actual);
11844 pragma Inline (Next_Pragma);
11845 pragma Inline (Next_Rep_Item);
11846 pragma Inline (Next_Use_Clause);
11847 pragma Inline (No_Ctrl_Actions);
11848 pragma Inline (No_Elaboration_Check);
11849 pragma Inline (No_Entities_Ref_In_Spec);
11850 pragma Inline (No_Initialization);
11851 pragma Inline (No_Truncation);
11852 pragma Inline (Null_Present);
11853 pragma Inline (Null_Exclusion_Present);
11854 pragma Inline (Null_Exclusion_In_Return_Present);
11855 pragma Inline (Null_Record_Present);
11856 pragma Inline (Object_Definition);
11857 pragma Inline (Of_Present);
11858 pragma Inline (Original_Discriminant);
11859 pragma Inline (Original_Entity);
11860 pragma Inline (Others_Discrete_Choices);
11861 pragma Inline (Out_Present);
11862 pragma Inline (Parameter_Associations);
11863 pragma Inline (Parameter_Specifications);
11864 pragma Inline (Parameter_List_Truncated);
11865 pragma Inline (Parameter_Type);
11866 pragma Inline (Parent_Spec);
11867 pragma Inline (Position);
11868 pragma Inline (Pragma_Argument_Associations);
11869 pragma Inline (Pragma_Enabled);
11870 pragma Inline (Pragma_Identifier);
11871 pragma Inline (Pragmas_After);
11872 pragma Inline (Pragmas_Before);
11873 pragma Inline (Prefix);
11874 pragma Inline (Present_Expr);
11875 pragma Inline (Prev_Ids);
11876 pragma Inline (Print_In_Hex);
11877 pragma Inline (Private_Declarations);
11878 pragma Inline (Private_Present);
11879 pragma Inline (Procedure_To_Call);
11880 pragma Inline (Proper_Body);
11881 pragma Inline (Protected_Definition);
11882 pragma Inline (Protected_Present);
11883 pragma Inline (Raises_Constraint_Error);
11884 pragma Inline (Range_Constraint);
11885 pragma Inline (Range_Expression);
11886 pragma Inline (Real_Range_Specification);
11887 pragma Inline (Realval);
11888 pragma Inline (Reason);
11889 pragma Inline (Record_Extension_Part);
11890 pragma Inline (Redundant_Use);
11891 pragma Inline (Renaming_Exception);
11892 pragma Inline (Result_Definition);
11893 pragma Inline (Return_Object_Declarations);
11894 pragma Inline (Return_Statement_Entity);
11895 pragma Inline (Reverse_Present);
11896 pragma Inline (Right_Opnd);
11897 pragma Inline (Rounded_Result);
11898 pragma Inline (SCIL_Controlling_Tag);
11899 pragma Inline (SCIL_Entity);
11900 pragma Inline (SCIL_Tag_Value);
11901 pragma Inline (SCIL_Target_Prim);
11902 pragma Inline (Scope);
11903 pragma Inline (Select_Alternatives);
11904 pragma Inline (Selector_Name);
11905 pragma Inline (Selector_Names);
11906 pragma Inline (Shift_Count_OK);
11907 pragma Inline (Source_Type);
11908 pragma Inline (Specification);
11909 pragma Inline (Split_PPC);
11910 pragma Inline (Statements);
11911 pragma Inline (Static_Processing_OK);
11912 pragma Inline (Storage_Pool);
11913 pragma Inline (Strval);
11914 pragma Inline (Subtype_Indication);
11915 pragma Inline (Subtype_Mark);
11916 pragma Inline (Subtype_Marks);
11917 pragma Inline (Suppress_Assignment_Checks);
11918 pragma Inline (Suppress_Loop_Warnings);
11919 pragma Inline (Synchronized_Present);
11920 pragma Inline (Tagged_Present);
11921 pragma Inline (Target_Type);
11922 pragma Inline (Task_Definition);
11923 pragma Inline (Task_Present);
11924 pragma Inline (Then_Actions);
11925 pragma Inline (Then_Statements);
11926 pragma Inline (Triggering_Alternative);
11927 pragma Inline (Triggering_Statement);
11928 pragma Inline (Treat_Fixed_As_Integer);
11929 pragma Inline (TSS_Elist);
11930 pragma Inline (Type_Definition);
11931 pragma Inline (Unit);
11932 pragma Inline (Unknown_Discriminants_Present);
11933 pragma Inline (Unreferenced_In_Spec);
11934 pragma Inline (Variant_Part);
11935 pragma Inline (Variants);
11936 pragma Inline (Visible_Declarations);
11937 pragma Inline (Was_Originally_Stub);
11938 pragma Inline (Withed_Body);
11939 pragma Inline (Zero_Cost_Handling);
11940
11941 pragma Inline (Set_ABE_Is_Certain);
11942 pragma Inline (Set_Abort_Present);
11943 pragma Inline (Set_Abortable_Part);
11944 pragma Inline (Set_Abstract_Present);
11945 pragma Inline (Set_Accept_Handler_Records);
11946 pragma Inline (Set_Accept_Statement);
11947 pragma Inline (Set_Access_Definition);
11948 pragma Inline (Set_Access_To_Subprogram_Definition);
11949 pragma Inline (Set_Access_Types_To_Process);
11950 pragma Inline (Set_Actions);
11951 pragma Inline (Set_Activation_Chain_Entity);
11952 pragma Inline (Set_Acts_As_Spec);
11953 pragma Inline (Set_Actual_Designated_Subtype);
11954 pragma Inline (Set_Address_Warning_Posted);
11955 pragma Inline (Set_Aggregate_Bounds);
11956 pragma Inline (Set_Aliased_Present);
11957 pragma Inline (Set_All_Others);
11958 pragma Inline (Set_All_Present);
11959 pragma Inline (Set_Alternatives);
11960 pragma Inline (Set_Ancestor_Part);
11961 pragma Inline (Set_Array_Aggregate);
11962 pragma Inline (Set_Aspect_Cancel);
11963 pragma Inline (Set_Aspect_Rep_Item);
11964 pragma Inline (Set_Assignment_OK);
11965 pragma Inline (Set_Associated_Node);
11966 pragma Inline (Set_At_End_Proc);
11967 pragma Inline (Set_Attribute_Name);
11968 pragma Inline (Set_Aux_Decls_Node);
11969 pragma Inline (Set_Backwards_OK);
11970 pragma Inline (Set_Bad_Is_Detected);
11971 pragma Inline (Set_Body_To_Inline);
11972 pragma Inline (Set_Body_Required);
11973 pragma Inline (Set_By_Ref);
11974 pragma Inline (Set_Box_Present);
11975 pragma Inline (Set_Char_Literal_Value);
11976 pragma Inline (Set_Chars);
11977 pragma Inline (Set_Check_Address_Alignment);
11978 pragma Inline (Set_Choice_Parameter);
11979 pragma Inline (Set_Choices);
11980 pragma Inline (Set_Class_Present);
11981 pragma Inline (Set_Coextensions);
11982 pragma Inline (Set_Comes_From_Extended_Return_Statement);
11983 pragma Inline (Set_Compile_Time_Known_Aggregate);
11984 pragma Inline (Set_Component_Associations);
11985 pragma Inline (Set_Component_Clauses);
11986 pragma Inline (Set_Component_Definition);
11987 pragma Inline (Set_Component_Items);
11988 pragma Inline (Set_Component_List);
11989 pragma Inline (Set_Component_Name);
11990 pragma Inline (Set_Componentwise_Assignment);
11991 pragma Inline (Set_Condition);
11992 pragma Inline (Set_Condition_Actions);
11993 pragma Inline (Set_Config_Pragmas);
11994 pragma Inline (Set_Constant_Present);
11995 pragma Inline (Set_Constraint);
11996 pragma Inline (Set_Constraints);
11997 pragma Inline (Set_Context_Installed);
11998 pragma Inline (Set_Context_Items);
11999 pragma Inline (Set_Context_Pending);
12000 pragma Inline (Set_Controlling_Argument);
12001 pragma Inline (Set_Conversion_OK);
12002 pragma Inline (Set_Corresponding_Body);
12003 pragma Inline (Set_Corresponding_Formal_Spec);
12004 pragma Inline (Set_Corresponding_Generic_Association);
12005 pragma Inline (Set_Corresponding_Integer_Value);
12006 pragma Inline (Set_Corresponding_Spec);
12007 pragma Inline (Set_Corresponding_Stub);
12008 pragma Inline (Set_Dcheck_Function);
12009 pragma Inline (Set_Debug_Statement);
12010 pragma Inline (Set_Declarations);
12011 pragma Inline (Set_Default_Expression);
12012 pragma Inline (Set_Default_Storage_Pool);
12013 pragma Inline (Set_Default_Name);
12014 pragma Inline (Set_Defining_Identifier);
12015 pragma Inline (Set_Defining_Unit_Name);
12016 pragma Inline (Set_Delay_Alternative);
12017 pragma Inline (Set_Delay_Statement);
12018 pragma Inline (Set_Delta_Expression);
12019 pragma Inline (Set_Digits_Expression);
12020 pragma Inline (Set_Discr_Check_Funcs_Built);
12021 pragma Inline (Set_Discrete_Choices);
12022 pragma Inline (Set_Discrete_Range);
12023 pragma Inline (Set_Discrete_Subtype_Definition);
12024 pragma Inline (Set_Discrete_Subtype_Definitions);
12025 pragma Inline (Set_Discriminant_Specifications);
12026 pragma Inline (Set_Discriminant_Type);
12027 pragma Inline (Set_Do_Accessibility_Check);
12028 pragma Inline (Set_Do_Discriminant_Check);
12029 pragma Inline (Set_Do_Length_Check);
12030 pragma Inline (Set_Do_Division_Check);
12031 pragma Inline (Set_Do_Overflow_Check);
12032 pragma Inline (Set_Do_Range_Check);
12033 pragma Inline (Set_Do_Storage_Check);
12034 pragma Inline (Set_Do_Tag_Check);
12035 pragma Inline (Set_Elaborate_Present);
12036 pragma Inline (Set_Elaborate_All_Desirable);
12037 pragma Inline (Set_Elaborate_All_Present);
12038 pragma Inline (Set_Elaborate_Desirable);
12039 pragma Inline (Set_Elaboration_Boolean);
12040 pragma Inline (Set_Else_Actions);
12041 pragma Inline (Set_Else_Statements);
12042 pragma Inline (Set_Elsif_Parts);
12043 pragma Inline (Set_Enclosing_Variant);
12044 pragma Inline (Set_End_Label);
12045 pragma Inline (Set_End_Span);
12046 pragma Inline (Set_Entity);
12047 pragma Inline (Set_Entry_Body_Formal_Part);
12048 pragma Inline (Set_Entry_Call_Alternative);
12049 pragma Inline (Set_Entry_Call_Statement);
12050 pragma Inline (Set_Entry_Direct_Name);
12051 pragma Inline (Set_Entry_Index);
12052 pragma Inline (Set_Entry_Index_Specification);
12053 pragma Inline (Set_Etype);
12054 pragma Inline (Set_Exception_Choices);
12055 pragma Inline (Set_Exception_Handlers);
12056 pragma Inline (Set_Exception_Junk);
12057 pragma Inline (Set_Exception_Label);
12058 pragma Inline (Set_Expansion_Delayed);
12059 pragma Inline (Set_Explicit_Actual_Parameter);
12060 pragma Inline (Set_Explicit_Generic_Actual_Parameter);
12061 pragma Inline (Set_Expression);
12062 pragma Inline (Set_Expressions);
12063 pragma Inline (Set_First_Bit);
12064 pragma Inline (Set_First_Inlined_Subprogram);
12065 pragma Inline (Set_First_Name);
12066 pragma Inline (Set_First_Named_Actual);
12067 pragma Inline (Set_First_Real_Statement);
12068 pragma Inline (Set_First_Subtype_Link);
12069 pragma Inline (Set_Float_Truncate);
12070 pragma Inline (Set_Formal_Type_Definition);
12071 pragma Inline (Set_Forwards_OK);
12072 pragma Inline (Set_From_Aspect_Specification);
12073 pragma Inline (Set_From_At_End);
12074 pragma Inline (Set_From_At_Mod);
12075 pragma Inline (Set_From_Default);
12076 pragma Inline (Set_Generic_Associations);
12077 pragma Inline (Set_Generic_Formal_Declarations);
12078 pragma Inline (Set_Generic_Parent);
12079 pragma Inline (Set_Generic_Parent_Type);
12080 pragma Inline (Set_Handled_Statement_Sequence);
12081 pragma Inline (Set_Handler_List_Entry);
12082 pragma Inline (Set_Has_Created_Identifier);
12083 pragma Inline (Set_Has_Dynamic_Length_Check);
12084 pragma Inline (Set_Has_Init_Expression);
12085 pragma Inline (Set_Has_Local_Raise);
12086 pragma Inline (Set_Has_Dynamic_Range_Check);
12087 pragma Inline (Set_Has_No_Elaboration_Code);
12088 pragma Inline (Set_Has_Pragma_CPU);
12089 pragma Inline (Set_Has_Pragma_Priority);
12090 pragma Inline (Set_Has_Pragma_Suppress_All);
12091 pragma Inline (Set_Has_Private_View);
12092 pragma Inline (Set_Has_Relative_Deadline_Pragma);
12093 pragma Inline (Set_Has_Storage_Size_Pragma);
12094 pragma Inline (Set_Has_Task_Info_Pragma);
12095 pragma Inline (Set_Has_Task_Name_Pragma);
12096 pragma Inline (Set_Has_Wide_Character);
12097 pragma Inline (Set_Has_Wide_Wide_Character);
12098 pragma Inline (Set_Hidden_By_Use_Clause);
12099 pragma Inline (Set_High_Bound);
12100 pragma Inline (Set_Identifier);
12101 pragma Inline (Set_Implicit_With);
12102 pragma Inline (Set_Includes_Infinities);
12103 pragma Inline (Set_Interface_List);
12104 pragma Inline (Set_Interface_Present);
12105 pragma Inline (Set_Import_Interface_Present);
12106 pragma Inline (Set_In_Present);
12107 pragma Inline (Set_Inherited_Discriminant);
12108 pragma Inline (Set_Instance_Spec);
12109 pragma Inline (Set_Intval);
12110 pragma Inline (Set_Iterator_Specification);
12111 pragma Inline (Set_Is_Accessibility_Actual);
12112 pragma Inline (Set_Is_Asynchronous_Call_Block);
12113 pragma Inline (Set_Is_Component_Left_Opnd);
12114 pragma Inline (Set_Is_Component_Right_Opnd);
12115 pragma Inline (Set_Is_Controlling_Actual);
12116 pragma Inline (Set_Is_Delayed_Aspect);
12117 pragma Inline (Set_Is_Dynamic_Coextension);
12118 pragma Inline (Set_Is_Elsif);
12119 pragma Inline (Set_Is_Entry_Barrier_Function);
12120 pragma Inline (Set_Is_Expanded_Build_In_Place_Call);
12121 pragma Inline (Set_Is_Folded_In_Parser);
12122 pragma Inline (Set_Is_In_Discriminant_Check);
12123 pragma Inline (Set_Is_Machine_Number);
12124 pragma Inline (Set_Is_Null_Loop);
12125 pragma Inline (Set_Is_Overloaded);
12126 pragma Inline (Set_Is_Power_Of_2_For_Shift);
12127 pragma Inline (Set_Is_Protected_Subprogram_Body);
12128 pragma Inline (Set_Has_Self_Reference);
12129 pragma Inline (Set_Is_Static_Coextension);
12130 pragma Inline (Set_Is_Static_Expression);
12131 pragma Inline (Set_Is_Subprogram_Descriptor);
12132 pragma Inline (Set_Is_Task_Allocation_Block);
12133 pragma Inline (Set_Is_Task_Master);
12134 pragma Inline (Set_Iteration_Scheme);
12135 pragma Inline (Set_Itype);
12136 pragma Inline (Set_Kill_Range_Check);
12137 pragma Inline (Set_Last_Bit);
12138 pragma Inline (Set_Last_Name);
12139 pragma Inline (Set_Library_Unit);
12140 pragma Inline (Set_Label_Construct);
12141 pragma Inline (Set_Left_Opnd);
12142 pragma Inline (Set_Limited_View_Installed);
12143 pragma Inline (Set_Limited_Present);
12144 pragma Inline (Set_Literals);
12145 pragma Inline (Set_Local_Raise_Not_OK);
12146 pragma Inline (Set_Local_Raise_Statements);
12147 pragma Inline (Set_Loop_Actions);
12148 pragma Inline (Set_Loop_Parameter_Specification);
12149 pragma Inline (Set_Low_Bound);
12150 pragma Inline (Set_Mod_Clause);
12151 pragma Inline (Set_More_Ids);
12152 pragma Inline (Set_Must_Be_Byte_Aligned);
12153 pragma Inline (Set_Must_Not_Freeze);
12154 pragma Inline (Set_Must_Not_Override);
12155 pragma Inline (Set_Must_Override);
12156 pragma Inline (Set_Name);
12157 pragma Inline (Set_Names);
12158 pragma Inline (Set_Next_Entity);
12159 pragma Inline (Set_Next_Exit_Statement);
12160 pragma Inline (Set_Next_Implicit_With);
12161 pragma Inline (Set_Next_Named_Actual);
12162 pragma Inline (Set_Next_Pragma);
12163 pragma Inline (Set_Next_Rep_Item);
12164 pragma Inline (Set_Next_Use_Clause);
12165 pragma Inline (Set_No_Ctrl_Actions);
12166 pragma Inline (Set_No_Elaboration_Check);
12167 pragma Inline (Set_No_Entities_Ref_In_Spec);
12168 pragma Inline (Set_No_Initialization);
12169 pragma Inline (Set_No_Truncation);
12170 pragma Inline (Set_Null_Present);
12171 pragma Inline (Set_Null_Exclusion_Present);
12172 pragma Inline (Set_Null_Exclusion_In_Return_Present);
12173 pragma Inline (Set_Null_Record_Present);
12174 pragma Inline (Set_Object_Definition);
12175 pragma Inline (Set_Of_Present);
12176 pragma Inline (Set_Original_Discriminant);
12177 pragma Inline (Set_Original_Entity);
12178 pragma Inline (Set_Others_Discrete_Choices);
12179 pragma Inline (Set_Out_Present);
12180 pragma Inline (Set_Parameter_Associations);
12181 pragma Inline (Set_Parameter_Specifications);
12182 pragma Inline (Set_Parameter_List_Truncated);
12183 pragma Inline (Set_Parameter_Type);
12184 pragma Inline (Set_Parent_Spec);
12185 pragma Inline (Set_Position);
12186 pragma Inline (Set_Pragma_Argument_Associations);
12187 pragma Inline (Set_Pragma_Enabled);
12188 pragma Inline (Set_Pragma_Identifier);
12189 pragma Inline (Set_Pragmas_After);
12190 pragma Inline (Set_Pragmas_Before);
12191 pragma Inline (Set_Prefix);
12192 pragma Inline (Set_Present_Expr);
12193 pragma Inline (Set_Prev_Ids);
12194 pragma Inline (Set_Print_In_Hex);
12195 pragma Inline (Set_Private_Declarations);
12196 pragma Inline (Set_Private_Present);
12197 pragma Inline (Set_Procedure_To_Call);
12198 pragma Inline (Set_Proper_Body);
12199 pragma Inline (Set_Protected_Definition);
12200 pragma Inline (Set_Protected_Present);
12201 pragma Inline (Set_Raises_Constraint_Error);
12202 pragma Inline (Set_Range_Constraint);
12203 pragma Inline (Set_Range_Expression);
12204 pragma Inline (Set_Real_Range_Specification);
12205 pragma Inline (Set_Realval);
12206 pragma Inline (Set_Reason);
12207 pragma Inline (Set_Record_Extension_Part);
12208 pragma Inline (Set_Redundant_Use);
12209 pragma Inline (Set_Renaming_Exception);
12210 pragma Inline (Set_Result_Definition);
12211 pragma Inline (Set_Return_Object_Declarations);
12212 pragma Inline (Set_Reverse_Present);
12213 pragma Inline (Set_Right_Opnd);
12214 pragma Inline (Set_Rounded_Result);
12215 pragma Inline (Set_SCIL_Controlling_Tag);
12216 pragma Inline (Set_SCIL_Entity);
12217 pragma Inline (Set_SCIL_Tag_Value);
12218 pragma Inline (Set_SCIL_Target_Prim);
12219 pragma Inline (Set_Scope);
12220 pragma Inline (Set_Select_Alternatives);
12221 pragma Inline (Set_Selector_Name);
12222 pragma Inline (Set_Selector_Names);
12223 pragma Inline (Set_Shift_Count_OK);
12224 pragma Inline (Set_Source_Type);
12225 pragma Inline (Set_Specification);
12226 pragma Inline (Set_Split_PPC);
12227 pragma Inline (Set_Statements);
12228 pragma Inline (Set_Static_Processing_OK);
12229 pragma Inline (Set_Storage_Pool);
12230 pragma Inline (Set_Strval);
12231 pragma Inline (Set_Subtype_Indication);
12232 pragma Inline (Set_Subtype_Mark);
12233 pragma Inline (Set_Subtype_Marks);
12234 pragma Inline (Set_Suppress_Assignment_Checks);
12235 pragma Inline (Set_Suppress_Loop_Warnings);
12236 pragma Inline (Set_Synchronized_Present);
12237 pragma Inline (Set_Tagged_Present);
12238 pragma Inline (Set_Target_Type);
12239 pragma Inline (Set_Task_Definition);
12240 pragma Inline (Set_Task_Present);
12241 pragma Inline (Set_Then_Actions);
12242 pragma Inline (Set_Then_Statements);
12243 pragma Inline (Set_Triggering_Alternative);
12244 pragma Inline (Set_Triggering_Statement);
12245 pragma Inline (Set_Treat_Fixed_As_Integer);
12246 pragma Inline (Set_TSS_Elist);
12247 pragma Inline (Set_Type_Definition);
12248 pragma Inline (Set_Unit);
12249 pragma Inline (Set_Unknown_Discriminants_Present);
12250 pragma Inline (Set_Unreferenced_In_Spec);
12251 pragma Inline (Set_Variant_Part);
12252 pragma Inline (Set_Variants);
12253 pragma Inline (Set_Visible_Declarations);
12254 pragma Inline (Set_Was_Originally_Stub);
12255 pragma Inline (Set_Withed_Body);
12256 pragma Inline (Set_Zero_Cost_Handling);
12257
12258 N_Simple_Return_Statement : constant Node_Kind := N_Return_Statement;
12259 -- Rename N_Return_Statement to be N_Simple_Return_Statement. Clients
12260 -- should refer to N_Simple_Return_Statement.
12261
12262 end Sinfo;