1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2004, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 2, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING. If not, write --
19 -- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
20 -- MA 02111-1307, USA. --
22 -- GNAT was originally developed by the GNAT team at New York University. --
23 -- Extensive contributions were provided by Ada Core Technologies Inc. --
25 ------------------------------------------------------------------------------
27 -- This unit contains the semantic processing for all pragmas, both language
28 -- and implementation defined. For most pragmas, the parser only does the
29 -- most basic job of checking the syntax, so Sem_Prag also contains the code
30 -- to complete the syntax checks. Certain pragmas are handled partially or
31 -- completely by the parser (see Par.Prag for further details).
33 with Atree; use Atree;
34 with Casing; use Casing;
35 with Csets; use Csets;
36 with Debug; use Debug;
37 with Einfo; use Einfo;
38 with Elists; use Elists;
39 with Errout; use Errout;
40 with Expander; use Expander;
41 with Exp_Dist; use Exp_Dist;
42 with Fname; use Fname;
43 with Hostparm; use Hostparm;
45 with Lib.Writ; use Lib.Writ;
46 with Lib.Xref; use Lib.Xref;
47 with Namet; use Namet;
48 with Nlists; use Nlists;
49 with Nmake; use Nmake;
51 with Output; use Output;
52 with Restrict; use Restrict;
53 with Rident; use Rident;
54 with Rtsfind; use Rtsfind;
56 with Sem_Ch3; use Sem_Ch3;
57 with Sem_Ch8; use Sem_Ch8;
58 with Sem_Ch13; use Sem_Ch13;
59 with Sem_Disp; use Sem_Disp;
60 with Sem_Elim; use Sem_Elim;
61 with Sem_Eval; use Sem_Eval;
62 with Sem_Intr; use Sem_Intr;
63 with Sem_Mech; use Sem_Mech;
64 with Sem_Res; use Sem_Res;
65 with Sem_Type; use Sem_Type;
66 with Sem_Util; use Sem_Util;
67 with Sem_VFpt; use Sem_VFpt;
68 with Stand; use Stand;
69 with Sinfo; use Sinfo;
70 with Sinfo.CN; use Sinfo.CN;
71 with Sinput; use Sinput;
72 with Snames; use Snames;
73 with Stringt; use Stringt;
74 with Stylesw; use Stylesw;
75 with Targparm; use Targparm;
76 with Tbuild; use Tbuild;
78 with Uintp; use Uintp;
79 with Urealp; use Urealp;
80 with Validsw; use Validsw;
82 with GNAT.Spelling_Checker; use GNAT.Spelling_Checker;
84 package body Sem_Prag is
86 ----------------------------------------------
87 -- Common Handling of Import-Export Pragmas --
88 ----------------------------------------------
90 -- In the following section, a number of Import_xxx and Export_xxx
91 -- pragmas are defined by GNAT. These are compatible with the DEC
92 -- pragmas of the same name, and all have the following common
93 -- form and processing:
96 -- [Internal =>] LOCAL_NAME,
97 -- [, [External =>] EXTERNAL_SYMBOL]
98 -- [, other optional parameters ]);
101 -- [Internal =>] LOCAL_NAME,
102 -- [, [External =>] EXTERNAL_SYMBOL]
103 -- [, other optional parameters ]);
105 -- EXTERNAL_SYMBOL ::=
107 -- | static_string_EXPRESSION
109 -- The internal LOCAL_NAME designates the entity that is imported or
110 -- exported, and must refer to an entity in the current declarative
111 -- part (as required by the rules for LOCAL_NAME).
113 -- The external linker name is designated by the External parameter
114 -- if given, or the Internal parameter if not (if there is no External
115 -- parameter, the External parameter is a copy of the Internal name).
117 -- If the External parameter is given as a string, then this string
118 -- is treated as an external name (exactly as though it had been given
119 -- as an External_Name parameter for a normal Import pragma).
121 -- If the External parameter is given as an identifier (or there is no
122 -- External parameter, so that the Internal identifier is used), then
123 -- the external name is the characters of the identifier, translated
124 -- to all upper case letters for OpenVMS versions of GNAT, and to all
125 -- lower case letters for all other versions
127 -- Note: the external name specified or implied by any of these special
128 -- Import_xxx or Export_xxx pragmas override an external or link name
129 -- specified in a previous Import or Export pragma.
131 -- Note: these and all other DEC-compatible GNAT pragmas allow full
132 -- use of named notation, following the standard rules for subprogram
133 -- calls, i.e. parameters can be given in any order if named notation
134 -- is used, and positional and named notation can be mixed, subject to
135 -- the rule that all positional parameters must appear first.
137 -- Note: All these pragmas are implemented exactly following the DEC
138 -- design and implementation and are intended to be fully compatible
139 -- with the use of these pragmas in the DEC Ada compiler.
141 -------------------------------------
142 -- Local Subprograms and Variables --
143 -------------------------------------
145 function Adjust_External_Name_Case (N : Node_Id) return Node_Id;
146 -- This routine is used for possible casing adjustment of an explicit
147 -- external name supplied as a string literal (the node N), according
148 -- to the casing requirement of Opt.External_Name_Casing. If this is
149 -- set to As_Is, then the string literal is returned unchanged, but if
150 -- it is set to Uppercase or Lowercase, then a new string literal with
151 -- appropriate casing is constructed.
153 function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id;
154 -- If Def_Id refers to a renamed subprogram, then the base subprogram
155 -- (the original one, following the renaming chain) is returned.
156 -- Otherwise the entity is returned unchanged. Should be in Einfo???
158 procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id);
159 -- Place semantic information on the argument of an Elaborate or
160 -- Elaborate_All pragma. Entity name for unit and its parents is
161 -- taken from item in previous with_clause that mentions the unit.
163 -------------------------------
164 -- Adjust_External_Name_Case --
165 -------------------------------
167 function Adjust_External_Name_Case (N : Node_Id) return Node_Id is
171 -- Adjust case of literal if required
173 if Opt.External_Name_Exp_Casing = As_Is then
177 -- Copy existing string
183 for J in 1 .. String_Length (Strval (N)) loop
184 CC := Get_String_Char (Strval (N), J);
186 if Opt.External_Name_Exp_Casing = Uppercase
187 and then CC >= Get_Char_Code ('a')
188 and then CC <= Get_Char_Code ('z')
190 Store_String_Char (CC - 32);
192 elsif Opt.External_Name_Exp_Casing = Lowercase
193 and then CC >= Get_Char_Code ('A')
194 and then CC <= Get_Char_Code ('Z')
196 Store_String_Char (CC + 32);
199 Store_String_Char (CC);
204 Make_String_Literal (Sloc (N),
205 Strval => End_String);
207 end Adjust_External_Name_Case;
213 procedure Analyze_Pragma (N : Node_Id) is
214 Loc : constant Source_Ptr := Sloc (N);
217 Pragma_Exit : exception;
218 -- This exception is used to exit pragma processing completely. It
219 -- is used when an error is detected, and in other situations where
220 -- it is known that no further processing is required.
223 -- Number of pragma argument associations
229 -- First four pragma arguments (pragma argument association nodes,
230 -- or Empty if the corresponding argument does not exist).
232 procedure Check_Ada_83_Warning;
233 -- Issues a warning message for the current pragma if operating in Ada
234 -- 83 mode (used for language pragmas that are not a standard part of
235 -- Ada 83). This procedure does not raise Error_Pragma. Also notes use
238 procedure Check_Arg_Count (Required : Nat);
239 -- Check argument count for pragma is equal to given parameter.
240 -- If not, then issue an error message and raise Pragma_Exit.
242 -- Note: all routines whose name is Check_Arg_Is_xxx take an
243 -- argument Arg which can either be a pragma argument association,
244 -- in which case the check is applied to the expression of the
245 -- association or an expression directly.
247 procedure Check_Arg_Is_Identifier (Arg : Node_Id);
248 -- Check the specified argument Arg to make sure that it is an
249 -- identifier. If not give error and raise Pragma_Exit.
251 procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id);
252 -- Check the specified argument Arg to make sure that it is an
253 -- integer literal. If not give error and raise Pragma_Exit.
255 procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id);
256 -- Check the specified argument Arg to make sure that it has the
257 -- proper syntactic form for a local name and meets the semantic
258 -- requirements for a local name. The local name is analyzed as
259 -- part of the processing for this call. In addition, the local
260 -- name is required to represent an entity at the library level.
262 procedure Check_Arg_Is_Local_Name (Arg : Node_Id);
263 -- Check the specified argument Arg to make sure that it has the
264 -- proper syntactic form for a local name and meets the semantic
265 -- requirements for a local name. The local name is analyzed as
266 -- part of the processing for this call.
268 procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id);
269 -- Check the specified argument Arg to make sure that it is a valid
270 -- locking policy name. If not give error and raise Pragma_Exit.
272 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id);
273 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2, N3 : Name_Id);
274 -- Check the specified argument Arg to make sure that it is an
275 -- identifier whose name matches either N1 or N2 (or N3 if present).
276 -- If not then give error and raise Pragma_Exit.
278 procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id);
279 -- Check the specified argument Arg to make sure that it is a valid
280 -- queuing policy name. If not give error and raise Pragma_Exit.
282 procedure Check_Arg_Is_Static_Expression
285 -- Check the specified argument Arg to make sure that it is a static
286 -- expression of the given type (i.e. it will be analyzed and resolved
287 -- using this type, which can be any valid argument to Resolve, e.g.
288 -- Any_Integer is OK). If not, given error and raise Pragma_Exit.
290 procedure Check_Arg_Is_String_Literal (Arg : Node_Id);
291 -- Check the specified argument Arg to make sure that it is a
292 -- string literal. If not give error and raise Pragma_Exit
294 procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id);
295 -- Check the specified argument Arg to make sure that it is a valid
296 -- valid task dispatching policy name. If not give error and raise
299 procedure Check_At_Least_N_Arguments (N : Nat);
300 -- Check there are at least N arguments present
302 procedure Check_At_Most_N_Arguments (N : Nat);
303 -- Check there are no more than N arguments present
305 procedure Check_First_Subtype (Arg : Node_Id);
306 -- Checks that Arg, whose expression is an entity name referencing
307 -- a subtype, does not reference a type that is not a first subtype.
309 procedure Check_In_Main_Program;
310 -- Common checks for pragmas that appear within a main program
311 -- (Priority, Main_Storage, Time_Slice).
313 procedure Check_Interrupt_Or_Attach_Handler;
314 -- Common processing for first argument of pragma Interrupt_Handler
315 -- or pragma Attach_Handler.
317 procedure Check_Is_In_Decl_Part_Or_Package_Spec;
318 -- Check that pragma appears in a declarative part, or in a package
319 -- specification, i.e. that it does not occur in a statement sequence
322 procedure Check_No_Identifier (Arg : Node_Id);
323 -- Checks that the given argument does not have an identifier. If
324 -- an identifier is present, then an error message is issued, and
325 -- Pragma_Exit is raised.
327 procedure Check_No_Identifiers;
328 -- Checks that none of the arguments to the pragma has an identifier.
329 -- If any argument has an identifier, then an error message is issued,
330 -- and Pragma_Exit is raised.
332 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id);
333 -- Checks if the given argument has an identifier, and if so, requires
334 -- it to match the given identifier name. If there is a non-matching
335 -- identifier, then an error message is given and Error_Pragmas raised.
337 procedure Check_Optional_Identifier (Arg : Node_Id; Id : String);
338 -- Checks if the given argument has an identifier, and if so, requires
339 -- it to match the given identifier name. If there is a non-matching
340 -- identifier, then an error message is given and Error_Pragmas raised.
341 -- In this version of the procedure, the identifier name is given as
342 -- a string with lower case letters.
344 procedure Check_Static_Constraint (Constr : Node_Id);
345 -- Constr is a constraint from an N_Subtype_Indication node from a
346 -- component constraint in an Unchecked_Union type. This routine checks
347 -- that the constraint is static as required by the restrictions for
350 procedure Check_Valid_Configuration_Pragma;
351 -- Legality checks for placement of a configuration pragma
353 procedure Check_Valid_Library_Unit_Pragma;
354 -- Legality checks for library unit pragmas. A special case arises for
355 -- pragmas in generic instances that come from copies of the original
356 -- library unit pragmas in the generic templates. In the case of other
357 -- than library level instantiations these can appear in contexts which
358 -- would normally be invalid (they only apply to the original template
359 -- and to library level instantiations), and they are simply ignored,
360 -- which is implemented by rewriting them as null statements.
362 procedure Error_Pragma (Msg : String);
363 pragma No_Return (Error_Pragma);
364 -- Outputs error message for current pragma. The message contains an %
365 -- that will be replaced with the pragma name, and the flag is placed
366 -- on the pragma itself. Pragma_Exit is then raised.
368 procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id);
369 pragma No_Return (Error_Pragma_Arg);
370 -- Outputs error message for current pragma. The message may contain
371 -- a % that will be replaced with the pragma name. The parameter Arg
372 -- may either be a pragma argument association, in which case the flag
373 -- is placed on the expression of this association, or an expression,
374 -- in which case the flag is placed directly on the expression. The
375 -- message is placed using Error_Msg_N, so the message may also contain
376 -- an & insertion character which will reference the given Arg value.
377 -- After placing the message, Pragma_Exit is raised.
379 procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id);
380 pragma No_Return (Error_Pragma_Arg);
381 -- Similar to above form of Error_Pragma_Arg except that two messages
382 -- are provided, the second is a continuation comment starting with \.
384 procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id);
385 pragma No_Return (Error_Pragma_Arg_Ident);
386 -- Outputs error message for current pragma. The message may contain
387 -- a % that will be replaced with the pragma name. The parameter Arg
388 -- must be a pragma argument association with a non-empty identifier
389 -- (i.e. its Chars field must be set), and the error message is placed
390 -- on the identifier. The message is placed using Error_Msg_N so
391 -- the message may also contain an & insertion character which will
392 -- reference the identifier. After placing the message, Pragma_Exit
395 function Find_Lib_Unit_Name return Entity_Id;
396 -- Used for a library unit pragma to find the entity to which the
397 -- library unit pragma applies, returns the entity found.
399 procedure Find_Program_Unit_Name (Id : Node_Id);
400 -- If the pragma is a compilation unit pragma, the id must denote the
401 -- compilation unit in the same compilation, and the pragma must appear
402 -- in the list of preceding or trailing pragmas. If it is a program
403 -- unit pragma that is not a compilation unit pragma, then the
404 -- identifier must be visible.
406 type Name_List is array (Natural range <>) of Name_Id;
407 type Args_List is array (Natural range <>) of Node_Id;
408 procedure Gather_Associations
410 Args : out Args_List);
411 -- This procedure is used to gather the arguments for a pragma that
412 -- permits arbitrary ordering of parameters using the normal rules
413 -- for named and positional parameters. The Names argument is a list
414 -- of Name_Id values that corresponds to the allowed pragma argument
415 -- association identifiers in order. The result returned in Args is
416 -- a list of corresponding expressions that are the pragma arguments.
417 -- Note that this is a list of expressions, not of pragma argument
418 -- associations (Gather_Associations has completely checked all the
419 -- optional identifiers when it returns). An entry in Args is Empty
420 -- on return if the corresponding argument is not present.
422 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id;
423 -- All the routines that check pragma arguments take either a pragma
424 -- argument association (in which case the expression of the argument
425 -- association is checked), or the expression directly. The function
426 -- Get_Pragma_Arg is a utility used to deal with these two cases. If
427 -- Arg is a pragma argument association node, then its expression is
428 -- returned, otherwise Arg is returned unchanged.
430 procedure GNAT_Pragma;
431 -- Called for all GNAT defined pragmas to note the use of the feature,
432 -- and also check the relevant restriction (No_Implementation_Pragmas).
434 function Is_Before_First_Decl
435 (Pragma_Node : Node_Id;
436 Decls : List_Id) return Boolean;
437 -- Return True if Pragma_Node is before the first declarative item in
438 -- Decls where Decls is the list of declarative items.
440 function Is_Configuration_Pragma return Boolean;
441 -- Deterermines if the placement of the current pragma is appropriate
442 -- for a configuration pragma (precedes the current compilation unit)
444 procedure Pragma_Misplaced;
445 -- Issue fatal error message for misplaced pragma
447 procedure Process_Atomic_Shared_Volatile;
448 -- Common processing for pragmas Atomic, Shared, Volatile. Note that
449 -- Shared is an obsolete Ada 83 pragma, treated as being identical
450 -- in effect to pragma Atomic.
452 procedure Process_Convention (C : out Convention_Id; E : out Entity_Id);
453 -- Common procesing for Convention, Interface, Import and Export.
454 -- Checks first two arguments of pragma, and sets the appropriate
455 -- convention value in the specified entity or entities. On return
456 -- C is the convention, E is the referenced entity.
458 procedure Process_Extended_Import_Export_Exception_Pragma
459 (Arg_Internal : Node_Id;
460 Arg_External : Node_Id;
463 -- Common processing for the pragmas Import/Export_Exception.
464 -- The three arguments correspond to the three named parameters of
465 -- the pragma. An argument is empty if the corresponding parameter
466 -- is not present in the pragma.
468 procedure Process_Extended_Import_Export_Object_Pragma
469 (Arg_Internal : Node_Id;
470 Arg_External : Node_Id;
472 -- Common processing for the pragmass Import/Export_Object.
473 -- The three arguments correspond to the three named parameters
474 -- of the pragmas. An argument is empty if the corresponding
475 -- parameter is not present in the pragma.
477 procedure Process_Extended_Import_Export_Internal_Arg
478 (Arg_Internal : Node_Id := Empty);
479 -- Common processing for all extended Import and Export pragmas. The
480 -- argument is the pragma parameter for the Internal argument. If
481 -- Arg_Internal is empty or inappropriate, an error message is posted.
482 -- Otherwise, on normal return, the Entity_Field of Arg_Internal is
483 -- set to identify the referenced entity.
485 procedure Process_Extended_Import_Export_Subprogram_Pragma
486 (Arg_Internal : Node_Id;
487 Arg_External : Node_Id;
488 Arg_Parameter_Types : Node_Id;
489 Arg_Result_Type : Node_Id := Empty;
490 Arg_Mechanism : Node_Id;
491 Arg_Result_Mechanism : Node_Id := Empty;
492 Arg_First_Optional_Parameter : Node_Id := Empty);
493 -- Common processing for all extended Import and Export pragmas
494 -- applying to subprograms. The caller omits any arguments that do
495 -- bnot apply to the pragma in question (for example, Arg_Result_Type
496 -- can be non-Empty only in the Import_Function and Export_Function
497 -- cases). The argument names correspond to the allowed pragma
498 -- association identifiers.
500 procedure Process_Generic_List;
501 -- Common processing for Share_Generic and Inline_Generic
503 procedure Process_Import_Or_Interface;
504 -- Common processing for Import of Interface
506 procedure Process_Inline (Active : Boolean);
507 -- Common processing for Inline and Inline_Always. The parameter
508 -- indicates if the inline pragma is active, i.e. if it should
509 -- actually cause inlining to occur.
511 procedure Process_Interface_Name
512 (Subprogram_Def : Entity_Id;
515 -- Given the last two arguments of pragma Import, pragma Export, or
516 -- pragma Interface_Name, performs validity checks and sets the
517 -- Interface_Name field of the given subprogram entity to the
518 -- appropriate external or link name, depending on the arguments
519 -- given. Ext_Arg is always present, but Link_Arg may be missing.
520 -- Note that Ext_Arg may represent the Link_Name if Link_Arg is
521 -- missing, and appropriate named notation is used for Ext_Arg.
522 -- If neither Ext_Arg nor Link_Arg is present, the interface name
523 -- is set to the default from the subprogram name.
525 procedure Process_Interrupt_Or_Attach_Handler;
526 -- Common processing for Interrupt and Attach_Handler pragmas
528 procedure Process_Restrictions_Or_Restriction_Warnings;
529 -- Common processing for Restrictions and Restriction_Warnings pragmas
531 procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean);
532 -- Common processing for Suppress and Unsuppress. The boolean parameter
533 -- Suppress_Case is True for the Suppress case, and False for the
536 procedure Set_Exported (E : Entity_Id; Arg : Node_Id);
537 -- This procedure sets the Is_Exported flag for the given entity,
538 -- checking that the entity was not previously imported. Arg is
539 -- the argument that specified the entity. A check is also made
540 -- for exporting inappropriate entities.
542 procedure Set_Extended_Import_Export_External_Name
543 (Internal_Ent : Entity_Id;
544 Arg_External : Node_Id);
545 -- Common processing for all extended import export pragmas. The first
546 -- argument, Internal_Ent, is the internal entity, which has already
547 -- been checked for validity by the caller. Arg_External is from the
548 -- Import or Export pragma, and may be null if no External parameter
549 -- was present. If Arg_External is present and is a non-null string
550 -- (a null string is treated as the default), then the Interface_Name
551 -- field of Internal_Ent is set appropriately.
553 procedure Set_Imported (E : Entity_Id);
554 -- This procedure sets the Is_Imported flag for the given entity,
555 -- checking that it is not previously exported or imported.
557 procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id);
558 -- Mech is a parameter passing mechanism (see Import_Function syntax
559 -- for MECHANISM_NAME). This routine checks that the mechanism argument
560 -- has the right form, and if not issues an error message. If the
561 -- argument has the right form then the Mechanism field of Ent is
562 -- set appropriately.
564 --------------------------
565 -- Check_Ada_83_Warning --
566 --------------------------
568 procedure Check_Ada_83_Warning is
570 if Ada_83 and then Comes_From_Source (N) then
571 Error_Msg_N ("(Ada 83) pragma& is non-standard?", N);
573 end Check_Ada_83_Warning;
575 ---------------------
576 -- Check_Arg_Count --
577 ---------------------
579 procedure Check_Arg_Count (Required : Nat) is
581 if Arg_Count /= Required then
582 Error_Pragma ("wrong number of arguments for pragma%");
586 -----------------------------
587 -- Check_Arg_Is_Identifier --
588 -----------------------------
590 procedure Check_Arg_Is_Identifier (Arg : Node_Id) is
591 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
594 if Nkind (Argx) /= N_Identifier then
596 ("argument for pragma% must be identifier", Argx);
598 end Check_Arg_Is_Identifier;
600 ----------------------------------
601 -- Check_Arg_Is_Integer_Literal --
602 ----------------------------------
604 procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id) is
605 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
608 if Nkind (Argx) /= N_Integer_Literal then
610 ("argument for pragma% must be integer literal", Argx);
612 end Check_Arg_Is_Integer_Literal;
614 -------------------------------------------
615 -- Check_Arg_Is_Library_Level_Local_Name --
616 -------------------------------------------
620 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
621 -- | library_unit_NAME
623 procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id) is
625 Check_Arg_Is_Local_Name (Arg);
627 if not Is_Library_Level_Entity (Entity (Expression (Arg)))
628 and then Comes_From_Source (N)
631 ("argument for pragma% must be library level entity", Arg);
633 end Check_Arg_Is_Library_Level_Local_Name;
635 -----------------------------
636 -- Check_Arg_Is_Local_Name --
637 -----------------------------
641 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
642 -- | library_unit_NAME
644 procedure Check_Arg_Is_Local_Name (Arg : Node_Id) is
645 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
650 if Nkind (Argx) not in N_Direct_Name
651 and then (Nkind (Argx) /= N_Attribute_Reference
652 or else Present (Expressions (Argx))
653 or else Nkind (Prefix (Argx)) /= N_Identifier)
654 and then (not Is_Entity_Name (Argx)
655 or else not Is_Compilation_Unit (Entity (Argx)))
657 Error_Pragma_Arg ("argument for pragma% must be local name", Argx);
660 if Is_Entity_Name (Argx)
661 and then Scope (Entity (Argx)) /= Current_Scope
664 ("pragma% argument must be in same declarative part", Arg);
666 end Check_Arg_Is_Local_Name;
668 ---------------------------------
669 -- Check_Arg_Is_Locking_Policy --
670 ---------------------------------
672 procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id) is
673 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
676 Check_Arg_Is_Identifier (Argx);
678 if not Is_Locking_Policy_Name (Chars (Argx)) then
680 ("& is not a valid locking policy name", Argx);
682 end Check_Arg_Is_Locking_Policy;
684 -------------------------
685 -- Check_Arg_Is_One_Of --
686 -------------------------
688 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id) is
689 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
692 Check_Arg_Is_Identifier (Argx);
694 if Chars (Argx) /= N1 and then Chars (Argx) /= N2 then
695 Error_Msg_Name_2 := N1;
696 Error_Msg_Name_3 := N2;
697 Error_Pragma_Arg ("argument for pragma% must be% or%", Argx);
699 end Check_Arg_Is_One_Of;
701 procedure Check_Arg_Is_One_Of
703 N1, N2, N3 : Name_Id)
705 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
708 Check_Arg_Is_Identifier (Argx);
710 if Chars (Argx) /= N1
711 and then Chars (Argx) /= N2
712 and then Chars (Argx) /= N3
714 Error_Pragma_Arg ("invalid argument for pragma%", Argx);
716 end Check_Arg_Is_One_Of;
718 ---------------------------------
719 -- Check_Arg_Is_Queuing_Policy --
720 ---------------------------------
722 procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id) is
723 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
726 Check_Arg_Is_Identifier (Argx);
728 if not Is_Queuing_Policy_Name (Chars (Argx)) then
730 ("& is not a valid queuing policy name", Argx);
732 end Check_Arg_Is_Queuing_Policy;
734 ------------------------------------
735 -- Check_Arg_Is_Static_Expression --
736 ------------------------------------
738 procedure Check_Arg_Is_Static_Expression
742 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
745 Analyze_And_Resolve (Argx, Typ);
747 if Is_OK_Static_Expression (Argx) then
750 elsif Etype (Argx) = Any_Type then
753 -- An interesting special case, if we have a string literal and
754 -- we are in Ada 83 mode, then we allow it even though it will
755 -- not be flagged as static. This allows the use of Ada 95
756 -- pragmas like Import in Ada 83 mode. They will of course be
757 -- flagged with warnings as usual, but will not cause errors.
759 elsif Ada_83 and then Nkind (Argx) = N_String_Literal then
762 -- Static expression that raises Constraint_Error. This has
763 -- already been flagged, so just exit from pragma processing.
765 elsif Is_Static_Expression (Argx) then
768 -- Finally, we have a real error
771 Error_Msg_Name_1 := Chars (N);
773 ("argument for pragma% must be a static expression!", Argx);
776 end Check_Arg_Is_Static_Expression;
778 ---------------------------------
779 -- Check_Arg_Is_String_Literal --
780 ---------------------------------
782 procedure Check_Arg_Is_String_Literal (Arg : Node_Id) is
783 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
786 if Nkind (Argx) /= N_String_Literal then
788 ("argument for pragma% must be string literal", Argx);
791 end Check_Arg_Is_String_Literal;
793 ------------------------------------------
794 -- Check_Arg_Is_Task_Dispatching_Policy --
795 ------------------------------------------
797 procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id) is
798 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
801 Check_Arg_Is_Identifier (Argx);
803 if not Is_Task_Dispatching_Policy_Name (Chars (Argx)) then
805 ("& is not a valid task dispatching policy name", Argx);
807 end Check_Arg_Is_Task_Dispatching_Policy;
809 --------------------------------
810 -- Check_At_Least_N_Arguments --
811 --------------------------------
813 procedure Check_At_Least_N_Arguments (N : Nat) is
815 if Arg_Count < N then
816 Error_Pragma ("too few arguments for pragma%");
818 end Check_At_Least_N_Arguments;
820 -------------------------------
821 -- Check_At_Most_N_Arguments --
822 -------------------------------
824 procedure Check_At_Most_N_Arguments (N : Nat) is
828 if Arg_Count > N then
833 Error_Pragma_Arg ("too many arguments for pragma%", Arg);
836 end Check_At_Most_N_Arguments;
838 -------------------------
839 -- Check_First_Subtype --
840 -------------------------
842 procedure Check_First_Subtype (Arg : Node_Id) is
843 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
846 if not Is_First_Subtype (Entity (Argx)) then
848 ("pragma% cannot apply to subtype", Argx);
850 end Check_First_Subtype;
852 ---------------------------
853 -- Check_In_Main_Program --
854 ---------------------------
856 procedure Check_In_Main_Program is
857 P : constant Node_Id := Parent (N);
860 -- Must be at in subprogram body
862 if Nkind (P) /= N_Subprogram_Body then
863 Error_Pragma ("% pragma allowed only in subprogram");
865 -- Otherwise warn if obviously not main program
867 elsif Present (Parameter_Specifications (Specification (P)))
868 or else not Is_Compilation_Unit (Defining_Entity (P))
870 Error_Msg_Name_1 := Chars (N);
872 ("?pragma% is only effective in main program", N);
874 end Check_In_Main_Program;
876 ---------------------------------------
877 -- Check_Interrupt_Or_Attach_Handler --
878 ---------------------------------------
880 procedure Check_Interrupt_Or_Attach_Handler is
881 Arg1_X : constant Node_Id := Expression (Arg1);
886 if not Is_Entity_Name (Arg1_X) then
888 ("argument of pragma% must be entity name", Arg1);
890 elsif Prag_Id = Pragma_Interrupt_Handler then
891 Check_Restriction (No_Dynamic_Interrupts, N);
895 Handler_Proc : Entity_Id := Empty;
896 Proc_Scope : Entity_Id;
897 Found : Boolean := False;
900 if not Is_Overloaded (Arg1_X) then
901 Handler_Proc := Entity (Arg1_X);
906 Index : Interp_Index;
909 Get_First_Interp (Arg1_X, Index, It);
910 while Present (It.Nam) loop
911 Handler_Proc := It.Nam;
913 if Ekind (Handler_Proc) = E_Procedure
914 and then No (First_Formal (Handler_Proc))
918 Set_Entity (Arg1_X, Handler_Proc);
919 Set_Is_Overloaded (Arg1_X, False);
922 ("ambiguous handler name for pragma% ", Arg1);
926 Get_Next_Interp (Index, It);
931 ("argument of pragma% must be parameterless procedure",
934 Handler_Proc := Entity (Arg1_X);
939 Proc_Scope := Scope (Handler_Proc);
941 -- On AAMP only, a pragma Interrupt_Handler is supported for
942 -- nonprotected parameterless procedures.
945 and then Prag_Id = Pragma_Interrupt_Handler
947 if Ekind (Handler_Proc) /= E_Procedure then
949 ("argument of pragma% must be a procedure", Arg1);
952 elsif Ekind (Handler_Proc) /= E_Procedure
953 or else Ekind (Proc_Scope) /= E_Protected_Type
956 ("argument of pragma% must be protected procedure", Arg1);
959 if (not AAMP_On_Target or else Prag_Id = Pragma_Attach_Handler)
960 and then Ekind (Proc_Scope) = E_Protected_Type
963 Protected_Definition (Parent (Proc_Scope))
965 Error_Pragma ("pragma% must be in protected definition");
969 if not Is_Library_Level_Entity (Proc_Scope)
970 or else (AAMP_On_Target
971 and then not Is_Library_Level_Entity (Handler_Proc))
974 ("pragma% requires library-level entity", Arg1);
977 if Present (First_Formal (Handler_Proc)) then
979 ("argument of pragma% must be parameterless procedure",
983 end Check_Interrupt_Or_Attach_Handler;
985 -------------------------------------------
986 -- Check_Is_In_Decl_Part_Or_Package_Spec --
987 -------------------------------------------
989 procedure Check_Is_In_Decl_Part_Or_Package_Spec is
998 elsif Nkind (P) = N_Handled_Sequence_Of_Statements then
1001 elsif Nkind (P) = N_Package_Specification then
1004 elsif Nkind (P) = N_Block_Statement then
1007 -- Note: the following tests seem a little peculiar, because
1008 -- they test for bodies, but if we were in the statement part
1009 -- of the body, we would already have hit the handled statement
1010 -- sequence, so the only way we get here is by being in the
1011 -- declarative part of the body.
1013 elsif Nkind (P) = N_Subprogram_Body
1014 or else Nkind (P) = N_Package_Body
1015 or else Nkind (P) = N_Task_Body
1016 or else Nkind (P) = N_Entry_Body
1024 Error_Pragma ("pragma% is not in declarative part or package spec");
1025 end Check_Is_In_Decl_Part_Or_Package_Spec;
1027 -------------------------
1028 -- Check_No_Identifier --
1029 -------------------------
1031 procedure Check_No_Identifier (Arg : Node_Id) is
1033 if Chars (Arg) /= No_Name then
1034 Error_Pragma_Arg_Ident
1035 ("pragma% does not permit identifier& here", Arg);
1037 end Check_No_Identifier;
1039 --------------------------
1040 -- Check_No_Identifiers --
1041 --------------------------
1043 procedure Check_No_Identifiers is
1047 if Arg_Count > 0 then
1050 while Present (Arg_Node) loop
1051 Check_No_Identifier (Arg_Node);
1055 end Check_No_Identifiers;
1057 -------------------------------
1058 -- Check_Optional_Identifier --
1059 -------------------------------
1061 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id) is
1063 if Present (Arg) and then Chars (Arg) /= No_Name then
1064 if Chars (Arg) /= Id then
1065 Error_Msg_Name_1 := Chars (N);
1066 Error_Msg_Name_2 := Id;
1067 Error_Msg_N ("pragma% argument expects identifier%", Arg);
1071 end Check_Optional_Identifier;
1073 procedure Check_Optional_Identifier (Arg : Node_Id; Id : String) is
1075 Name_Buffer (1 .. Id'Length) := Id;
1076 Name_Len := Id'Length;
1077 Check_Optional_Identifier (Arg, Name_Find);
1078 end Check_Optional_Identifier;
1080 -----------------------------
1081 -- Check_Static_Constraint --
1082 -----------------------------
1084 -- Note: for convenience in writing this procedure, in addition to
1085 -- the officially (i.e. by spec) allowed argument which is always
1086 -- a constraint, it also allows ranges and discriminant associations.
1087 -- Above is not clear ???
1089 procedure Check_Static_Constraint (Constr : Node_Id) is
1091 --------------------
1092 -- Require_Static --
1093 --------------------
1095 procedure Require_Static (E : Node_Id);
1096 -- Require given expression to be static expression
1098 procedure Require_Static (E : Node_Id) is
1100 if not Is_OK_Static_Expression (E) then
1101 Flag_Non_Static_Expr
1102 ("non-static constraint not allowed in Unchecked_Union!", E);
1107 -- Start of processing for Check_Static_Constraint
1110 case Nkind (Constr) is
1111 when N_Discriminant_Association =>
1112 Require_Static (Expression (Constr));
1115 Require_Static (Low_Bound (Constr));
1116 Require_Static (High_Bound (Constr));
1118 when N_Attribute_Reference =>
1119 Require_Static (Type_Low_Bound (Etype (Prefix (Constr))));
1120 Require_Static (Type_High_Bound (Etype (Prefix (Constr))));
1122 when N_Range_Constraint =>
1123 Check_Static_Constraint (Range_Expression (Constr));
1125 when N_Index_Or_Discriminant_Constraint =>
1127 IDC : Entity_Id := First (Constraints (Constr));
1129 while Present (IDC) loop
1130 Check_Static_Constraint (IDC);
1138 end Check_Static_Constraint;
1140 --------------------------------------
1141 -- Check_Valid_Configuration_Pragma --
1142 --------------------------------------
1144 -- A configuration pragma must appear in the context clause of
1145 -- a compilation unit, at the start of the list (i.e. only other
1146 -- pragmas may precede it).
1148 procedure Check_Valid_Configuration_Pragma is
1150 if not Is_Configuration_Pragma then
1151 Error_Pragma ("incorrect placement for configuration pragma%");
1153 end Check_Valid_Configuration_Pragma;
1155 -------------------------------------
1156 -- Check_Valid_Library_Unit_Pragma --
1157 -------------------------------------
1159 procedure Check_Valid_Library_Unit_Pragma is
1161 Parent_Node : Node_Id;
1162 Unit_Name : Entity_Id;
1163 Unit_Kind : Node_Kind;
1164 Unit_Node : Node_Id;
1165 Sindex : Source_File_Index;
1168 if not Is_List_Member (N) then
1172 Plist := List_Containing (N);
1173 Parent_Node := Parent (Plist);
1175 if Parent_Node = Empty then
1178 -- Case of pragma appearing after a compilation unit. In this
1179 -- case it must have an argument with the corresponding name
1180 -- and must be part of the following pragmas of its parent.
1182 elsif Nkind (Parent_Node) = N_Compilation_Unit_Aux then
1183 if Plist /= Pragmas_After (Parent_Node) then
1186 elsif Arg_Count = 0 then
1188 ("argument required if outside compilation unit");
1191 Check_No_Identifiers;
1192 Check_Arg_Count (1);
1193 Unit_Node := Unit (Parent (Parent_Node));
1194 Unit_Kind := Nkind (Unit_Node);
1196 Analyze (Expression (Arg1));
1198 if Unit_Kind = N_Generic_Subprogram_Declaration
1199 or else Unit_Kind = N_Subprogram_Declaration
1201 Unit_Name := Defining_Entity (Unit_Node);
1203 elsif Unit_Kind = N_Function_Instantiation
1204 or else Unit_Kind = N_Package_Instantiation
1205 or else Unit_Kind = N_Procedure_Instantiation
1207 Unit_Name := Defining_Entity (Unit_Node);
1210 Unit_Name := Cunit_Entity (Current_Sem_Unit);
1213 if Chars (Unit_Name) /=
1214 Chars (Entity (Expression (Arg1)))
1217 ("pragma% argument is not current unit name", Arg1);
1220 if Ekind (Unit_Name) = E_Package
1221 and then Present (Renamed_Entity (Unit_Name))
1223 Error_Pragma ("pragma% not allowed for renamed package");
1227 -- Pragma appears other than after a compilation unit
1230 -- Here we check for the generic instantiation case and also
1231 -- for the case of processing a generic formal package. We
1232 -- detect these cases by noting that the Sloc on the node
1233 -- does not belong to the current compilation unit.
1235 Sindex := Source_Index (Current_Sem_Unit);
1237 if Loc not in Source_First (Sindex) .. Source_Last (Sindex) then
1238 Rewrite (N, Make_Null_Statement (Loc));
1241 -- If before first declaration, the pragma applies to the
1242 -- enclosing unit, and the name if present must be this name.
1244 elsif Is_Before_First_Decl (N, Plist) then
1245 Unit_Node := Unit_Declaration_Node (Current_Scope);
1246 Unit_Kind := Nkind (Unit_Node);
1248 if Nkind (Parent (Unit_Node)) /= N_Compilation_Unit then
1251 elsif Unit_Kind = N_Subprogram_Body
1252 and then not Acts_As_Spec (Unit_Node)
1256 elsif Nkind (Parent_Node) = N_Package_Body then
1259 elsif Nkind (Parent_Node) = N_Package_Specification
1260 and then Plist = Private_Declarations (Parent_Node)
1264 elsif (Nkind (Parent_Node) = N_Generic_Package_Declaration
1265 or else Nkind (Parent_Node)
1266 = N_Generic_Subprogram_Declaration)
1267 and then Plist = Generic_Formal_Declarations (Parent_Node)
1271 elsif Arg_Count > 0 then
1272 Analyze (Expression (Arg1));
1274 if Entity (Expression (Arg1)) /= Current_Scope then
1276 ("name in pragma% must be enclosing unit", Arg1);
1279 -- It is legal to have no argument in this context
1285 -- Error if not before first declaration. This is because a
1286 -- library unit pragma argument must be the name of a library
1287 -- unit (RM 10.1.5(7)), but the only names permitted in this
1288 -- context are (RM 10.1.5(6)) names of subprogram declarations,
1289 -- generic subprogram declarations or generic instantiations.
1293 ("pragma% misplaced, must be before first declaration");
1297 end Check_Valid_Library_Unit_Pragma;
1303 procedure Error_Pragma (Msg : String) is
1305 Error_Msg_Name_1 := Chars (N);
1306 Error_Msg_N (Msg, N);
1310 ----------------------
1311 -- Error_Pragma_Arg --
1312 ----------------------
1314 procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id) is
1316 Error_Msg_Name_1 := Chars (N);
1317 Error_Msg_N (Msg, Get_Pragma_Arg (Arg));
1319 end Error_Pragma_Arg;
1321 procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id) is
1323 Error_Msg_Name_1 := Chars (N);
1324 Error_Msg_N (Msg1, Get_Pragma_Arg (Arg));
1325 Error_Pragma_Arg (Msg2, Arg);
1326 end Error_Pragma_Arg;
1328 ----------------------------
1329 -- Error_Pragma_Arg_Ident --
1330 ----------------------------
1332 procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id) is
1334 Error_Msg_Name_1 := Chars (N);
1335 Error_Msg_N (Msg, Arg);
1337 end Error_Pragma_Arg_Ident;
1339 ------------------------
1340 -- Find_Lib_Unit_Name --
1341 ------------------------
1343 function Find_Lib_Unit_Name return Entity_Id is
1345 -- Return inner compilation unit entity, for case of nested
1346 -- categorization pragmas. This happens in generic unit.
1348 if Nkind (Parent (N)) = N_Package_Specification
1349 and then Defining_Entity (Parent (N)) /= Current_Scope
1351 return Defining_Entity (Parent (N));
1353 return Current_Scope;
1355 end Find_Lib_Unit_Name;
1357 ----------------------------
1358 -- Find_Program_Unit_Name --
1359 ----------------------------
1361 procedure Find_Program_Unit_Name (Id : Node_Id) is
1362 Unit_Name : Entity_Id;
1363 Unit_Kind : Node_Kind;
1364 P : constant Node_Id := Parent (N);
1367 if Nkind (P) = N_Compilation_Unit then
1368 Unit_Kind := Nkind (Unit (P));
1370 if Unit_Kind = N_Subprogram_Declaration
1371 or else Unit_Kind = N_Package_Declaration
1372 or else Unit_Kind in N_Generic_Declaration
1374 Unit_Name := Defining_Entity (Unit (P));
1376 if Chars (Id) = Chars (Unit_Name) then
1377 Set_Entity (Id, Unit_Name);
1378 Set_Etype (Id, Etype (Unit_Name));
1380 Set_Etype (Id, Any_Type);
1382 ("cannot find program unit referenced by pragma%");
1386 Set_Etype (Id, Any_Type);
1387 Error_Pragma ("pragma% inapplicable to this unit");
1394 end Find_Program_Unit_Name;
1396 -------------------------
1397 -- Gather_Associations --
1398 -------------------------
1400 procedure Gather_Associations
1402 Args : out Args_List)
1407 -- Initialize all parameters to Empty
1409 for J in Args'Range loop
1413 -- That's all we have to do if there are no argument associations
1415 if No (Pragma_Argument_Associations (N)) then
1419 -- Otherwise first deal with any positional parameters present
1421 Arg := First (Pragma_Argument_Associations (N));
1423 for Index in Args'Range loop
1424 exit when No (Arg) or else Chars (Arg) /= No_Name;
1425 Args (Index) := Expression (Arg);
1429 -- Positional parameters all processed, if any left, then we
1430 -- have too many positional parameters.
1432 if Present (Arg) and then Chars (Arg) = No_Name then
1434 ("too many positional associations for pragma%", Arg);
1437 -- Process named parameters if any are present
1439 while Present (Arg) loop
1440 if Chars (Arg) = No_Name then
1442 ("positional association cannot follow named association",
1446 for Index in Names'Range loop
1447 if Names (Index) = Chars (Arg) then
1448 if Present (Args (Index)) then
1450 ("duplicate argument association for pragma%", Arg);
1452 Args (Index) := Expression (Arg);
1457 if Index = Names'Last then
1458 Error_Msg_Name_1 := Chars (N);
1459 Error_Msg_N ("pragma% does not allow & argument", Arg);
1461 -- Check for possible misspelling
1463 for Index1 in Names'Range loop
1464 if Is_Bad_Spelling_Of
1465 (Get_Name_String (Chars (Arg)),
1466 Get_Name_String (Names (Index1)))
1468 Error_Msg_Name_1 := Names (Index1);
1469 Error_Msg_N ("\possible misspelling of%", Arg);
1481 end Gather_Associations;
1483 --------------------
1484 -- Get_Pragma_Arg --
1485 --------------------
1487 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id is
1489 if Nkind (Arg) = N_Pragma_Argument_Association then
1490 return Expression (Arg);
1500 procedure GNAT_Pragma is
1502 Check_Restriction (No_Implementation_Pragmas, N);
1505 --------------------------
1506 -- Is_Before_First_Decl --
1507 --------------------------
1509 function Is_Before_First_Decl
1510 (Pragma_Node : Node_Id;
1511 Decls : List_Id) return Boolean
1513 Item : Node_Id := First (Decls);
1516 -- Only other pragmas can come before this pragma
1519 if No (Item) or else Nkind (Item) /= N_Pragma then
1522 elsif Item = Pragma_Node then
1528 end Is_Before_First_Decl;
1530 -----------------------------
1531 -- Is_Configuration_Pragma --
1532 -----------------------------
1534 -- A configuration pragma must appear in the context clause of
1535 -- a compilation unit, at the start of the list (i.e. only other
1536 -- pragmas may precede it).
1538 function Is_Configuration_Pragma return Boolean is
1539 Lis : constant List_Id := List_Containing (N);
1540 Par : constant Node_Id := Parent (N);
1544 -- If no parent, then we are in the configuration pragma file,
1545 -- so the placement is definitely appropriate.
1550 -- Otherwise we must be in the context clause of a compilation unit
1551 -- and the only thing allowed before us in the context list is more
1552 -- configuration pragmas.
1554 elsif Nkind (Par) = N_Compilation_Unit
1555 and then Context_Items (Par) = Lis
1562 elsif Nkind (Prg) /= N_Pragma then
1572 end Is_Configuration_Pragma;
1574 ----------------------
1575 -- Pragma_Misplaced --
1576 ----------------------
1578 procedure Pragma_Misplaced is
1580 Error_Pragma ("incorrect placement of pragma%");
1581 end Pragma_Misplaced;
1583 ------------------------------------
1584 -- Process Atomic_Shared_Volatile --
1585 ------------------------------------
1587 procedure Process_Atomic_Shared_Volatile is
1595 Check_Ada_83_Warning;
1596 Check_No_Identifiers;
1597 Check_Arg_Count (1);
1598 Check_Arg_Is_Local_Name (Arg1);
1599 E_Id := Expression (Arg1);
1601 if Etype (E_Id) = Any_Type then
1606 D := Declaration_Node (E);
1610 if Rep_Item_Too_Early (E, N)
1612 Rep_Item_Too_Late (E, N)
1616 Check_First_Subtype (Arg1);
1619 if Prag_Id /= Pragma_Volatile then
1621 Set_Is_Atomic (Underlying_Type (E));
1624 -- Attribute belongs on the base type. If the
1625 -- view of the type is currently private, it also
1626 -- belongs on the underlying type.
1628 Set_Is_Volatile (Base_Type (E));
1629 Set_Is_Volatile (Underlying_Type (E));
1631 Set_Treat_As_Volatile (E);
1632 Set_Treat_As_Volatile (Underlying_Type (E));
1634 elsif K = N_Object_Declaration
1635 or else (K = N_Component_Declaration
1636 and then Original_Record_Component (E) = E)
1638 if Rep_Item_Too_Late (E, N) then
1642 if Prag_Id /= Pragma_Volatile then
1645 -- If the object declaration has an explicit
1646 -- initialization, a temporary may have to be
1647 -- created to hold the expression, to insure
1648 -- that access to the object remain atomic.
1650 if Nkind (Parent (E)) = N_Object_Declaration
1651 and then Present (Expression (Parent (E)))
1653 Set_Has_Delayed_Freeze (E);
1656 -- An interesting improvement here. If an object of type X
1657 -- is declared atomic, and the type X is not atomic, that's
1658 -- a pity, since it may not have appropraite alignment etc.
1659 -- We can rescue this in the special case where the object
1660 -- and type are in the same unit by just setting the type
1661 -- as atomic, so that the back end will process it as atomic.
1663 Utyp := Underlying_Type (Etype (E));
1666 and then Sloc (E) > No_Location
1667 and then Sloc (Utyp) > No_Location
1669 Get_Source_File_Index (Sloc (E)) =
1670 Get_Source_File_Index (Sloc (Underlying_Type (Etype (E))))
1672 Set_Is_Atomic (Underlying_Type (Etype (E)));
1676 Set_Is_Volatile (E);
1677 Set_Treat_As_Volatile (E);
1681 ("inappropriate entity for pragma%", Arg1);
1683 end Process_Atomic_Shared_Volatile;
1685 ------------------------
1686 -- Process_Convention --
1687 ------------------------
1689 procedure Process_Convention
1690 (C : out Convention_Id;
1695 Comp_Unit : Unit_Number_Type;
1698 procedure Set_Convention_From_Pragma (E : Entity_Id);
1699 -- Set convention in entity E, and also flag that the entity has a
1700 -- convention pragma. If entity is for a private or incomplete type,
1701 -- also set convention and flag on underlying type. This procedure
1702 -- also deals with the special case of C_Pass_By_Copy convention.
1704 --------------------------------
1705 -- Set_Convention_From_Pragma --
1706 --------------------------------
1708 procedure Set_Convention_From_Pragma (E : Entity_Id) is
1710 Set_Convention (E, C);
1711 Set_Has_Convention_Pragma (E);
1713 if Is_Incomplete_Or_Private_Type (E) then
1714 Set_Convention (Underlying_Type (E), C);
1715 Set_Has_Convention_Pragma (Underlying_Type (E), True);
1718 -- A class-wide type should inherit the convention of
1719 -- the specific root type (although this isn't specified
1720 -- clearly by the RM).
1722 if Is_Type (E) and then Present (Class_Wide_Type (E)) then
1723 Set_Convention (Class_Wide_Type (E), C);
1726 -- If the entity is a record type, then check for special case
1727 -- of C_Pass_By_Copy, which is treated the same as C except that
1728 -- the special record flag is set. This convention is also only
1729 -- permitted on record types (see AI95-00131).
1731 if Cname = Name_C_Pass_By_Copy then
1732 if Is_Record_Type (E) then
1733 Set_C_Pass_By_Copy (Base_Type (E));
1734 elsif Is_Incomplete_Or_Private_Type (E)
1735 and then Is_Record_Type (Underlying_Type (E))
1737 Set_C_Pass_By_Copy (Base_Type (Underlying_Type (E)));
1740 ("C_Pass_By_Copy convention allowed only for record type",
1745 -- If the entity is a derived boolean type, check for the
1746 -- special case of convention C, C++, or Fortran, where we
1747 -- consider any nonzero value to represent true.
1749 if Is_Discrete_Type (E)
1750 and then Root_Type (Etype (E)) = Standard_Boolean
1756 C = Convention_Fortran)
1758 Set_Nonzero_Is_True (Base_Type (E));
1760 end Set_Convention_From_Pragma;
1762 -- Start of processing for Process_Convention
1765 Check_At_Least_N_Arguments (2);
1766 Check_Arg_Is_Identifier (Arg1);
1767 Check_Optional_Identifier (Arg1, Name_Convention);
1768 Cname := Chars (Expression (Arg1));
1770 -- C_Pass_By_Copy is treated as a synonym for convention C
1771 -- (this is tested again below to set the critical flag)
1773 if Cname = Name_C_Pass_By_Copy then
1776 -- Otherwise we must have something in the standard convention list
1778 elsif Is_Convention_Name (Cname) then
1779 C := Get_Convention_Id (Chars (Expression (Arg1)));
1781 -- In DEC VMS, it seems that there is an undocumented feature
1782 -- that any unrecognized convention is treated as the default,
1783 -- which for us is convention C. It does not seem so terrible
1784 -- to do this unconditionally, silently in the VMS case, and
1785 -- with a warning in the non-VMS case.
1788 if Warn_On_Export_Import and not OpenVMS_On_Target then
1790 ("?unrecognized convention name, C assumed",
1797 Check_Arg_Is_Local_Name (Arg2);
1798 Check_Optional_Identifier (Arg2, Name_Entity);
1800 Id := Expression (Arg2);
1803 if not Is_Entity_Name (Id) then
1804 Error_Pragma_Arg ("entity name required", Arg2);
1809 -- Go to renamed subprogram if present, since convention applies
1810 -- to the actual renamed entity, not to the renaming entity.
1812 if Is_Subprogram (E)
1813 and then Present (Alias (E))
1814 and then Nkind (Parent (Declaration_Node (E))) =
1815 N_Subprogram_Renaming_Declaration
1820 -- Check that we not applying this to a specless body
1822 if Is_Subprogram (E)
1823 and then Nkind (Parent (Declaration_Node (E))) = N_Subprogram_Body
1826 ("pragma% requires separate spec and must come before body");
1829 -- Check that we are not applying this to a named constant
1831 if Ekind (E) = E_Named_Integer
1833 Ekind (E) = E_Named_Real
1835 Error_Msg_Name_1 := Chars (N);
1837 ("cannot apply pragma% to named constant!",
1838 Get_Pragma_Arg (Arg2));
1840 ("\supply appropriate type for&!", Arg2);
1843 if Etype (E) = Any_Type
1844 or else Rep_Item_Too_Early (E, N)
1848 E := Underlying_Type (E);
1851 if Rep_Item_Too_Late (E, N) then
1855 if Has_Convention_Pragma (E) then
1857 ("at most one Convention/Export/Import pragma is allowed", Arg2);
1859 elsif Convention (E) = Convention_Protected
1860 or else Ekind (Scope (E)) = E_Protected_Type
1863 ("a protected operation cannot be given a different convention",
1867 -- For Intrinsic, a subprogram is required
1869 if C = Convention_Intrinsic
1870 and then not Is_Subprogram (E)
1871 and then not Is_Generic_Subprogram (E)
1874 ("second argument of pragma% must be a subprogram", Arg2);
1877 -- For Stdcall, a subprogram, variable or subprogram type is required
1879 if C = Convention_Stdcall
1880 and then not Is_Subprogram (E)
1881 and then not Is_Generic_Subprogram (E)
1882 and then Ekind (E) /= E_Variable
1885 and then Ekind (Designated_Type (E)) = E_Subprogram_Type)
1888 ("second argument of pragma% must be subprogram (type)",
1892 if not Is_Subprogram (E)
1893 and then not Is_Generic_Subprogram (E)
1895 Set_Convention_From_Pragma (E);
1899 Check_First_Subtype (Arg2);
1900 Set_Convention_From_Pragma (Base_Type (E));
1902 -- For subprograms, we must set the convention on the
1903 -- internally generated directly designated type as well.
1905 if Ekind (E) = E_Access_Subprogram_Type then
1906 Set_Convention_From_Pragma (Directly_Designated_Type (E));
1910 -- For the subprogram case, set proper convention for all homonyms
1911 -- in same compilation unit.
1912 -- Is the test of compilation unit really necessary ???
1913 -- What about subprogram renamings here???
1916 Comp_Unit := Get_Source_Unit (E);
1917 Set_Convention_From_Pragma (E);
1919 -- Treat a pragma Import as an implicit body, for GPS use.
1921 if Prag_Id = Pragma_Import then
1922 Generate_Reference (E, Id, 'b');
1928 exit when No (E1) or else Scope (E1) /= Current_Scope;
1930 -- Note: below we are missing a check for Rep_Item_Too_Late.
1931 -- That is deliberate, we cannot chain the rep item on more
1932 -- than one Rep_Item chain, to be fixed later ???
1934 if Comp_Unit = Get_Source_Unit (E1) then
1935 Set_Convention_From_Pragma (E1);
1937 if Prag_Id = Pragma_Import then
1938 Generate_Reference (E, Id, 'b');
1943 end Process_Convention;
1945 -----------------------------------------------------
1946 -- Process_Extended_Import_Export_Exception_Pragma --
1947 -----------------------------------------------------
1949 procedure Process_Extended_Import_Export_Exception_Pragma
1950 (Arg_Internal : Node_Id;
1951 Arg_External : Node_Id;
1961 if not OpenVMS_On_Target then
1963 ("?pragma% ignored (applies only to Open'V'M'S)");
1966 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
1967 Def_Id := Entity (Arg_Internal);
1969 if Ekind (Def_Id) /= E_Exception then
1971 ("pragma% must refer to declared exception", Arg_Internal);
1974 Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
1976 if Present (Arg_Form) then
1977 Check_Arg_Is_One_Of (Arg_Form, Name_Ada, Name_VMS);
1980 if Present (Arg_Form)
1981 and then Chars (Arg_Form) = Name_Ada
1985 Set_Is_VMS_Exception (Def_Id);
1986 Set_Exception_Code (Def_Id, No_Uint);
1989 if Present (Arg_Code) then
1990 if not Is_VMS_Exception (Def_Id) then
1992 ("Code option for pragma% not allowed for Ada case",
1996 Check_Arg_Is_Static_Expression (Arg_Code, Any_Integer);
1997 Code_Val := Expr_Value (Arg_Code);
1999 if not UI_Is_In_Int_Range (Code_Val) then
2001 ("Code option for pragma% must be in 32-bit range",
2005 Set_Exception_Code (Def_Id, Code_Val);
2008 end Process_Extended_Import_Export_Exception_Pragma;
2010 -------------------------------------------------
2011 -- Process_Extended_Import_Export_Internal_Arg --
2012 -------------------------------------------------
2014 procedure Process_Extended_Import_Export_Internal_Arg
2015 (Arg_Internal : Node_Id := Empty)
2020 if No (Arg_Internal) then
2021 Error_Pragma ("Internal parameter required for pragma%");
2024 if Nkind (Arg_Internal) = N_Identifier then
2027 elsif Nkind (Arg_Internal) = N_Operator_Symbol
2028 and then (Prag_Id = Pragma_Import_Function
2030 Prag_Id = Pragma_Export_Function)
2036 ("wrong form for Internal parameter for pragma%", Arg_Internal);
2039 Check_Arg_Is_Local_Name (Arg_Internal);
2040 end Process_Extended_Import_Export_Internal_Arg;
2042 --------------------------------------------------
2043 -- Process_Extended_Import_Export_Object_Pragma --
2044 --------------------------------------------------
2046 procedure Process_Extended_Import_Export_Object_Pragma
2047 (Arg_Internal : Node_Id;
2048 Arg_External : Node_Id;
2054 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2055 Def_Id := Entity (Arg_Internal);
2057 if Ekind (Def_Id) /= E_Constant
2058 and then Ekind (Def_Id) /= E_Variable
2061 ("pragma% must designate an object", Arg_Internal);
2064 if Is_Psected (Def_Id) then
2066 ("previous Psect_Object applies, pragma % not permitted",
2070 if Rep_Item_Too_Late (Def_Id, N) then
2074 Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2076 if Present (Arg_Size)
2077 and then Nkind (Arg_Size) /= N_Identifier
2078 and then Nkind (Arg_Size) /= N_String_Literal
2081 ("pragma% Size argument must be identifier or string literal",
2085 -- Export_Object case
2087 if Prag_Id = Pragma_Export_Object then
2088 if not Is_Library_Level_Entity (Def_Id) then
2090 ("argument for pragma% must be library level entity",
2094 if Ekind (Current_Scope) = E_Generic_Package then
2095 Error_Pragma ("pragma& cannot appear in a generic unit");
2098 if not Size_Known_At_Compile_Time (Etype (Def_Id)) then
2100 ("exported object must have compile time known size",
2104 if Warn_On_Export_Import and then Is_Exported (Def_Id) then
2106 ("?duplicate Export_Object pragma", N);
2108 Set_Exported (Def_Id, Arg_Internal);
2111 -- Import_Object case
2114 if Is_Concurrent_Type (Etype (Def_Id)) then
2116 ("cannot use pragma% for task/protected object",
2120 if Ekind (Def_Id) = E_Constant then
2122 ("cannot import a constant", Arg_Internal);
2125 if Warn_On_Export_Import
2126 and then Has_Discriminants (Etype (Def_Id))
2129 ("imported value must be initialized?", Arg_Internal);
2132 if Warn_On_Export_Import
2133 and then Is_Access_Type (Etype (Def_Id))
2136 ("cannot import object of an access type?", Arg_Internal);
2139 if Warn_On_Export_Import
2140 and then Is_Imported (Def_Id)
2143 ("?duplicate Import_Object pragma", N);
2145 -- Check for explicit initialization present. Note that an
2146 -- initialization that generated by the code generator, e.g.
2147 -- for an access type, does not count here.
2149 elsif Present (Expression (Parent (Def_Id)))
2152 (Original_Node (Expression (Parent (Def_Id))))
2154 Error_Msg_Sloc := Sloc (Def_Id);
2156 ("no initialization allowed for declaration of& #",
2157 "\imported entities cannot be initialized ('R'M' 'B.1(24))",
2160 Set_Imported (Def_Id);
2161 Note_Possible_Modification (Arg_Internal);
2164 end Process_Extended_Import_Export_Object_Pragma;
2166 ------------------------------------------------------
2167 -- Process_Extended_Import_Export_Subprogram_Pragma --
2168 ------------------------------------------------------
2170 procedure Process_Extended_Import_Export_Subprogram_Pragma
2171 (Arg_Internal : Node_Id;
2172 Arg_External : Node_Id;
2173 Arg_Parameter_Types : Node_Id;
2174 Arg_Result_Type : Node_Id := Empty;
2175 Arg_Mechanism : Node_Id;
2176 Arg_Result_Mechanism : Node_Id := Empty;
2177 Arg_First_Optional_Parameter : Node_Id := Empty)
2183 Ambiguous : Boolean;
2187 function Same_Base_Type
2189 Formal : Entity_Id) return Boolean;
2190 -- Determines if Ptype references the type of Formal. Note that
2191 -- only the base types need to match according to the spec. Ptype
2192 -- here is the argument from the pragma, which is either a type
2193 -- name, or an access attribute.
2195 --------------------
2196 -- Same_Base_Type --
2197 --------------------
2199 function Same_Base_Type
2201 Formal : Entity_Id) return Boolean
2203 Ftyp : constant Entity_Id := Base_Type (Etype (Formal));
2207 -- Case where pragma argument is typ'Access
2209 if Nkind (Ptype) = N_Attribute_Reference
2210 and then Attribute_Name (Ptype) = Name_Access
2212 Pref := Prefix (Ptype);
2215 if not Is_Entity_Name (Pref)
2216 or else Entity (Pref) = Any_Type
2221 -- We have a match if the corresponding argument is of an
2222 -- anonymous access type, and its designicated type matches
2223 -- the type of the prefix of the access attribute
2225 return Ekind (Ftyp) = E_Anonymous_Access_Type
2226 and then Base_Type (Entity (Pref)) =
2227 Base_Type (Etype (Designated_Type (Ftyp)));
2229 -- Case where pragma argument is a type name
2234 if not Is_Entity_Name (Ptype)
2235 or else Entity (Ptype) = Any_Type
2240 -- We have a match if the corresponding argument is of
2241 -- the type given in the pragma (comparing base types)
2243 return Base_Type (Entity (Ptype)) = Ftyp;
2247 -- Start of processing for
2248 -- Process_Extended_Import_Export_Subprogram_Pragma
2251 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2252 Hom_Id := Entity (Arg_Internal);
2256 -- Loop through homonyms (overloadings) of Hom_Id
2258 while Present (Hom_Id) loop
2259 Def_Id := Get_Base_Subprogram (Hom_Id);
2261 -- We need a subprogram in the current scope
2263 if not Is_Subprogram (Def_Id)
2264 or else Scope (Def_Id) /= Current_Scope
2271 -- Pragma cannot apply to subprogram body
2273 if Is_Subprogram (Def_Id)
2276 (Declaration_Node (Def_Id))) = N_Subprogram_Body
2279 ("pragma% requires separate spec"
2280 & " and must come before body");
2283 -- Test result type if given, note that the result type
2284 -- parameter can only be present for the function cases.
2286 if Present (Arg_Result_Type)
2287 and then not Same_Base_Type (Arg_Result_Type, Def_Id)
2291 elsif Etype (Def_Id) /= Standard_Void_Type
2293 (Chars (N) = Name_Export_Procedure
2294 or else Chars (N) = Name_Import_Procedure)
2298 -- Test parameter types if given. Note that this parameter
2299 -- has not been analyzed (and must not be, since it is
2300 -- semantic nonsense), so we get it as the parser left it.
2302 elsif Present (Arg_Parameter_Types) then
2303 Check_Matching_Types : declare
2308 Formal := First_Formal (Def_Id);
2310 if Nkind (Arg_Parameter_Types) = N_Null then
2311 if Present (Formal) then
2315 -- A list of one type, e.g. (List) is parsed as
2316 -- a parenthesized expression.
2318 elsif Nkind (Arg_Parameter_Types) /= N_Aggregate
2319 and then Paren_Count (Arg_Parameter_Types) = 1
2322 or else Present (Next_Formal (Formal))
2327 Same_Base_Type (Arg_Parameter_Types, Formal);
2330 -- A list of more than one type is parsed as a aggregate
2332 elsif Nkind (Arg_Parameter_Types) = N_Aggregate
2333 and then Paren_Count (Arg_Parameter_Types) = 0
2335 Ptype := First (Expressions (Arg_Parameter_Types));
2337 while Present (Ptype) or else Present (Formal) loop
2340 or else not Same_Base_Type (Ptype, Formal)
2345 Next_Formal (Formal);
2350 -- Anything else is of the wrong form
2354 ("wrong form for Parameter_Types parameter",
2355 Arg_Parameter_Types);
2357 end Check_Matching_Types;
2360 -- Match is now False if the entry we found did not match
2361 -- either a supplied Parameter_Types or Result_Types argument
2367 -- Ambiguous case, the flag Ambiguous shows if we already
2368 -- detected this and output the initial messages.
2371 if not Ambiguous then
2373 Error_Msg_Name_1 := Chars (N);
2375 ("pragma% does not uniquely identify subprogram!",
2377 Error_Msg_Sloc := Sloc (Ent);
2378 Error_Msg_N ("matching subprogram #!", N);
2382 Error_Msg_Sloc := Sloc (Def_Id);
2383 Error_Msg_N ("matching subprogram #!", N);
2388 Hom_Id := Homonym (Hom_Id);
2391 -- See if we found an entry
2394 if not Ambiguous then
2395 if Is_Generic_Subprogram (Entity (Arg_Internal)) then
2397 ("pragma% cannot be given for generic subprogram");
2401 ("pragma% does not identify local subprogram");
2408 -- Import pragmas must be be for imported entities
2410 if Prag_Id = Pragma_Import_Function
2412 Prag_Id = Pragma_Import_Procedure
2414 Prag_Id = Pragma_Import_Valued_Procedure
2416 if not Is_Imported (Ent) then
2418 ("pragma Import or Interface must precede pragma%");
2421 -- Here we have the Export case which can set the entity as exported
2423 -- But does not do so if the specified external name is null,
2424 -- since that is taken as a signal in DEC Ada 83 (with which
2425 -- we want to be compatible) to request no external name.
2427 elsif Nkind (Arg_External) = N_String_Literal
2428 and then String_Length (Strval (Arg_External)) = 0
2432 -- In all other cases, set entit as exported
2435 Set_Exported (Ent, Arg_Internal);
2438 -- Special processing for Valued_Procedure cases
2440 if Prag_Id = Pragma_Import_Valued_Procedure
2442 Prag_Id = Pragma_Export_Valued_Procedure
2444 Formal := First_Formal (Ent);
2448 ("at least one parameter required for pragma%");
2450 elsif Ekind (Formal) /= E_Out_Parameter then
2452 ("first parameter must have mode out for pragma%");
2455 Set_Is_Valued_Procedure (Ent);
2459 Set_Extended_Import_Export_External_Name (Ent, Arg_External);
2461 -- Process Result_Mechanism argument if present. We have already
2462 -- checked that this is only allowed for the function case.
2464 if Present (Arg_Result_Mechanism) then
2465 Set_Mechanism_Value (Ent, Arg_Result_Mechanism);
2468 -- Process Mechanism parameter if present. Note that this parameter
2469 -- is not analyzed, and must not be analyzed since it is semantic
2470 -- nonsense, so we get it in exactly as the parser left it.
2472 if Present (Arg_Mechanism) then
2480 -- A single mechanism association without a formal parameter
2481 -- name is parsed as a parenthesized expression. All other
2482 -- cases are parsed as aggregates, so we rewrite the single
2483 -- parameter case as an aggregate for consistency.
2485 if Nkind (Arg_Mechanism) /= N_Aggregate
2486 and then Paren_Count (Arg_Mechanism) = 1
2488 Rewrite (Arg_Mechanism,
2489 Make_Aggregate (Sloc (Arg_Mechanism),
2490 Expressions => New_List (
2491 Relocate_Node (Arg_Mechanism))));
2494 -- Case of only mechanism name given, applies to all formals
2496 if Nkind (Arg_Mechanism) /= N_Aggregate then
2497 Formal := First_Formal (Ent);
2498 while Present (Formal) loop
2499 Set_Mechanism_Value (Formal, Arg_Mechanism);
2500 Next_Formal (Formal);
2503 -- Case of list of mechanism associations given
2506 if Null_Record_Present (Arg_Mechanism) then
2508 ("inappropriate form for Mechanism parameter",
2512 -- Deal with positional ones first
2514 Formal := First_Formal (Ent);
2515 if Present (Expressions (Arg_Mechanism)) then
2516 Mname := First (Expressions (Arg_Mechanism));
2518 while Present (Mname) loop
2521 ("too many mechanism associations", Mname);
2524 Set_Mechanism_Value (Formal, Mname);
2525 Next_Formal (Formal);
2530 -- Deal with named entries
2532 if Present (Component_Associations (Arg_Mechanism)) then
2533 Massoc := First (Component_Associations (Arg_Mechanism));
2535 while Present (Massoc) loop
2536 Choice := First (Choices (Massoc));
2538 if Nkind (Choice) /= N_Identifier
2539 or else Present (Next (Choice))
2542 ("incorrect form for mechanism association",
2546 Formal := First_Formal (Ent);
2550 ("parameter name & not present", Choice);
2553 if Chars (Choice) = Chars (Formal) then
2555 (Formal, Expression (Massoc));
2559 Next_Formal (Formal);
2569 -- Process First_Optional_Parameter argument if present. We have
2570 -- already checked that this is only allowed for the Import case.
2572 if Present (Arg_First_Optional_Parameter) then
2573 if Nkind (Arg_First_Optional_Parameter) /= N_Identifier then
2575 ("first optional parameter must be formal parameter name",
2576 Arg_First_Optional_Parameter);
2579 Formal := First_Formal (Ent);
2583 ("specified formal parameter& not found",
2584 Arg_First_Optional_Parameter);
2587 exit when Chars (Formal) =
2588 Chars (Arg_First_Optional_Parameter);
2590 Next_Formal (Formal);
2593 Set_First_Optional_Parameter (Ent, Formal);
2595 -- Check specified and all remaining formals have right form
2597 while Present (Formal) loop
2598 if Ekind (Formal) /= E_In_Parameter then
2600 ("optional formal& is not of mode in!",
2601 Arg_First_Optional_Parameter, Formal);
2604 Dval := Default_Value (Formal);
2606 if not Present (Dval) then
2608 ("optional formal& does not have default value!",
2609 Arg_First_Optional_Parameter, Formal);
2611 elsif Compile_Time_Known_Value_Or_Aggr (Dval) then
2616 ("default value for optional formal& is non-static!",
2617 Arg_First_Optional_Parameter, Formal);
2621 Set_Is_Optional_Parameter (Formal);
2622 Next_Formal (Formal);
2625 end Process_Extended_Import_Export_Subprogram_Pragma;
2627 --------------------------
2628 -- Process_Generic_List --
2629 --------------------------
2631 procedure Process_Generic_List is
2637 Check_No_Identifiers;
2638 Check_At_Least_N_Arguments (1);
2641 while Present (Arg) loop
2642 Exp := Expression (Arg);
2645 if not Is_Entity_Name (Exp)
2647 (not Is_Generic_Instance (Entity (Exp))
2649 not Is_Generic_Unit (Entity (Exp)))
2652 ("pragma% argument must be name of generic unit/instance",
2658 end Process_Generic_List;
2660 ---------------------------------
2661 -- Process_Import_Or_Interface --
2662 ---------------------------------
2664 procedure Process_Import_Or_Interface is
2670 Process_Convention (C, Def_Id);
2671 Kill_Size_Check_Code (Def_Id);
2672 Note_Possible_Modification (Expression (Arg2));
2674 if Ekind (Def_Id) = E_Variable
2676 Ekind (Def_Id) = E_Constant
2678 -- User initialization is not allowed for imported object, but
2679 -- the object declaration may contain a default initialization,
2680 -- that will be discarded. Note that an explicit initialization
2681 -- only counts if it comes from source, otherwise it is simply
2682 -- the code generator making an implicit initialization explicit.
2684 if Present (Expression (Parent (Def_Id)))
2685 and then Comes_From_Source (Expression (Parent (Def_Id)))
2687 Error_Msg_Sloc := Sloc (Def_Id);
2689 ("no initialization allowed for declaration of& #",
2690 "\imported entities cannot be initialized ('R'M' 'B.1(24))",
2694 Set_Imported (Def_Id);
2695 Set_Is_Public (Def_Id);
2696 Process_Interface_Name (Def_Id, Arg3, Arg4);
2698 -- It is not possible to import a constant of an unconstrained
2699 -- array type (e.g. string) because there is no simple way to
2700 -- write a meaningful subtype for it.
2702 if Is_Array_Type (Etype (Def_Id))
2703 and then not Is_Constrained (Etype (Def_Id))
2706 ("imported constant& must have a constrained subtype",
2711 elsif Is_Subprogram (Def_Id)
2712 or else Is_Generic_Subprogram (Def_Id)
2714 -- If the name is overloaded, pragma applies to all of the
2715 -- denoted entities in the same declarative part.
2719 while Present (Hom_Id) loop
2720 Def_Id := Get_Base_Subprogram (Hom_Id);
2722 -- Ignore inherited subprograms because the pragma will
2723 -- apply to the parent operation, which is the one called.
2725 if Is_Overloadable (Def_Id)
2726 and then Present (Alias (Def_Id))
2730 -- If it is not a subprogram, it must be in an outer
2731 -- scope and pragma does not apply.
2733 elsif not Is_Subprogram (Def_Id)
2734 and then not Is_Generic_Subprogram (Def_Id)
2738 -- Verify that the homonym is in the same declarative
2739 -- part (not just the same scope).
2741 elsif Parent (Unit_Declaration_Node (Def_Id)) /= Parent (N)
2742 and then Nkind (Parent (N)) /= N_Compilation_Unit_Aux
2747 Set_Imported (Def_Id);
2749 -- If Import intrinsic, set intrinsic flag
2750 -- and verify that it is known as such.
2752 if C = Convention_Intrinsic then
2753 Set_Is_Intrinsic_Subprogram (Def_Id);
2754 Check_Intrinsic_Subprogram
2755 (Def_Id, Expression (Arg2));
2758 -- All interfaced procedures need an external
2759 -- symbol created for them since they are
2760 -- always referenced from another object file.
2762 Set_Is_Public (Def_Id);
2764 -- Verify that the subprogram does not have a completion
2765 -- through a renaming declaration. For other completions
2766 -- the pragma appears as a too late representation.
2769 Decl : constant Node_Id := Unit_Declaration_Node (Def_Id);
2773 and then Nkind (Decl) = N_Subprogram_Declaration
2774 and then Present (Corresponding_Body (Decl))
2777 (Unit_Declaration_Node
2778 (Corresponding_Body (Decl))) =
2779 N_Subprogram_Renaming_Declaration
2781 Error_Msg_Sloc := Sloc (Def_Id);
2782 Error_Msg_NE ("cannot import&#," &
2783 " already completed by a renaming",
2788 Set_Has_Completion (Def_Id);
2789 Process_Interface_Name (Def_Id, Arg3, Arg4);
2792 if Is_Compilation_Unit (Hom_Id) then
2794 -- Its possible homonyms are not affected by the pragma.
2795 -- Such homonyms might be present in the context of other
2796 -- units being compiled.
2801 Hom_Id := Homonym (Hom_Id);
2805 -- When the convention is Java, we also allow Import to be given
2806 -- for packages, exceptions, and record components.
2808 elsif C = Convention_Java
2810 (Ekind (Def_Id) = E_Package
2811 or else Ekind (Def_Id) = E_Exception
2812 or else Nkind (Parent (Def_Id)) = N_Component_Declaration)
2814 Set_Imported (Def_Id);
2815 Set_Is_Public (Def_Id);
2816 Process_Interface_Name (Def_Id, Arg3, Arg4);
2820 ("second argument of pragma% must be object or subprogram",
2824 -- If this pragma applies to a compilation unit, then the unit,
2825 -- which is a subprogram, does not require (or allow) a body.
2826 -- We also do not need to elaborate imported procedures.
2828 if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
2830 Cunit : constant Node_Id := Parent (Parent (N));
2832 Set_Body_Required (Cunit, False);
2835 end Process_Import_Or_Interface;
2837 --------------------
2838 -- Process_Inline --
2839 --------------------
2841 procedure Process_Inline (Active : Boolean) is
2847 Effective : Boolean := False;
2849 procedure Make_Inline (Subp : Entity_Id);
2850 -- Subp is the defining unit name of the subprogram
2851 -- declaration. Set the flag, as well as the flag in the
2852 -- corresponding body, if there is one present.
2854 procedure Set_Inline_Flags (Subp : Entity_Id);
2855 -- Sets Is_Inlined and Has_Pragma_Inline flags for Subp
2857 function Back_End_Cannot_Inline (Subp : Entity_Id) return Boolean;
2858 -- Do not set the inline flag if body is available and contains
2859 -- exception handlers, to prevent undefined symbols at link time.
2861 ----------------------------
2862 -- Back_End_Cannot_Inline --
2863 ----------------------------
2865 function Back_End_Cannot_Inline (Subp : Entity_Id) return Boolean is
2866 Decl : constant Node_Id := Unit_Declaration_Node (Subp);
2869 if Nkind (Decl) = N_Subprogram_Body then
2872 (Exception_Handlers (Handled_Statement_Sequence (Decl)));
2874 elsif Nkind (Decl) = N_Subprogram_Declaration
2875 and then Present (Corresponding_Body (Decl))
2877 -- If the subprogram is a renaming as body, the body is
2878 -- just a call to the renamed subprogram, and inlining is
2879 -- trivially possible.
2881 if Nkind (Unit_Declaration_Node (Corresponding_Body (Decl))) =
2882 N_Subprogram_Renaming_Declaration
2888 Present (Exception_Handlers
2889 (Handled_Statement_Sequence
2890 (Unit_Declaration_Node (Corresponding_Body (Decl)))));
2893 -- If body is not available, assume the best, the check is
2894 -- performed again when compiling enclosing package bodies.
2898 end Back_End_Cannot_Inline;
2904 procedure Make_Inline (Subp : Entity_Id) is
2905 Kind : constant Entity_Kind := Ekind (Subp);
2906 Inner_Subp : Entity_Id := Subp;
2909 if Etype (Subp) = Any_Type then
2912 elsif Back_End_Cannot_Inline (Subp) then
2913 Applies := True; -- Do not treat as an error.
2916 -- Here we have a candidate for inlining, but we must exclude
2917 -- derived operations. Otherwise we will end up trying to
2918 -- inline a phantom declaration, and the result would be to
2919 -- drag in a body which has no direct inlining associated with
2920 -- it. That would not only be inefficient but would also result
2921 -- in the backend doing cross-unit inlining in cases where it
2922 -- was definitely inappropriate to do so.
2924 -- However, a simple Comes_From_Source test is insufficient,
2925 -- since we do want to allow inlining of generic instances,
2926 -- which also do not come from source. Predefined operators do
2927 -- not come from source but are not inlineable either.
2929 elsif not Comes_From_Source (Subp)
2930 and then not Is_Generic_Instance (Subp)
2931 and then Scope (Subp) /= Standard_Standard
2936 -- The referenced entity must either be the enclosing entity,
2937 -- or an entity declared within the current open scope.
2939 elsif Present (Scope (Subp))
2940 and then Scope (Subp) /= Current_Scope
2941 and then Subp /= Current_Scope
2944 ("argument of% must be entity in current scope", Assoc);
2948 -- Processing for procedure, operator or function.
2949 -- If subprogram is aliased (as for an instance) indicate
2950 -- that the renamed entity is inlined.
2952 if Is_Subprogram (Subp) then
2953 while Present (Alias (Inner_Subp)) loop
2954 Inner_Subp := Alias (Inner_Subp);
2957 Set_Inline_Flags (Inner_Subp);
2959 Decl := Parent (Parent (Inner_Subp));
2961 if Nkind (Decl) = N_Subprogram_Declaration
2962 and then Present (Corresponding_Body (Decl))
2964 Set_Inline_Flags (Corresponding_Body (Decl));
2969 -- For a generic subprogram set flag as well, for use at
2970 -- the point of instantiation, to determine whether the
2971 -- body should be generated.
2973 elsif Is_Generic_Subprogram (Subp) then
2974 Set_Inline_Flags (Subp);
2977 -- Literals are by definition inlined
2979 elsif Kind = E_Enumeration_Literal then
2982 -- Anything else is an error
2986 ("expect subprogram name for pragma%", Assoc);
2990 ----------------------
2991 -- Set_Inline_Flags --
2992 ----------------------
2994 procedure Set_Inline_Flags (Subp : Entity_Id) is
2997 Set_Is_Inlined (Subp, True);
3000 if not Has_Pragma_Inline (Subp) then
3001 Set_Has_Pragma_Inline (Subp);
3002 Set_Next_Rep_Item (N, First_Rep_Item (Subp));
3003 Set_First_Rep_Item (Subp, N);
3006 end Set_Inline_Flags;
3008 -- Start of processing for Process_Inline
3011 Check_No_Identifiers;
3012 Check_At_Least_N_Arguments (1);
3015 Inline_Processing_Required := True;
3019 while Present (Assoc) loop
3020 Subp_Id := Expression (Assoc);
3024 if Is_Entity_Name (Subp_Id) then
3025 Subp := Entity (Subp_Id);
3027 if Subp = Any_Id then
3033 while Present (Homonym (Subp))
3034 and then Scope (Homonym (Subp)) = Current_Scope
3036 Make_Inline (Homonym (Subp));
3037 Subp := Homonym (Subp);
3044 ("inappropriate argument for pragma%", Assoc);
3047 and then Warn_On_Redundant_Constructs
3049 Error_Msg_NE ("pragma inline on& is redundant?",
3050 N, Entity (Subp_Id));
3057 ----------------------------
3058 -- Process_Interface_Name --
3059 ----------------------------
3061 procedure Process_Interface_Name
3062 (Subprogram_Def : Entity_Id;
3068 String_Val : String_Id;
3070 procedure Check_Form_Of_Interface_Name (SN : Node_Id);
3071 -- SN is a string literal node for an interface name. This routine
3072 -- performs some minimal checks that the name is reasonable. In
3073 -- particular that no spaces or other obviously incorrect characters
3074 -- appear. This is only a warning, since any characters are allowed.
3076 procedure Check_Form_Of_Interface_Name (SN : Node_Id) is
3077 S : constant String_Id := Strval (Expr_Value_S (SN));
3078 SL : constant Nat := String_Length (S);
3083 Error_Msg_N ("interface name cannot be null string", SN);
3086 for J in 1 .. SL loop
3087 C := Get_String_Char (S, J);
3089 if Warn_On_Export_Import
3090 and then (not In_Character_Range (C)
3091 or else Get_Character (C) = ' '
3092 or else Get_Character (C) = ',')
3095 ("?interface name contains illegal character", SN);
3098 end Check_Form_Of_Interface_Name;
3100 -- Start of processing for Process_Interface_Name
3103 if No (Link_Arg) then
3104 if No (Ext_Arg) then
3107 elsif Chars (Ext_Arg) = Name_Link_Name then
3109 Link_Nam := Expression (Ext_Arg);
3112 Check_Optional_Identifier (Ext_Arg, Name_External_Name);
3113 Ext_Nam := Expression (Ext_Arg);
3118 Check_Optional_Identifier (Ext_Arg, Name_External_Name);
3119 Check_Optional_Identifier (Link_Arg, Name_Link_Name);
3120 Ext_Nam := Expression (Ext_Arg);
3121 Link_Nam := Expression (Link_Arg);
3124 -- Check expressions for external name and link name are static
3126 if Present (Ext_Nam) then
3127 Check_Arg_Is_Static_Expression (Ext_Nam, Standard_String);
3128 Check_Form_Of_Interface_Name (Ext_Nam);
3130 -- Verify that the external name is not the name of a local
3131 -- entity, which would hide the imported one and lead to
3132 -- run-time surprises. The problem can only arise for entities
3133 -- declared in a package body (otherwise the external name is
3134 -- fully qualified and won't conflict).
3142 if Prag_Id = Pragma_Import then
3143 String_To_Name_Buffer (Strval (Expr_Value_S (Ext_Nam)));
3145 E := Entity_Id (Get_Name_Table_Info (Nam));
3147 if Nam /= Chars (Subprogram_Def)
3148 and then Present (E)
3149 and then not Is_Overloadable (E)
3150 and then Is_Immediately_Visible (E)
3151 and then not Is_Imported (E)
3152 and then Ekind (Scope (E)) = E_Package
3156 while Present (Par) loop
3157 if Nkind (Par) = N_Package_Body then
3158 Error_Msg_Sloc := Sloc (E);
3160 ("imported entity is hidden by & declared#",
3165 Par := Parent (Par);
3172 if Present (Link_Nam) then
3173 Check_Arg_Is_Static_Expression (Link_Nam, Standard_String);
3174 Check_Form_Of_Interface_Name (Link_Nam);
3177 -- If there is no link name, just set the external name
3179 if No (Link_Nam) then
3180 Set_Encoded_Interface_Name
3181 (Get_Base_Subprogram (Subprogram_Def),
3182 Adjust_External_Name_Case (Expr_Value_S (Ext_Nam)));
3184 -- For the Link_Name case, the given literal is preceded by an
3185 -- asterisk, which indicates to GCC that the given name should
3186 -- be taken literally, and in particular that no prepending of
3187 -- underlines should occur, even in systems where this is the
3192 Store_String_Char (Get_Char_Code ('*'));
3193 String_Val := Strval (Expr_Value_S (Link_Nam));
3195 for J in 1 .. String_Length (String_Val) loop
3196 Store_String_Char (Get_String_Char (String_Val, J));
3200 Make_String_Literal (Sloc (Link_Nam), End_String);
3202 Set_Encoded_Interface_Name
3203 (Get_Base_Subprogram (Subprogram_Def), Link_Nam);
3205 end Process_Interface_Name;
3207 -----------------------------------------
3208 -- Process_Interrupt_Or_Attach_Handler --
3209 -----------------------------------------
3211 procedure Process_Interrupt_Or_Attach_Handler is
3212 Arg1_X : constant Node_Id := Expression (Arg1);
3213 Handler_Proc : constant Entity_Id := Entity (Arg1_X);
3214 Proc_Scope : constant Entity_Id := Scope (Handler_Proc);
3217 Set_Is_Interrupt_Handler (Handler_Proc);
3219 -- If the pragma is not associated with a handler procedure
3220 -- within a protected type, then it must be for a nonprotected
3221 -- procedure for the AAMP target, in which case we don't
3222 -- associate a representation item with the procedure's scope.
3224 if Ekind (Proc_Scope) = E_Protected_Type then
3225 if Prag_Id = Pragma_Interrupt_Handler
3227 Prag_Id = Pragma_Attach_Handler
3229 Record_Rep_Item (Proc_Scope, N);
3232 end Process_Interrupt_Or_Attach_Handler;
3234 --------------------------------------------------
3235 -- Process_Restrictions_Or_Restriction_Warnings --
3236 --------------------------------------------------
3238 procedure Process_Restrictions_Or_Restriction_Warnings is
3240 R_Id : Restriction_Id;
3245 procedure Set_Warning (R : All_Restrictions);
3246 -- If this is a Restriction_Warnings pragma, set warning flag
3248 procedure Set_Warning (R : All_Restrictions) is
3250 if Prag_Id = Pragma_Restriction_Warnings then
3251 Restriction_Warnings (R) := True;
3255 -- Start of processing for Process_Restrictions_Or_Restriction_Warnings
3258 Check_Ada_83_Warning;
3259 Check_At_Least_N_Arguments (1);
3260 Check_Valid_Configuration_Pragma;
3263 while Present (Arg) loop
3265 Expr := Expression (Arg);
3267 -- Case of no restriction identifier
3269 if Id = No_Name then
3270 if Nkind (Expr) /= N_Identifier then
3272 ("invalid form for restriction", Arg);
3275 -- No_Requeue is a synonym for No_Requeue_Statements
3277 if Chars (Expr) = Name_No_Requeue then
3279 (No_Implementation_Restrictions, Arg);
3280 Set_Restriction (No_Requeue_Statements, N);
3281 Set_Warning (No_Requeue_Statements);
3283 -- Normal processing for all other cases
3286 R_Id := Get_Restriction_Id (Chars (Expr));
3288 if R_Id not in All_Boolean_Restrictions then
3290 ("invalid restriction identifier", Arg);
3292 -- Restriction is active
3295 if Implementation_Restriction (R_Id) then
3297 (No_Implementation_Restrictions, Arg);
3300 Set_Restriction (R_Id, N);
3303 -- A very special case that must be processed here:
3304 -- pragma Restrictions (No_Exceptions) turns off
3305 -- all run-time checking. This is a bit dubious in
3306 -- terms of the formal language definition, but it
3307 -- is what is intended by RM H.4(12).
3309 if R_Id = No_Exceptions then
3310 Scope_Suppress := (others => True);
3316 -- Case of restriction identifier present
3319 R_Id := Get_Restriction_Id (Id);
3320 Analyze_And_Resolve (Expr, Any_Integer);
3322 if R_Id not in All_Parameter_Restrictions then
3324 ("invalid restriction parameter identifier", Arg);
3326 elsif not Is_OK_Static_Expression (Expr) then
3327 Flag_Non_Static_Expr
3328 ("value must be static expression!", Expr);
3331 elsif not Is_Integer_Type (Etype (Expr))
3332 or else Expr_Value (Expr) < 0
3335 ("value must be non-negative integer", Arg);
3337 -- Restriction pragma is active
3340 Val := Expr_Value (Expr);
3342 if not UI_Is_In_Int_Range (Val) then
3344 ("pragma ignored, value too large?", Arg);
3346 Set_Restriction (R_Id, N, Integer (UI_To_Int (Val)));
3354 end Process_Restrictions_Or_Restriction_Warnings;
3356 ---------------------------------
3357 -- Process_Suppress_Unsuppress --
3358 ---------------------------------
3360 -- Note: this procedure makes entries in the check suppress data
3361 -- structures managed by Sem. See spec of package Sem for full
3362 -- details on how we handle recording of check suppression.
3364 procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean) is
3369 In_Package_Spec : constant Boolean :=
3370 (Ekind (Current_Scope) = E_Package
3372 Ekind (Current_Scope) = E_Generic_Package)
3373 and then not In_Package_Body (Current_Scope);
3375 procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id);
3376 -- Used to suppress a single check on the given entity
3378 --------------------------------
3379 -- Suppress_Unsuppress_Echeck --
3380 --------------------------------
3382 procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id) is
3383 ESR : constant Entity_Check_Suppress_Record :=
3386 Suppress => Suppress_Case);
3389 Set_Checks_May_Be_Suppressed (E);
3391 if In_Package_Spec then
3392 Global_Entity_Suppress.Append (ESR);
3394 Local_Entity_Suppress.Append (ESR);
3397 -- If this is a first subtype, and the base type is distinct,
3398 -- then also set the suppress flags on the base type.
3400 if Is_First_Subtype (E)
3401 and then Etype (E) /= E
3403 Suppress_Unsuppress_Echeck (Etype (E), C);
3405 end Suppress_Unsuppress_Echeck;
3407 -- Start of processing for Process_Suppress_Unsuppress
3410 -- Suppress/Unsuppress can appear as a configuration pragma,
3411 -- or in a declarative part or a package spec (RM 11.5(5))
3413 if not Is_Configuration_Pragma then
3414 Check_Is_In_Decl_Part_Or_Package_Spec;
3417 Check_At_Least_N_Arguments (1);
3418 Check_At_Most_N_Arguments (2);
3419 Check_No_Identifier (Arg1);
3420 Check_Arg_Is_Identifier (Arg1);
3422 if not Is_Check_Name (Chars (Expression (Arg1))) then
3424 ("argument of pragma% is not valid check name", Arg1);
3427 C := Get_Check_Id (Chars (Expression (Arg1)));
3430 if Arg_Count = 1 then
3432 -- Make an entry in the local scope suppress table. This is the
3433 -- table that directly shows the current value of the scope
3434 -- suppress check for any check id value.
3436 if C = All_Checks then
3437 Scope_Suppress := (others => Suppress_Case);
3439 Scope_Suppress (C) := Suppress_Case;
3442 -- Also make an entry in the Local_Entity_Suppress table. See
3443 -- extended description in the package spec of Sem for details.
3445 Local_Entity_Suppress.Append
3448 Suppress => Suppress_Case));
3450 -- Case of two arguments present, where the check is
3451 -- suppressed for a specified entity (given as the second
3452 -- argument of the pragma)
3455 Check_Optional_Identifier (Arg2, Name_On);
3456 E_Id := Expression (Arg2);
3459 if not Is_Entity_Name (E_Id) then
3461 ("second argument of pragma% must be entity name", Arg2);
3470 -- Enforce RM 11.5(7) which requires that for a pragma that
3471 -- appears within a package spec, the named entity must be
3472 -- within the package spec. We allow the package name itself
3473 -- to be mentioned since that makes sense, although it is not
3474 -- strictly allowed by 11.5(7).
3477 and then E /= Current_Scope
3478 and then Scope (E) /= Current_Scope
3481 ("entity in pragma% is not in package spec ('R'M 11.5(7))",
3485 -- Loop through homonyms. As noted below, in the case of a package
3486 -- spec, only homonyms within the package spec are considered.
3489 Suppress_Unsuppress_Echeck (E, C);
3491 if Is_Generic_Instance (E)
3492 and then Is_Subprogram (E)
3493 and then Present (Alias (E))
3495 Suppress_Unsuppress_Echeck (Alias (E), C);
3498 -- Move to next homonym
3503 -- If we are within a package specification, the
3504 -- pragma only applies to homonyms in the same scope.
3506 exit when In_Package_Spec
3507 and then Scope (E) /= Current_Scope;
3510 end Process_Suppress_Unsuppress;
3516 procedure Set_Exported (E : Entity_Id; Arg : Node_Id) is
3518 if Is_Imported (E) then
3520 ("cannot export entity& that was previously imported", Arg);
3522 elsif Present (Address_Clause (E)) then
3524 ("cannot export entity& that has an address clause", Arg);
3527 Set_Is_Exported (E);
3529 -- Generate a reference for entity explicitly, because the
3530 -- identifier may be overloaded and name resolution will not
3533 Generate_Reference (E, Arg);
3535 -- Deal with exporting non-library level entity
3537 if not Is_Library_Level_Entity (E) then
3539 -- Not allowed at all for subprograms
3541 if Is_Subprogram (E) then
3542 Error_Pragma_Arg ("local subprogram& cannot be exported", Arg);
3544 -- Otherwise set public and statically allocated
3548 Set_Is_Statically_Allocated (E);
3550 if Warn_On_Export_Import then
3552 ("?& has been made static as a result of Export", Arg, E);
3554 ("\this usage is non-standard and non-portable", Arg);
3559 if Warn_On_Export_Import and then Is_Type (E) then
3561 ("exporting a type has no effect?", Arg, E);
3564 if Warn_On_Export_Import and Inside_A_Generic then
3566 ("all instances of& will have the same external name?", Arg, E);
3570 ----------------------------------------------
3571 -- Set_Extended_Import_Export_External_Name --
3572 ----------------------------------------------
3574 procedure Set_Extended_Import_Export_External_Name
3575 (Internal_Ent : Entity_Id;
3576 Arg_External : Node_Id)
3578 Old_Name : constant Node_Id := Interface_Name (Internal_Ent);
3582 if No (Arg_External) then
3585 elsif Nkind (Arg_External) = N_String_Literal then
3586 if String_Length (Strval (Arg_External)) = 0 then
3589 New_Name := Adjust_External_Name_Case (Arg_External);
3592 elsif Nkind (Arg_External) = N_Identifier then
3593 New_Name := Get_Default_External_Name (Arg_External);
3597 ("incorrect form for External parameter for pragma%",
3601 -- If we already have an external name set (by a prior normal
3602 -- Import or Export pragma), then the external names must match
3604 if Present (Interface_Name (Internal_Ent)) then
3606 S1 : constant String_Id := Strval (Old_Name);
3607 S2 : constant String_Id := Strval (New_Name);
3610 -- Called if names do not match
3612 procedure Mismatch is
3614 Error_Msg_Sloc := Sloc (Old_Name);
3616 ("external name does not match that given #",
3621 if String_Length (S1) /= String_Length (S2) then
3625 for J in 1 .. String_Length (S1) loop
3626 if Get_String_Char (S1, J) /= Get_String_Char (S2, J) then
3633 -- Otherwise set the given name
3636 Set_Encoded_Interface_Name (Internal_Ent, New_Name);
3639 end Set_Extended_Import_Export_External_Name;
3645 procedure Set_Imported (E : Entity_Id) is
3647 Error_Msg_Sloc := Sloc (E);
3649 if Is_Exported (E) or else Is_Imported (E) then
3650 Error_Msg_NE ("import of& declared# not allowed", N, E);
3652 if Is_Exported (E) then
3653 Error_Msg_N ("\entity was previously exported", N);
3655 Error_Msg_N ("\entity was previously imported", N);
3658 Error_Pragma ("\(pragma% applies to all previous entities)");
3661 Set_Is_Imported (E);
3663 -- If the entity is an object that is not at the library
3664 -- level, then it is statically allocated. We do not worry
3665 -- about objects with address clauses in this context since
3666 -- they are not really imported in the linker sense.
3669 and then not Is_Library_Level_Entity (E)
3670 and then No (Address_Clause (E))
3672 Set_Is_Statically_Allocated (E);
3677 -------------------------
3678 -- Set_Mechanism_Value --
3679 -------------------------
3681 -- Note: the mechanism name has not been analyzed (and cannot indeed
3682 -- be analyzed, since it is semantic nonsense), so we get it in the
3683 -- exact form created by the parser.
3685 procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id) is
3689 procedure Bad_Class;
3690 -- Signal bad descriptor class name
3692 procedure Bad_Mechanism;
3693 -- Signal bad mechanism name
3695 procedure Bad_Class is
3697 Error_Pragma_Arg ("unrecognized descriptor class name", Class);
3700 procedure Bad_Mechanism is
3702 Error_Pragma_Arg ("unrecognized mechanism name", Mech_Name);
3705 -- Start of processing for Set_Mechanism_Value
3708 if Mechanism (Ent) /= Default_Mechanism then
3710 ("mechanism for & has already been set", Mech_Name, Ent);
3713 -- MECHANISM_NAME ::= value | reference | descriptor
3715 if Nkind (Mech_Name) = N_Identifier then
3716 if Chars (Mech_Name) = Name_Value then
3717 Set_Mechanism (Ent, By_Copy);
3720 elsif Chars (Mech_Name) = Name_Reference then
3721 Set_Mechanism (Ent, By_Reference);
3724 elsif Chars (Mech_Name) = Name_Descriptor then
3725 Check_VMS (Mech_Name);
3726 Set_Mechanism (Ent, By_Descriptor);
3729 elsif Chars (Mech_Name) = Name_Copy then
3731 ("bad mechanism name, Value assumed", Mech_Name);
3737 -- MECHANISM_NAME ::= descriptor (CLASS_NAME)
3738 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
3740 -- Note: this form is parsed as an indexed component
3742 elsif Nkind (Mech_Name) = N_Indexed_Component then
3743 Class := First (Expressions (Mech_Name));
3745 if Nkind (Prefix (Mech_Name)) /= N_Identifier
3746 or else Chars (Prefix (Mech_Name)) /= Name_Descriptor
3747 or else Present (Next (Class))
3752 -- MECHANISM_NAME ::= descriptor (Class => CLASS_NAME)
3753 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
3755 -- Note: this form is parsed as a function call
3757 elsif Nkind (Mech_Name) = N_Function_Call then
3759 Param := First (Parameter_Associations (Mech_Name));
3761 if Nkind (Name (Mech_Name)) /= N_Identifier
3762 or else Chars (Name (Mech_Name)) /= Name_Descriptor
3763 or else Present (Next (Param))
3764 or else No (Selector_Name (Param))
3765 or else Chars (Selector_Name (Param)) /= Name_Class
3769 Class := Explicit_Actual_Parameter (Param);
3776 -- Fall through here with Class set to descriptor class name
3778 Check_VMS (Mech_Name);
3780 if Nkind (Class) /= N_Identifier then
3783 elsif Chars (Class) = Name_UBS then
3784 Set_Mechanism (Ent, By_Descriptor_UBS);
3786 elsif Chars (Class) = Name_UBSB then
3787 Set_Mechanism (Ent, By_Descriptor_UBSB);
3789 elsif Chars (Class) = Name_UBA then
3790 Set_Mechanism (Ent, By_Descriptor_UBA);
3792 elsif Chars (Class) = Name_S then
3793 Set_Mechanism (Ent, By_Descriptor_S);
3795 elsif Chars (Class) = Name_SB then
3796 Set_Mechanism (Ent, By_Descriptor_SB);
3798 elsif Chars (Class) = Name_A then
3799 Set_Mechanism (Ent, By_Descriptor_A);
3801 elsif Chars (Class) = Name_NCA then
3802 Set_Mechanism (Ent, By_Descriptor_NCA);
3808 end Set_Mechanism_Value;
3810 -- Start of processing for Analyze_Pragma
3813 if not Is_Pragma_Name (Chars (N)) then
3814 if Warn_On_Unrecognized_Pragma then
3815 Error_Pragma ("unrecognized pragma%!?");
3820 Prag_Id := Get_Pragma_Id (Chars (N));
3830 if Present (Pragma_Argument_Associations (N)) then
3831 Arg1 := First (Pragma_Argument_Associations (N));
3833 if Present (Arg1) then
3834 Arg2 := Next (Arg1);
3836 if Present (Arg2) then
3837 Arg3 := Next (Arg2);
3839 if Present (Arg3) then
3840 Arg4 := Next (Arg3);
3846 -- Count number of arguments
3853 while Present (Arg_Node) loop
3854 Arg_Count := Arg_Count + 1;
3859 -- An enumeration type defines the pragmas that are supported by the
3860 -- implementation. Get_Pragma_Id (in package Prag) transorms a name
3861 -- into the corresponding enumeration value for the following case.
3869 -- pragma Abort_Defer;
3871 when Pragma_Abort_Defer =>
3873 Check_Arg_Count (0);
3875 -- The only required semantic processing is to check the
3876 -- placement. This pragma must appear at the start of the
3877 -- statement sequence of a handled sequence of statements.
3879 if Nkind (Parent (N)) /= N_Handled_Sequence_Of_Statements
3880 or else N /= First (Statements (Parent (N)))
3891 -- Note: this pragma also has some specific processing in Par.Prag
3892 -- because we want to set the Ada 83 mode switch during parsing.
3894 when Pragma_Ada_83 =>
3898 Check_Arg_Count (0);
3906 -- Note: this pragma also has some specific processing in Par.Prag
3907 -- because we want to set the Ada 83 mode switch during parsing.
3909 when Pragma_Ada_95 =>
3913 Check_Arg_Count (0);
3915 ----------------------
3916 -- All_Calls_Remote --
3917 ----------------------
3919 -- pragma All_Calls_Remote [(library_package_NAME)];
3921 when Pragma_All_Calls_Remote => All_Calls_Remote : declare
3922 Lib_Entity : Entity_Id;
3925 Check_Ada_83_Warning;
3926 Check_Valid_Library_Unit_Pragma;
3928 if Nkind (N) = N_Null_Statement then
3932 Lib_Entity := Find_Lib_Unit_Name;
3934 -- This pragma should only apply to a RCI unit (RM E.2.3(23)).
3936 if Present (Lib_Entity)
3937 and then not Debug_Flag_U
3939 if not Is_Remote_Call_Interface (Lib_Entity) then
3940 Error_Pragma ("pragma% only apply to rci unit");
3942 -- Set flag for entity of the library unit
3945 Set_Has_All_Calls_Remote (Lib_Entity);
3949 end All_Calls_Remote;
3955 -- pragma Annotate (IDENTIFIER {, ARG});
3956 -- ARG ::= NAME | EXPRESSION
3958 when Pragma_Annotate => Annotate : begin
3960 Check_At_Least_N_Arguments (1);
3961 Check_Arg_Is_Identifier (Arg1);
3964 Arg : Node_Id := Arg2;
3968 while Present (Arg) loop
3969 Exp := Expression (Arg);
3972 if Is_Entity_Name (Exp) then
3975 elsif Nkind (Exp) = N_String_Literal then
3976 Resolve (Exp, Standard_String);
3978 elsif Is_Overloaded (Exp) then
3979 Error_Pragma_Arg ("ambiguous argument for pragma%", Exp);
3994 -- pragma Assert (Boolean_EXPRESSION [, static_string_EXPRESSION]);
3996 when Pragma_Assert =>
3998 Check_No_Identifiers;
4000 if Arg_Count > 1 then
4001 Check_Arg_Count (2);
4002 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
4005 -- If expansion is active and assertions are inactive, then
4006 -- we rewrite the Assertion as:
4008 -- if False and then condition then
4012 -- The reason we do this rewriting during semantic analysis
4013 -- rather than as part of normal expansion is that we cannot
4014 -- analyze and expand the code for the boolean expression
4015 -- directly, or it may cause insertion of actions that would
4016 -- escape the attempt to suppress the assertion code.
4018 if Expander_Active and not Assertions_Enabled then
4020 Make_If_Statement (Loc,
4023 Left_Opnd => New_Occurrence_Of (Standard_False, Loc),
4024 Right_Opnd => Get_Pragma_Arg (Arg1)),
4025 Then_Statements => New_List (
4026 Make_Null_Statement (Loc))));
4030 -- Otherwise (if assertions are enabled, or if we are not
4031 -- operating with expansion active), then we just analyze
4032 -- and resolve the expression.
4035 Analyze_And_Resolve (Expression (Arg1), Any_Boolean);
4042 -- pragma AST_Entry (entry_IDENTIFIER);
4044 when Pragma_AST_Entry => AST_Entry : declare
4050 Check_Arg_Count (1);
4051 Check_No_Identifiers;
4052 Check_Arg_Is_Local_Name (Arg1);
4053 Ent := Entity (Expression (Arg1));
4055 -- Note: the implementation of the AST_Entry pragma could handle
4056 -- the entry family case fine, but for now we are consistent with
4057 -- the DEC rules, and do not allow the pragma, which of course
4058 -- has the effect of also forbidding the attribute.
4060 if Ekind (Ent) /= E_Entry then
4062 ("pragma% argument must be simple entry name", Arg1);
4064 elsif Is_AST_Entry (Ent) then
4066 ("duplicate % pragma for entry", Arg1);
4068 elsif Has_Homonym (Ent) then
4070 ("pragma% argument cannot specify overloaded entry", Arg1);
4074 FF : constant Entity_Id := First_Formal (Ent);
4077 if Present (FF) then
4078 if Present (Next_Formal (FF)) then
4080 ("entry for pragma% can have only one argument",
4083 elsif Parameter_Mode (FF) /= E_In_Parameter then
4085 ("entry parameter for pragma% must have mode IN",
4091 Set_Is_AST_Entry (Ent);
4099 -- pragma Asynchronous (LOCAL_NAME);
4101 when Pragma_Asynchronous => Asynchronous : declare
4109 procedure Process_Async_Pragma;
4110 -- Common processing for procedure and access-to-procedure case
4112 --------------------------
4113 -- Process_Async_Pragma --
4114 --------------------------
4116 procedure Process_Async_Pragma is
4118 if not Present (L) then
4119 Set_Is_Asynchronous (Nm);
4123 -- The formals should be of mode IN (RM E.4.1(6))
4126 while Present (S) loop
4127 Formal := Defining_Identifier (S);
4129 if Nkind (Formal) = N_Defining_Identifier
4130 and then Ekind (Formal) /= E_In_Parameter
4133 ("pragma% procedure can only have IN parameter",
4140 Set_Is_Asynchronous (Nm);
4141 end Process_Async_Pragma;
4143 -- Start of processing for pragma Asynchronous
4146 Check_Ada_83_Warning;
4147 Check_No_Identifiers;
4148 Check_Arg_Count (1);
4149 Check_Arg_Is_Local_Name (Arg1);
4151 if Debug_Flag_U then
4155 C_Ent := Cunit_Entity (Current_Sem_Unit);
4156 Analyze (Expression (Arg1));
4157 Nm := Entity (Expression (Arg1));
4159 if not Is_Remote_Call_Interface (C_Ent)
4160 and then not Is_Remote_Types (C_Ent)
4162 -- This pragma should only appear in an RCI or Remote Types
4163 -- unit (RM E.4.1(4))
4166 ("pragma% not in Remote_Call_Interface or " &
4167 "Remote_Types unit");
4170 if Ekind (Nm) = E_Procedure
4171 and then Nkind (Parent (Nm)) = N_Procedure_Specification
4173 if not Is_Remote_Call_Interface (Nm) then
4175 ("pragma% cannot be applied on non-remote procedure",
4179 L := Parameter_Specifications (Parent (Nm));
4180 Process_Async_Pragma;
4183 elsif Ekind (Nm) = E_Function then
4185 ("pragma% cannot be applied to function", Arg1);
4187 elsif Ekind (Nm) = E_Record_Type
4188 and then Present (Corresponding_Remote_Type (Nm))
4190 N := Declaration_Node (Corresponding_Remote_Type (Nm));
4192 if Nkind (N) = N_Full_Type_Declaration
4193 and then Nkind (Type_Definition (N)) =
4194 N_Access_Procedure_Definition
4196 L := Parameter_Specifications (Type_Definition (N));
4197 Process_Async_Pragma;
4201 ("pragma% cannot reference access-to-function type",
4205 -- Only other possibility is Access-to-class-wide type
4207 elsif Is_Access_Type (Nm)
4208 and then Is_Class_Wide_Type (Designated_Type (Nm))
4210 Check_First_Subtype (Arg1);
4211 Set_Is_Asynchronous (Nm);
4212 if Expander_Active then
4213 RACW_Type_Is_Asynchronous (Nm);
4217 Error_Pragma_Arg ("inappropriate argument for pragma%", Arg1);
4225 -- pragma Atomic (LOCAL_NAME);
4227 when Pragma_Atomic =>
4228 Process_Atomic_Shared_Volatile;
4230 -----------------------
4231 -- Atomic_Components --
4232 -----------------------
4234 -- pragma Atomic_Components (array_LOCAL_NAME);
4236 -- This processing is shared by Volatile_Components
4238 when Pragma_Atomic_Components |
4239 Pragma_Volatile_Components =>
4241 Atomic_Components : declare
4248 Check_Ada_83_Warning;
4249 Check_No_Identifiers;
4250 Check_Arg_Count (1);
4251 Check_Arg_Is_Local_Name (Arg1);
4252 E_Id := Expression (Arg1);
4254 if Etype (E_Id) = Any_Type then
4260 if Rep_Item_Too_Early (E, N)
4262 Rep_Item_Too_Late (E, N)
4267 D := Declaration_Node (E);
4270 if (K = N_Full_Type_Declaration and then Is_Array_Type (E))
4272 ((Ekind (E) = E_Constant or else Ekind (E) = E_Variable)
4273 and then Nkind (D) = N_Object_Declaration
4274 and then Nkind (Object_Definition (D)) =
4275 N_Constrained_Array_Definition)
4277 -- The flag is set on the object, or on the base type
4279 if Nkind (D) /= N_Object_Declaration then
4283 Set_Has_Volatile_Components (E);
4285 if Prag_Id = Pragma_Atomic_Components then
4286 Set_Has_Atomic_Components (E);
4288 if Is_Packed (E) then
4289 Set_Is_Packed (E, False);
4292 ("?Pack canceled, cannot pack atomic components",
4298 Error_Pragma_Arg ("inappropriate entity for pragma%", Arg1);
4300 end Atomic_Components;
4302 --------------------
4303 -- Attach_Handler --
4304 --------------------
4306 -- pragma Attach_Handler (handler_NAME, EXPRESSION);
4308 when Pragma_Attach_Handler =>
4309 Check_Ada_83_Warning;
4310 Check_No_Identifiers;
4311 Check_Arg_Count (2);
4313 if No_Run_Time_Mode then
4314 Error_Msg_CRT ("Attach_Handler pragma", N);
4316 Check_Interrupt_Or_Attach_Handler;
4318 -- The expression that designates the attribute may
4319 -- depend on a discriminant, and is therefore a per-
4320 -- object expression, to be expanded in the init proc.
4321 -- If expansion is enabled, perform semantic checks
4324 if Expander_Active then
4326 Temp : constant Node_Id :=
4327 New_Copy_Tree (Expression (Arg2));
4329 Set_Parent (Temp, N);
4330 Pre_Analyze_And_Resolve (Temp, RTE (RE_Interrupt_ID));
4334 Analyze (Expression (Arg2));
4335 Resolve (Expression (Arg2), RTE (RE_Interrupt_ID));
4338 Process_Interrupt_Or_Attach_Handler;
4341 --------------------
4342 -- C_Pass_By_Copy --
4343 --------------------
4345 -- pragma C_Pass_By_Copy ([Max_Size =>] static_integer_EXPRESSION);
4347 when Pragma_C_Pass_By_Copy => C_Pass_By_Copy : declare
4353 Check_Valid_Configuration_Pragma;
4354 Check_Arg_Count (1);
4355 Check_Optional_Identifier (Arg1, "max_size");
4357 Arg := Expression (Arg1);
4358 Check_Arg_Is_Static_Expression (Arg, Any_Integer);
4360 Val := Expr_Value (Arg);
4364 ("maximum size for pragma% must be positive", Arg1);
4366 elsif UI_Is_In_Int_Range (Val) then
4367 Default_C_Record_Mechanism := UI_To_Int (Val);
4369 -- If a giant value is given, Int'Last will do well enough.
4370 -- If sometime someone complains that a record larger than
4371 -- two gigabytes is not copied, we will worry about it then!
4374 Default_C_Record_Mechanism := Mechanism_Type'Last;
4382 -- pragma Comment (static_string_EXPRESSION)
4384 -- Processing for pragma Comment shares the circuitry for
4385 -- pragma Ident. The only differences are that Ident enforces
4386 -- a limit of 31 characters on its argument, and also enforces
4387 -- limitations on placement for DEC compatibility. Pragma
4388 -- Comment shares neither of these restrictions.
4394 -- pragma Common_Object (
4395 -- [Internal =>] LOCAL_NAME,
4396 -- [, [External =>] EXTERNAL_SYMBOL]
4397 -- [, [Size =>] EXTERNAL_SYMBOL]);
4399 -- Processing for this pragma is shared with Psect_Object
4401 --------------------------
4402 -- Compile_Time_Warning --
4403 --------------------------
4405 -- pragma Compile_Time_Warning
4406 -- (boolean_EXPRESSION, static_string_EXPRESSION);
4408 when Pragma_Compile_Time_Warning => Compile_Time_Warning : declare
4409 Arg1x : constant Node_Id := Get_Pragma_Arg (Arg1);
4413 Check_Arg_Count (2);
4414 Check_No_Identifiers;
4415 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
4416 Analyze_And_Resolve (Arg1x, Standard_Boolean);
4418 if Compile_Time_Known_Value (Arg1x) then
4419 if Is_True (Expr_Value (Get_Pragma_Arg (Arg1))) then
4420 String_To_Name_Buffer (Strval (Get_Pragma_Arg (Arg2)));
4421 Add_Char_To_Name_Buffer ('?');
4424 Msg : String (1 .. Name_Len) :=
4425 Name_Buffer (1 .. Name_Len);
4430 -- This loop looks for multiple lines separated by
4431 -- ASCII.LF and breaks them into continuation error
4432 -- messages marked with the usual back slash.
4435 for S in 2 .. Msg'Length - 1 loop
4436 if Msg (S) = ASCII.LF then
4438 Error_Msg_N (Msg (B .. S), Arg1);
4444 Error_Msg_N (Msg (B .. Msg'Length), Arg1);
4448 end Compile_Time_Warning;
4450 ----------------------------
4451 -- Complex_Representation --
4452 ----------------------------
4454 -- pragma Complex_Representation ([Entity =>] LOCAL_NAME);
4456 when Pragma_Complex_Representation => Complex_Representation : declare
4463 Check_Arg_Count (1);
4464 Check_Optional_Identifier (Arg1, Name_Entity);
4465 Check_Arg_Is_Local_Name (Arg1);
4466 E_Id := Expression (Arg1);
4468 if Etype (E_Id) = Any_Type then
4474 if not Is_Record_Type (E) then
4476 ("argument for pragma% must be record type", Arg1);
4479 Ent := First_Entity (E);
4482 or else No (Next_Entity (Ent))
4483 or else Present (Next_Entity (Next_Entity (Ent)))
4484 or else not Is_Floating_Point_Type (Etype (Ent))
4485 or else Etype (Ent) /= Etype (Next_Entity (Ent))
4488 ("record for pragma% must have two fields of same fpt type",
4492 Set_Has_Complex_Representation (Base_Type (E));
4494 end Complex_Representation;
4496 -------------------------
4497 -- Component_Alignment --
4498 -------------------------
4500 -- pragma Component_Alignment (
4501 -- [Form =>] ALIGNMENT_CHOICE
4502 -- [, [Name =>] type_LOCAL_NAME]);
4504 -- ALIGNMENT_CHOICE ::=
4506 -- | Component_Size_4
4510 when Pragma_Component_Alignment => Component_AlignmentP : declare
4511 Args : Args_List (1 .. 2);
4512 Names : constant Name_List (1 .. 2) := (
4516 Form : Node_Id renames Args (1);
4517 Name : Node_Id renames Args (2);
4519 Atype : Component_Alignment_Kind;
4524 Gather_Associations (Names, Args);
4527 Error_Pragma ("missing Form argument for pragma%");
4530 Check_Arg_Is_Identifier (Form);
4532 -- Get proper alignment, note that Default = Component_Size
4533 -- on all machines we have so far, and we want to set this
4534 -- value rather than the default value to indicate that it
4535 -- has been explicitly set (and thus will not get overridden
4536 -- by the default component alignment for the current scope)
4538 if Chars (Form) = Name_Component_Size then
4539 Atype := Calign_Component_Size;
4541 elsif Chars (Form) = Name_Component_Size_4 then
4542 Atype := Calign_Component_Size_4;
4544 elsif Chars (Form) = Name_Default then
4545 Atype := Calign_Component_Size;
4547 elsif Chars (Form) = Name_Storage_Unit then
4548 Atype := Calign_Storage_Unit;
4552 ("invalid Form parameter for pragma%", Form);
4555 -- Case with no name, supplied, affects scope table entry
4559 (Scope_Stack.Last).Component_Alignment_Default := Atype;
4561 -- Case of name supplied
4564 Check_Arg_Is_Local_Name (Name);
4566 Typ := Entity (Name);
4569 or else Rep_Item_Too_Early (Typ, N)
4573 Typ := Underlying_Type (Typ);
4576 if not Is_Record_Type (Typ)
4577 and then not Is_Array_Type (Typ)
4580 ("Name parameter of pragma% must identify record or " &
4581 "array type", Name);
4584 -- An explicit Component_Alignment pragma overrides an
4585 -- implicit pragma Pack, but not an explicit one.
4587 if not Has_Pragma_Pack (Base_Type (Typ)) then
4588 Set_Is_Packed (Base_Type (Typ), False);
4589 Set_Component_Alignment (Base_Type (Typ), Atype);
4592 end Component_AlignmentP;
4598 -- pragma Controlled (first_subtype_LOCAL_NAME);
4600 when Pragma_Controlled => Controlled : declare
4604 Check_No_Identifiers;
4605 Check_Arg_Count (1);
4606 Check_Arg_Is_Local_Name (Arg1);
4607 Arg := Expression (Arg1);
4609 if not Is_Entity_Name (Arg)
4610 or else not Is_Access_Type (Entity (Arg))
4612 Error_Pragma_Arg ("pragma% requires access type", Arg1);
4614 Set_Has_Pragma_Controlled (Base_Type (Entity (Arg)));
4622 -- pragma Convention ([Convention =>] convention_IDENTIFIER,
4623 -- [Entity =>] LOCAL_NAME);
4625 when Pragma_Convention => Convention : declare
4629 Check_Ada_83_Warning;
4630 Check_Arg_Count (2);
4631 Process_Convention (C, E);
4634 ---------------------------
4635 -- Convention_Identifier --
4636 ---------------------------
4638 -- pragma Convention_Identifier ([Name =>] IDENTIFIER,
4639 -- [Convention =>] convention_IDENTIFIER);
4641 when Pragma_Convention_Identifier => Convention_Identifier : declare
4647 Check_Arg_Count (2);
4648 Check_Optional_Identifier (Arg1, Name_Name);
4649 Check_Optional_Identifier (Arg2, Name_Convention);
4650 Check_Arg_Is_Identifier (Arg1);
4651 Check_Arg_Is_Identifier (Arg1);
4652 Idnam := Chars (Expression (Arg1));
4653 Cname := Chars (Expression (Arg2));
4655 if Is_Convention_Name (Cname) then
4656 Record_Convention_Identifier
4657 (Idnam, Get_Convention_Id (Cname));
4660 ("second arg for % pragma must be convention", Arg2);
4662 end Convention_Identifier;
4668 -- pragma CPP_Class ([Entity =>] local_NAME)
4670 when Pragma_CPP_Class => CPP_Class : declare
4673 Default_DTC : Entity_Id := Empty;
4674 VTP_Type : constant Entity_Id := RTE (RE_Vtable_Ptr);
4680 Check_Arg_Count (1);
4681 Check_Optional_Identifier (Arg1, Name_Entity);
4682 Check_Arg_Is_Local_Name (Arg1);
4684 Arg := Expression (Arg1);
4687 if Etype (Arg) = Any_Type then
4691 if not Is_Entity_Name (Arg)
4692 or else not Is_Type (Entity (Arg))
4694 Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
4697 Typ := Entity (Arg);
4699 if not Is_Record_Type (Typ) then
4700 Error_Pragma_Arg ("pragma% applicable to a record, "
4701 & "tagged record or record extension", Arg1);
4704 Default_DTC := First_Component (Typ);
4705 while Present (Default_DTC)
4706 and then Etype (Default_DTC) /= VTP_Type
4708 Next_Component (Default_DTC);
4711 -- Case of non tagged type
4713 if not Is_Tagged_Type (Typ) then
4714 Set_Is_CPP_Class (Typ);
4716 if Present (Default_DTC) then
4718 ("only tagged records can contain vtable pointers", Arg1);
4721 -- Case of tagged type with no vtable ptr
4723 -- What is test for Typ = Root_Typ (Typ) about here ???
4725 elsif Is_Tagged_Type (Typ)
4726 and then Typ = Root_Type (Typ)
4727 and then No (Default_DTC)
4730 ("a cpp_class must contain a vtable pointer", Arg1);
4732 -- Tagged type that has a vtable ptr
4734 elsif Present (Default_DTC) then
4735 Set_Is_CPP_Class (Typ);
4736 Set_Is_Limited_Record (Typ);
4737 Set_Is_Tag (Default_DTC);
4738 Set_DT_Entry_Count (Default_DTC, No_Uint);
4740 -- Since a CPP type has no direct link to its associated tag
4741 -- most tags checks cannot be performed
4743 Set_Kill_Tag_Checks (Typ);
4744 Set_Kill_Tag_Checks (Class_Wide_Type (Typ));
4746 -- Get rid of the _tag component when there was one.
4747 -- It is only useful for regular tagged types
4749 if Expander_Active and then Typ = Root_Type (Typ) then
4751 Tag_C := Tag_Component (Typ);
4752 C := First_Entity (Typ);
4755 Set_First_Entity (Typ, Next_Entity (Tag_C));
4758 while Next_Entity (C) /= Tag_C loop
4762 Set_Next_Entity (C, Next_Entity (Tag_C));
4768 ---------------------
4769 -- CPP_Constructor --
4770 ---------------------
4772 -- pragma CPP_Constructor ([Entity =>] LOCAL_NAME);
4774 when Pragma_CPP_Constructor => CPP_Constructor : declare
4780 Check_Arg_Count (1);
4781 Check_Optional_Identifier (Arg1, Name_Entity);
4782 Check_Arg_Is_Local_Name (Arg1);
4784 Id := Expression (Arg1);
4785 Find_Program_Unit_Name (Id);
4787 -- If we did not find the name, we are done
4789 if Etype (Id) = Any_Type then
4793 Def_Id := Entity (Id);
4795 if Ekind (Def_Id) = E_Function
4796 and then Is_Class_Wide_Type (Etype (Def_Id))
4797 and then Is_CPP_Class (Etype (Etype (Def_Id)))
4799 -- What the heck is this??? this pragma allows only 1 arg
4801 if Arg_Count >= 2 then
4802 Check_At_Most_N_Arguments (3);
4803 Process_Interface_Name (Def_Id, Arg2, Arg3);
4806 if No (Parameter_Specifications (Parent (Def_Id))) then
4807 Set_Has_Completion (Def_Id);
4808 Set_Is_Constructor (Def_Id);
4811 ("non-default constructors not implemented", Arg1);
4816 ("pragma% requires function returning a 'C'P'P_Class type",
4819 end CPP_Constructor;
4825 -- pragma CPP_Virtual
4826 -- [Entity =>] LOCAL_NAME
4827 -- [ [Vtable_Ptr =>] LOCAL_NAME,
4828 -- [Position =>] static_integer_EXPRESSION]);
4830 when Pragma_CPP_Virtual => CPP_Virtual : declare
4834 VTP_Type : constant Entity_Id := RTE (RE_Vtable_Ptr);
4841 if Arg_Count = 3 then
4842 Check_Optional_Identifier (Arg2, "vtable_ptr");
4844 -- We allow Entry_Count as well as Position for the third
4845 -- parameter for back compatibility with versions of GNAT
4846 -- before version 3.12. The documentation has always said
4847 -- Position, but the code up to 3.12 said Entry_Count.
4849 if Chars (Arg3) /= Name_Position then
4850 Check_Optional_Identifier (Arg3, "entry_count");
4854 Check_Arg_Count (1);
4857 Check_Optional_Identifier (Arg1, Name_Entity);
4858 Check_Arg_Is_Local_Name (Arg1);
4860 -- First argument must be a subprogram name
4862 Arg := Expression (Arg1);
4863 Find_Program_Unit_Name (Arg);
4865 if Etype (Arg) = Any_Type then
4868 Subp := Entity (Arg);
4871 if not (Is_Subprogram (Subp)
4872 and then Is_Dispatching_Operation (Subp))
4875 ("pragma% must reference a primitive operation", Arg1);
4878 Typ := Find_Dispatching_Type (Subp);
4880 -- If only one Argument defaults are :
4881 -- . DTC_Entity is the default Vtable pointer
4882 -- . DT_Position will be set at the freezing point
4884 if Arg_Count = 1 then
4885 Set_DTC_Entity (Subp, Tag_Component (Typ));
4889 -- Second argument is a component name of type Vtable_Ptr
4891 Arg := Expression (Arg2);
4893 if Nkind (Arg) /= N_Identifier then
4894 Error_Msg_NE ("must be a& component name", Arg, Typ);
4898 DTC := First_Component (Typ);
4899 while Present (DTC) and then Chars (DTC) /= Chars (Arg) loop
4900 Next_Component (DTC);
4904 Error_Msg_NE ("must be a& component name", Arg, Typ);
4907 elsif Etype (DTC) /= VTP_Type then
4908 Wrong_Type (Arg, VTP_Type);
4912 -- Third argument is an integer (DT_Position)
4914 Arg := Expression (Arg3);
4915 Analyze_And_Resolve (Arg, Any_Integer);
4917 if not Is_Static_Expression (Arg) then
4918 Flag_Non_Static_Expr
4919 ("third argument of pragma CPP_Virtual must be static!",
4924 V := Expr_Value (Expression (Arg3));
4928 ("third argument of pragma% must be positive",
4932 Set_DTC_Entity (Subp, DTC);
4933 Set_DT_Position (Subp, V);
4942 -- pragma CPP_Vtable (
4943 -- [Entity =>] LOCAL_NAME
4944 -- [Vtable_Ptr =>] LOCAL_NAME,
4945 -- [Entry_Count =>] static_integer_EXPRESSION);
4947 when Pragma_CPP_Vtable => CPP_Vtable : declare
4950 VTP_Type : constant Entity_Id := RTE (RE_Vtable_Ptr);
4957 Check_Arg_Count (3);
4958 Check_Optional_Identifier (Arg1, Name_Entity);
4959 Check_Optional_Identifier (Arg2, "vtable_ptr");
4960 Check_Optional_Identifier (Arg3, "entry_count");
4961 Check_Arg_Is_Local_Name (Arg1);
4963 -- First argument is a record type name
4965 Arg := Expression (Arg1);
4968 if Etype (Arg) = Any_Type then
4971 Typ := Entity (Arg);
4974 if not (Is_Tagged_Type (Typ) and then Is_CPP_Class (Typ)) then
4975 Error_Pragma_Arg ("'C'P'P_Class tagged type expected", Arg1);
4978 -- Second argument is a component name of type Vtable_Ptr
4980 Arg := Expression (Arg2);
4982 if Nkind (Arg) /= N_Identifier then
4983 Error_Msg_NE ("must be a& component name", Arg, Typ);
4987 DTC := First_Component (Typ);
4988 while Present (DTC) and then Chars (DTC) /= Chars (Arg) loop
4989 Next_Component (DTC);
4993 Error_Msg_NE ("must be a& component name", Arg, Typ);
4996 elsif Etype (DTC) /= VTP_Type then
4997 Wrong_Type (DTC, VTP_Type);
5000 -- If it is the first pragma Vtable, This becomes the default tag
5002 elsif (not Is_Tag (DTC))
5003 and then DT_Entry_Count (Tag_Component (Typ)) = No_Uint
5005 Set_Is_Tag (Tag_Component (Typ), False);
5006 Set_Is_Tag (DTC, True);
5007 Set_DT_Entry_Count (DTC, No_Uint);
5010 -- Those pragmas must appear before any primitive operation
5011 -- definition (except inherited ones) otherwise the default
5014 Elmt := First_Elmt (Primitive_Operations (Typ));
5015 while Present (Elmt) loop
5016 if No (Alias (Node (Elmt))) then
5017 Error_Msg_Sloc := Sloc (Node (Elmt));
5019 ("pragma% must appear before this primitive operation");
5025 -- Third argument is an integer (DT_Entry_Count)
5027 Arg := Expression (Arg3);
5028 Analyze_And_Resolve (Arg, Any_Integer);
5030 if not Is_Static_Expression (Arg) then
5031 Flag_Non_Static_Expr
5032 ("entry count for pragma CPP_Vtable must be a static " &
5033 "expression!", Arg3);
5037 V := Expr_Value (Expression (Arg3));
5041 ("entry count for pragma% must be positive", Arg3);
5043 Set_DT_Entry_Count (DTC, V);
5052 -- pragma Debug (PROCEDURE_CALL_STATEMENT);
5054 when Pragma_Debug => Debug : begin
5057 -- If assertions are enabled, and we are expanding code, then
5058 -- we rewrite the pragma with its corresponding procedure call
5059 -- and then analyze the call.
5061 if Assertions_Enabled and Expander_Active then
5062 Rewrite (N, Relocate_Node (Debug_Statement (N)));
5065 -- Otherwise we work a bit to get a tree that makes sense
5066 -- for ASIS purposes, namely a pragma with an analyzed
5067 -- argument that looks like a procedure call.
5070 Expander_Mode_Save_And_Set (False);
5071 Rewrite (N, Relocate_Node (Debug_Statement (N)));
5075 Chars => Name_Debug,
5076 Pragma_Argument_Associations =>
5077 New_List (Relocate_Node (N))));
5078 Expander_Mode_Restore;
5086 -- pragma Discard_Names [([On =>] LOCAL_NAME)];
5088 when Pragma_Discard_Names => Discard_Names : declare
5093 Check_Ada_83_Warning;
5095 -- Deal with configuration pragma case
5097 if Arg_Count = 0 and then Is_Configuration_Pragma then
5098 Global_Discard_Names := True;
5101 -- Otherwise, check correct appropriate context
5104 Check_Is_In_Decl_Part_Or_Package_Spec;
5106 if Arg_Count = 0 then
5108 -- If there is no parameter, then from now on this pragma
5109 -- applies to any enumeration, exception or tagged type
5110 -- defined in the current declarative part.
5112 Set_Discard_Names (Current_Scope);
5116 Check_Arg_Count (1);
5117 Check_Optional_Identifier (Arg1, Name_On);
5118 Check_Arg_Is_Local_Name (Arg1);
5119 E_Id := Expression (Arg1);
5121 if Etype (E_Id) = Any_Type then
5127 if (Is_First_Subtype (E)
5128 and then (Is_Enumeration_Type (E)
5129 or else Is_Tagged_Type (E)))
5130 or else Ekind (E) = E_Exception
5132 Set_Discard_Names (E);
5135 ("inappropriate entity for pragma%", Arg1);
5145 -- pragma Elaborate (library_unit_NAME {, library_unit_NAME});
5147 when Pragma_Elaborate => Elaborate : declare
5149 Parent_Node : Node_Id;
5154 -- Pragma must be in context items list of a compilation unit
5156 if not Is_List_Member (N) then
5161 Plist := List_Containing (N);
5162 Parent_Node := Parent (Plist);
5164 if Parent_Node = Empty
5165 or else Nkind (Parent_Node) /= N_Compilation_Unit
5166 or else Context_Items (Parent_Node) /= Plist
5173 -- Must be at least one argument
5175 if Arg_Count = 0 then
5176 Error_Pragma ("pragma% requires at least one argument");
5179 -- In Ada 83 mode, there can be no items following it in the
5180 -- context list except other pragmas and implicit with clauses
5181 -- (e.g. those added by use of Rtsfind). In Ada 95 mode, this
5182 -- placement rule does not apply.
5184 if Ada_83 and then Comes_From_Source (N) then
5187 while Present (Citem) loop
5188 if Nkind (Citem) = N_Pragma
5189 or else (Nkind (Citem) = N_With_Clause
5190 and then Implicit_With (Citem))
5195 ("(Ada 83) pragma% must be at end of context clause");
5202 -- Finally, the arguments must all be units mentioned in a with
5203 -- clause in the same context clause. Note we already checked
5204 -- (in Par.Prag) that the arguments are either identifiers or
5207 Outer : while Present (Arg) loop
5208 Citem := First (Plist);
5210 Inner : while Citem /= N loop
5211 if Nkind (Citem) = N_With_Clause
5212 and then Same_Name (Name (Citem), Expression (Arg))
5214 Set_Elaborate_Present (Citem, True);
5215 Set_Unit_Name (Expression (Arg), Name (Citem));
5216 Set_Suppress_Elaboration_Warnings (Entity (Name (Citem)));
5225 ("argument of pragma% is not with'ed unit", Arg);
5231 -- Give a warning if operating in static mode with -gnatwl
5232 -- (elaboration warnings eanbled) switch set.
5234 if Elab_Warnings and not Dynamic_Elaboration_Checks then
5236 ("?use of pragma Elaborate may not be safe", N);
5238 ("?use pragma Elaborate_All instead if possible", N);
5246 -- pragma Elaborate_All (library_unit_NAME {, library_unit_NAME});
5248 when Pragma_Elaborate_All => Elaborate_All : declare
5250 Parent_Node : Node_Id;
5255 Check_Ada_83_Warning;
5257 -- Pragma must be in context items list of a compilation unit
5259 if not Is_List_Member (N) then
5264 Plist := List_Containing (N);
5265 Parent_Node := Parent (Plist);
5267 if Parent_Node = Empty
5268 or else Nkind (Parent_Node) /= N_Compilation_Unit
5269 or else Context_Items (Parent_Node) /= Plist
5276 -- Must be at least one argument
5278 if Arg_Count = 0 then
5279 Error_Pragma ("pragma% requires at least one argument");
5282 -- Note: unlike pragma Elaborate, pragma Elaborate_All does not
5283 -- have to appear at the end of the context clause, but may
5284 -- appear mixed in with other items, even in Ada 83 mode.
5286 -- Final check: the arguments must all be units mentioned in
5287 -- a with clause in the same context clause. Note that we
5288 -- already checked (in Par.Prag) that all the arguments are
5289 -- either identifiers or selected components.
5292 Outr : while Present (Arg) loop
5293 Citem := First (Plist);
5295 Innr : while Citem /= N loop
5296 if Nkind (Citem) = N_With_Clause
5297 and then Same_Name (Name (Citem), Expression (Arg))
5299 Set_Elaborate_All_Present (Citem, True);
5300 Set_Unit_Name (Expression (Arg), Name (Citem));
5301 Set_Suppress_Elaboration_Warnings (Entity (Name (Citem)));
5309 Set_Error_Posted (N);
5311 ("argument of pragma% is not with'ed unit", Arg);
5318 --------------------
5319 -- Elaborate_Body --
5320 --------------------
5322 -- pragma Elaborate_Body [( library_unit_NAME )];
5324 when Pragma_Elaborate_Body => Elaborate_Body : declare
5325 Cunit_Node : Node_Id;
5326 Cunit_Ent : Entity_Id;
5329 Check_Ada_83_Warning;
5330 Check_Valid_Library_Unit_Pragma;
5332 if Nkind (N) = N_Null_Statement then
5336 Cunit_Node := Cunit (Current_Sem_Unit);
5337 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
5339 if Nkind (Unit (Cunit_Node)) = N_Package_Body
5341 Nkind (Unit (Cunit_Node)) = N_Subprogram_Body
5343 Error_Pragma ("pragma% must refer to a spec, not a body");
5345 Set_Body_Required (Cunit_Node, True);
5346 Set_Has_Pragma_Elaborate_Body (Cunit_Ent);
5348 -- If we are in dynamic elaboration mode, then we suppress
5349 -- elaboration warnings for the unit, since it is definitely
5350 -- fine NOT to do dynamic checks at the first level (and such
5351 -- checks will be suppressed because no elaboration boolean
5352 -- is created for Elaborate_Body packages).
5354 -- But in the static model of elaboration, Elaborate_Body is
5355 -- definitely NOT good enough to ensure elaboration safety on
5356 -- its own, since the body may WITH other units that are not
5357 -- safe from an elaboration point of view, so a client must
5358 -- still do an Elaborate_All on such units.
5360 -- Debug flag -gnatdD restores the old behavior of 3.13,
5361 -- where Elaborate_Body always suppressed elab warnings.
5363 if Dynamic_Elaboration_Checks or Debug_Flag_DD then
5364 Set_Suppress_Elaboration_Warnings (Cunit_Ent);
5369 ------------------------
5370 -- Elaboration_Checks --
5371 ------------------------
5373 -- pragma Elaboration_Checks (Static | Dynamic);
5375 when Pragma_Elaboration_Checks =>
5377 Check_Arg_Count (1);
5378 Check_Arg_Is_One_Of (Arg1, Name_Static, Name_Dynamic);
5379 Dynamic_Elaboration_Checks :=
5380 (Chars (Get_Pragma_Arg (Arg1)) = Name_Dynamic);
5386 -- pragma Eliminate (
5387 -- [Unit_Name =>] IDENTIFIER |
5388 -- SELECTED_COMPONENT
5389 -- [,[Entity =>] IDENTIFIER |
5390 -- SELECTED_COMPONENT |
5392 -- [,[Parameter_Types =>] PARAMETER_TYPES]
5393 -- [,[Result_Type =>] result_SUBTYPE_NAME]
5394 -- [,[Homonym_Number =>] INTEGER_LITERAL]);
5396 -- PARAMETER_TYPES ::= (SUBTYPE_NAME {, SUBTYPE_NAME})
5397 -- SUBTYPE_NAME ::= STRING_LITERAL
5399 when Pragma_Eliminate => Eliminate : declare
5400 Args : Args_List (1 .. 5);
5401 Names : constant Name_List (1 .. 5) := (
5404 Name_Parameter_Types,
5406 Name_Homonym_Number);
5408 Unit_Name : Node_Id renames Args (1);
5409 Entity : Node_Id renames Args (2);
5410 Parameter_Types : Node_Id renames Args (3);
5411 Result_Type : Node_Id renames Args (4);
5412 Homonym_Number : Node_Id renames Args (5);
5416 Check_Valid_Configuration_Pragma;
5417 Gather_Associations (Names, Args);
5419 if No (Unit_Name) then
5420 Error_Pragma ("missing Unit_Name argument for pragma%");
5424 and then (Present (Parameter_Types)
5426 Present (Result_Type)
5428 Present (Homonym_Number))
5430 Error_Pragma ("missing Entity argument for pragma%");
5433 Process_Eliminate_Pragma
5442 --------------------------
5443 -- Explicit_Overriding --
5444 --------------------------
5446 when Pragma_Explicit_Overriding =>
5447 Check_Valid_Configuration_Pragma;
5448 Check_Arg_Count (0);
5449 Explicit_Overriding := True;
5456 -- [ Convention =>] convention_IDENTIFIER,
5457 -- [ Entity =>] local_NAME
5458 -- [, [External_Name =>] static_string_EXPRESSION ]
5459 -- [, [Link_Name =>] static_string_EXPRESSION ]);
5461 when Pragma_Export => Export : declare
5466 Check_Ada_83_Warning;
5467 Check_At_Least_N_Arguments (2);
5468 Check_At_Most_N_Arguments (4);
5469 Process_Convention (C, Def_Id);
5471 if Ekind (Def_Id) /= E_Constant then
5472 Note_Possible_Modification (Expression (Arg2));
5475 Process_Interface_Name (Def_Id, Arg3, Arg4);
5476 Set_Exported (Def_Id, Arg2);
5479 ----------------------
5480 -- Export_Exception --
5481 ----------------------
5483 -- pragma Export_Exception (
5484 -- [Internal =>] LOCAL_NAME,
5485 -- [, [External =>] EXTERNAL_SYMBOL,]
5486 -- [, [Form =>] Ada | VMS]
5487 -- [, [Code =>] static_integer_EXPRESSION]);
5489 when Pragma_Export_Exception => Export_Exception : declare
5490 Args : Args_List (1 .. 4);
5491 Names : constant Name_List (1 .. 4) := (
5497 Internal : Node_Id renames Args (1);
5498 External : Node_Id renames Args (2);
5499 Form : Node_Id renames Args (3);
5500 Code : Node_Id renames Args (4);
5503 if Inside_A_Generic then
5504 Error_Pragma ("pragma% cannot be used for generic entities");
5507 Gather_Associations (Names, Args);
5508 Process_Extended_Import_Export_Exception_Pragma (
5509 Arg_Internal => Internal,
5510 Arg_External => External,
5514 if not Is_VMS_Exception (Entity (Internal)) then
5515 Set_Exported (Entity (Internal), Internal);
5517 end Export_Exception;
5519 ---------------------
5520 -- Export_Function --
5521 ---------------------
5523 -- pragma Export_Function (
5524 -- [Internal =>] LOCAL_NAME,
5525 -- [, [External =>] EXTERNAL_SYMBOL,]
5526 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
5527 -- [, [Result_Type =>] TYPE_DESIGNATOR]
5528 -- [, [Mechanism =>] MECHANISM]
5529 -- [, [Result_Mechanism =>] MECHANISM_NAME]);
5531 -- EXTERNAL_SYMBOL ::=
5533 -- | static_string_EXPRESSION
5535 -- PARAMETER_TYPES ::=
5537 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
5539 -- TYPE_DESIGNATOR ::=
5541 -- | subtype_Name ' Access
5545 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
5547 -- MECHANISM_ASSOCIATION ::=
5548 -- [formal_parameter_NAME =>] MECHANISM_NAME
5550 -- MECHANISM_NAME ::=
5553 -- | Descriptor [([Class =>] CLASS_NAME)]
5555 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
5557 when Pragma_Export_Function => Export_Function : declare
5558 Args : Args_List (1 .. 6);
5559 Names : constant Name_List (1 .. 6) := (
5562 Name_Parameter_Types,
5565 Name_Result_Mechanism);
5567 Internal : Node_Id renames Args (1);
5568 External : Node_Id renames Args (2);
5569 Parameter_Types : Node_Id renames Args (3);
5570 Result_Type : Node_Id renames Args (4);
5571 Mechanism : Node_Id renames Args (5);
5572 Result_Mechanism : Node_Id renames Args (6);
5576 Gather_Associations (Names, Args);
5577 Process_Extended_Import_Export_Subprogram_Pragma (
5578 Arg_Internal => Internal,
5579 Arg_External => External,
5580 Arg_Parameter_Types => Parameter_Types,
5581 Arg_Result_Type => Result_Type,
5582 Arg_Mechanism => Mechanism,
5583 Arg_Result_Mechanism => Result_Mechanism);
5584 end Export_Function;
5590 -- pragma Export_Object (
5591 -- [Internal =>] LOCAL_NAME,
5592 -- [, [External =>] EXTERNAL_SYMBOL]
5593 -- [, [Size =>] EXTERNAL_SYMBOL]);
5595 -- EXTERNAL_SYMBOL ::=
5597 -- | static_string_EXPRESSION
5599 -- PARAMETER_TYPES ::=
5601 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
5603 -- TYPE_DESIGNATOR ::=
5605 -- | subtype_Name ' Access
5609 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
5611 -- MECHANISM_ASSOCIATION ::=
5612 -- [formal_parameter_NAME =>] MECHANISM_NAME
5614 -- MECHANISM_NAME ::=
5617 -- | Descriptor [([Class =>] CLASS_NAME)]
5619 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
5621 when Pragma_Export_Object => Export_Object : declare
5622 Args : Args_List (1 .. 3);
5623 Names : constant Name_List (1 .. 3) := (
5628 Internal : Node_Id renames Args (1);
5629 External : Node_Id renames Args (2);
5630 Size : Node_Id renames Args (3);
5634 Gather_Associations (Names, Args);
5635 Process_Extended_Import_Export_Object_Pragma (
5636 Arg_Internal => Internal,
5637 Arg_External => External,
5641 ----------------------
5642 -- Export_Procedure --
5643 ----------------------
5645 -- pragma Export_Procedure (
5646 -- [Internal =>] LOCAL_NAME,
5647 -- [, [External =>] EXTERNAL_SYMBOL,]
5648 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
5649 -- [, [Mechanism =>] MECHANISM]);
5651 -- EXTERNAL_SYMBOL ::=
5653 -- | static_string_EXPRESSION
5655 -- PARAMETER_TYPES ::=
5657 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
5659 -- TYPE_DESIGNATOR ::=
5661 -- | subtype_Name ' Access
5665 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
5667 -- MECHANISM_ASSOCIATION ::=
5668 -- [formal_parameter_NAME =>] MECHANISM_NAME
5670 -- MECHANISM_NAME ::=
5673 -- | Descriptor [([Class =>] CLASS_NAME)]
5675 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
5677 when Pragma_Export_Procedure => Export_Procedure : declare
5678 Args : Args_List (1 .. 4);
5679 Names : constant Name_List (1 .. 4) := (
5682 Name_Parameter_Types,
5685 Internal : Node_Id renames Args (1);
5686 External : Node_Id renames Args (2);
5687 Parameter_Types : Node_Id renames Args (3);
5688 Mechanism : Node_Id renames Args (4);
5692 Gather_Associations (Names, Args);
5693 Process_Extended_Import_Export_Subprogram_Pragma (
5694 Arg_Internal => Internal,
5695 Arg_External => External,
5696 Arg_Parameter_Types => Parameter_Types,
5697 Arg_Mechanism => Mechanism);
5698 end Export_Procedure;
5704 -- pragma Export_Value (
5705 -- [Value =>] static_integer_EXPRESSION,
5706 -- [Link_Name =>] static_string_EXPRESSION);
5708 when Pragma_Export_Value =>
5710 Check_Arg_Count (2);
5712 Check_Optional_Identifier (Arg1, Name_Value);
5713 Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
5715 Check_Optional_Identifier (Arg2, Name_Link_Name);
5716 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
5718 -----------------------------
5719 -- Export_Valued_Procedure --
5720 -----------------------------
5722 -- pragma Export_Valued_Procedure (
5723 -- [Internal =>] LOCAL_NAME,
5724 -- [, [External =>] EXTERNAL_SYMBOL,]
5725 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
5726 -- [, [Mechanism =>] MECHANISM]);
5728 -- EXTERNAL_SYMBOL ::=
5730 -- | static_string_EXPRESSION
5732 -- PARAMETER_TYPES ::=
5734 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
5736 -- TYPE_DESIGNATOR ::=
5738 -- | subtype_Name ' Access
5742 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
5744 -- MECHANISM_ASSOCIATION ::=
5745 -- [formal_parameter_NAME =>] MECHANISM_NAME
5747 -- MECHANISM_NAME ::=
5750 -- | Descriptor [([Class =>] CLASS_NAME)]
5752 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
5754 when Pragma_Export_Valued_Procedure =>
5755 Export_Valued_Procedure : declare
5756 Args : Args_List (1 .. 4);
5757 Names : constant Name_List (1 .. 4) := (
5760 Name_Parameter_Types,
5763 Internal : Node_Id renames Args (1);
5764 External : Node_Id renames Args (2);
5765 Parameter_Types : Node_Id renames Args (3);
5766 Mechanism : Node_Id renames Args (4);
5770 Gather_Associations (Names, Args);
5771 Process_Extended_Import_Export_Subprogram_Pragma (
5772 Arg_Internal => Internal,
5773 Arg_External => External,
5774 Arg_Parameter_Types => Parameter_Types,
5775 Arg_Mechanism => Mechanism);
5776 end Export_Valued_Procedure;
5782 -- pragma Extend_System ([Name =>] Identifier);
5784 when Pragma_Extend_System => Extend_System : declare
5787 Check_Valid_Configuration_Pragma;
5788 Check_Arg_Count (1);
5789 Check_Optional_Identifier (Arg1, Name_Name);
5790 Check_Arg_Is_Identifier (Arg1);
5792 Get_Name_String (Chars (Expression (Arg1)));
5795 and then Name_Buffer (1 .. 4) = "aux_"
5797 if Present (System_Extend_Pragma_Arg) then
5798 if Chars (Expression (Arg1)) =
5799 Chars (Expression (System_Extend_Pragma_Arg))
5803 Error_Msg_Sloc := Sloc (System_Extend_Pragma_Arg);
5804 Error_Pragma ("pragma% conflicts with that at#");
5808 System_Extend_Pragma_Arg := Arg1;
5810 if not GNAT_Mode then
5811 System_Extend_Unit := Arg1;
5815 Error_Pragma ("incorrect name for pragma%, must be Aux_xxx");
5819 ------------------------
5820 -- Extensions_Allowed --
5821 ------------------------
5823 -- pragma Extensions_Allowed (ON | OFF);
5825 when Pragma_Extensions_Allowed =>
5827 Check_Arg_Count (1);
5828 Check_No_Identifiers;
5829 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
5830 Extensions_Allowed := (Chars (Expression (Arg1)) = Name_On);
5836 -- pragma External (
5837 -- [ Convention =>] convention_IDENTIFIER,
5838 -- [ Entity =>] local_NAME
5839 -- [, [External_Name =>] static_string_EXPRESSION ]
5840 -- [, [Link_Name =>] static_string_EXPRESSION ]);
5842 when Pragma_External => External : declare
5848 Check_At_Least_N_Arguments (2);
5849 Check_At_Most_N_Arguments (4);
5850 Process_Convention (C, Def_Id);
5851 Note_Possible_Modification (Expression (Arg2));
5852 Process_Interface_Name (Def_Id, Arg3, Arg4);
5853 Set_Exported (Def_Id, Arg2);
5856 --------------------------
5857 -- External_Name_Casing --
5858 --------------------------
5860 -- pragma External_Name_Casing (
5861 -- UPPERCASE | LOWERCASE
5862 -- [, AS_IS | UPPERCASE | LOWERCASE]);
5864 when Pragma_External_Name_Casing =>
5866 External_Name_Casing : declare
5869 Check_No_Identifiers;
5871 if Arg_Count = 2 then
5873 (Arg2, Name_As_Is, Name_Uppercase, Name_Lowercase);
5875 case Chars (Get_Pragma_Arg (Arg2)) is
5877 Opt.External_Name_Exp_Casing := As_Is;
5879 when Name_Uppercase =>
5880 Opt.External_Name_Exp_Casing := Uppercase;
5882 when Name_Lowercase =>
5883 Opt.External_Name_Exp_Casing := Lowercase;
5890 Check_Arg_Count (1);
5893 Check_Arg_Is_One_Of (Arg1, Name_Uppercase, Name_Lowercase);
5895 case Chars (Get_Pragma_Arg (Arg1)) is
5896 when Name_Uppercase =>
5897 Opt.External_Name_Imp_Casing := Uppercase;
5899 when Name_Lowercase =>
5900 Opt.External_Name_Imp_Casing := Lowercase;
5905 end External_Name_Casing;
5907 ---------------------------
5908 -- Finalize_Storage_Only --
5909 ---------------------------
5911 -- pragma Finalize_Storage_Only (first_subtype_LOCAL_NAME);
5913 when Pragma_Finalize_Storage_Only => Finalize_Storage : declare
5914 Assoc : constant Node_Id := Arg1;
5915 Type_Id : constant Node_Id := Expression (Assoc);
5919 Check_No_Identifiers;
5920 Check_Arg_Count (1);
5921 Check_Arg_Is_Local_Name (Arg1);
5923 Find_Type (Type_Id);
5924 Typ := Entity (Type_Id);
5927 or else Rep_Item_Too_Early (Typ, N)
5931 Typ := Underlying_Type (Typ);
5934 if not Is_Controlled (Typ) then
5935 Error_Pragma ("pragma% must specify controlled type");
5938 Check_First_Subtype (Arg1);
5940 if Finalize_Storage_Only (Typ) then
5941 Error_Pragma ("duplicate pragma%, only one allowed");
5943 elsif not Rep_Item_Too_Late (Typ, N) then
5944 Set_Finalize_Storage_Only (Base_Type (Typ), True);
5946 end Finalize_Storage;
5948 --------------------------
5949 -- Float_Representation --
5950 --------------------------
5952 -- pragma Float_Representation (VAX_Float | IEEE_Float);
5954 when Pragma_Float_Representation => Float_Representation : declare
5962 if Arg_Count = 1 then
5963 Check_Valid_Configuration_Pragma;
5965 Check_Arg_Count (2);
5966 Check_Optional_Identifier (Arg2, Name_Entity);
5967 Check_Arg_Is_Local_Name (Arg2);
5970 Check_No_Identifier (Arg1);
5971 Check_Arg_Is_One_Of (Arg1, Name_VAX_Float, Name_IEEE_Float);
5973 if not OpenVMS_On_Target then
5974 if Chars (Expression (Arg1)) = Name_VAX_Float then
5976 ("?pragma% ignored (applies only to Open'V'M'S)");
5982 -- One argument case
5984 if Arg_Count = 1 then
5986 if Chars (Expression (Arg1)) = Name_VAX_Float then
5988 if Opt.Float_Format = 'I' then
5989 Error_Pragma ("'I'E'E'E format previously specified");
5992 Opt.Float_Format := 'V';
5995 if Opt.Float_Format = 'V' then
5996 Error_Pragma ("'V'A'X format previously specified");
5999 Opt.Float_Format := 'I';
6002 Set_Standard_Fpt_Formats;
6004 -- Two argument case
6007 Argx := Get_Pragma_Arg (Arg2);
6009 if not Is_Entity_Name (Argx)
6010 or else not Is_Floating_Point_Type (Entity (Argx))
6013 ("second argument of% pragma must be floating-point type",
6017 Ent := Entity (Argx);
6018 Digs := UI_To_Int (Digits_Value (Ent));
6020 -- Two arguments, VAX_Float case
6022 if Chars (Expression (Arg1)) = Name_VAX_Float then
6025 when 6 => Set_F_Float (Ent);
6026 when 9 => Set_D_Float (Ent);
6027 when 15 => Set_G_Float (Ent);
6031 ("wrong digits value, must be 6,9 or 15", Arg2);
6034 -- Two arguments, IEEE_Float case
6038 when 6 => Set_IEEE_Short (Ent);
6039 when 15 => Set_IEEE_Long (Ent);
6043 ("wrong digits value, must be 6 or 15", Arg2);
6047 end Float_Representation;
6053 -- pragma Ident (static_string_EXPRESSION)
6055 -- Note: pragma Comment shares this processing. Pragma Comment
6056 -- is identical to Ident, except that the restriction of the
6057 -- argument to 31 characters and the placement restrictions
6058 -- are not enforced for pragma Comment.
6060 when Pragma_Ident | Pragma_Comment => Ident : declare
6065 Check_Arg_Count (1);
6066 Check_No_Identifiers;
6067 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
6069 -- For pragma Ident, preserve DEC compatibility by requiring
6070 -- the pragma to appear in a declarative part or package spec.
6072 if Prag_Id = Pragma_Ident then
6073 Check_Is_In_Decl_Part_Or_Package_Spec;
6076 Str := Expr_Value_S (Expression (Arg1));
6083 GP := Parent (Parent (N));
6085 if Nkind (GP) = N_Package_Declaration
6087 Nkind (GP) = N_Generic_Package_Declaration
6092 -- If we have a compilation unit, then record the ident
6093 -- value, checking for improper duplication.
6095 if Nkind (GP) = N_Compilation_Unit then
6096 CS := Ident_String (Current_Sem_Unit);
6098 if Present (CS) then
6100 -- For Ident, we do not permit multiple instances
6102 if Prag_Id = Pragma_Ident then
6103 Error_Pragma ("duplicate% pragma not permitted");
6105 -- For Comment, we concatenate the string, unless we
6106 -- want to preserve the tree structure for ASIS.
6108 elsif not ASIS_Mode then
6109 Start_String (Strval (CS));
6110 Store_String_Char (' ');
6111 Store_String_Chars (Strval (Str));
6112 Set_Strval (CS, End_String);
6116 -- In VMS, the effect of IDENT is achieved by passing
6117 -- IDENTIFICATION=name as a --for-linker switch.
6119 if OpenVMS_On_Target then
6122 ("--for-linker=IDENTIFICATION=");
6123 String_To_Name_Buffer (Strval (Str));
6124 Store_String_Chars (Name_Buffer (1 .. Name_Len));
6126 -- Only the last processed IDENT is saved. The main
6127 -- purpose is so an IDENT associated with a main
6128 -- procedure will be used in preference to an IDENT
6129 -- associated with a with'd package.
6131 Replace_Linker_Option_String
6132 (End_String, "--for-linker=IDENTIFICATION=");
6135 Set_Ident_String (Current_Sem_Unit, Str);
6138 -- For subunits, we just ignore the Ident, since in GNAT
6139 -- these are not separate object files, and hence not
6140 -- separate units in the unit table.
6142 elsif Nkind (GP) = N_Subunit then
6145 -- Otherwise we have a misplaced pragma Ident, but we ignore
6146 -- this if we are in an instantiation, since it comes from
6147 -- a generic, and has no relevance to the instantiation.
6149 elsif Prag_Id = Pragma_Ident then
6150 if Instantiation_Location (Loc) = No_Location then
6151 Error_Pragma ("pragma% only allowed at outer level");
6162 -- [ Convention =>] convention_IDENTIFIER,
6163 -- [ Entity =>] local_NAME
6164 -- [, [External_Name =>] static_string_EXPRESSION ]
6165 -- [, [Link_Name =>] static_string_EXPRESSION ]);
6167 when Pragma_Import =>
6168 Check_Ada_83_Warning;
6169 Check_At_Least_N_Arguments (2);
6170 Check_At_Most_N_Arguments (4);
6171 Process_Import_Or_Interface;
6173 ----------------------
6174 -- Import_Exception --
6175 ----------------------
6177 -- pragma Import_Exception (
6178 -- [Internal =>] LOCAL_NAME,
6179 -- [, [External =>] EXTERNAL_SYMBOL,]
6180 -- [, [Form =>] Ada | VMS]
6181 -- [, [Code =>] static_integer_EXPRESSION]);
6183 when Pragma_Import_Exception => Import_Exception : declare
6184 Args : Args_List (1 .. 4);
6185 Names : constant Name_List (1 .. 4) := (
6191 Internal : Node_Id renames Args (1);
6192 External : Node_Id renames Args (2);
6193 Form : Node_Id renames Args (3);
6194 Code : Node_Id renames Args (4);
6197 Gather_Associations (Names, Args);
6199 if Present (External) and then Present (Code) then
6201 ("cannot give both External and Code options for pragma%");
6204 Process_Extended_Import_Export_Exception_Pragma (
6205 Arg_Internal => Internal,
6206 Arg_External => External,
6210 if not Is_VMS_Exception (Entity (Internal)) then
6211 Set_Imported (Entity (Internal));
6213 end Import_Exception;
6215 ---------------------
6216 -- Import_Function --
6217 ---------------------
6219 -- pragma Import_Function (
6220 -- [Internal =>] LOCAL_NAME,
6221 -- [, [External =>] EXTERNAL_SYMBOL]
6222 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6223 -- [, [Result_Type =>] SUBTYPE_MARK]
6224 -- [, [Mechanism =>] MECHANISM]
6225 -- [, [Result_Mechanism =>] MECHANISM_NAME]
6226 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
6228 -- EXTERNAL_SYMBOL ::=
6230 -- | static_string_EXPRESSION
6232 -- PARAMETER_TYPES ::=
6234 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6236 -- TYPE_DESIGNATOR ::=
6238 -- | subtype_Name ' Access
6242 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6244 -- MECHANISM_ASSOCIATION ::=
6245 -- [formal_parameter_NAME =>] MECHANISM_NAME
6247 -- MECHANISM_NAME ::=
6250 -- | Descriptor [([Class =>] CLASS_NAME)]
6252 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6254 when Pragma_Import_Function => Import_Function : declare
6255 Args : Args_List (1 .. 7);
6256 Names : constant Name_List (1 .. 7) := (
6259 Name_Parameter_Types,
6262 Name_Result_Mechanism,
6263 Name_First_Optional_Parameter);
6265 Internal : Node_Id renames Args (1);
6266 External : Node_Id renames Args (2);
6267 Parameter_Types : Node_Id renames Args (3);
6268 Result_Type : Node_Id renames Args (4);
6269 Mechanism : Node_Id renames Args (5);
6270 Result_Mechanism : Node_Id renames Args (6);
6271 First_Optional_Parameter : Node_Id renames Args (7);
6275 Gather_Associations (Names, Args);
6276 Process_Extended_Import_Export_Subprogram_Pragma (
6277 Arg_Internal => Internal,
6278 Arg_External => External,
6279 Arg_Parameter_Types => Parameter_Types,
6280 Arg_Result_Type => Result_Type,
6281 Arg_Mechanism => Mechanism,
6282 Arg_Result_Mechanism => Result_Mechanism,
6283 Arg_First_Optional_Parameter => First_Optional_Parameter);
6284 end Import_Function;
6290 -- pragma Import_Object (
6291 -- [Internal =>] LOCAL_NAME,
6292 -- [, [External =>] EXTERNAL_SYMBOL]
6293 -- [, [Size =>] EXTERNAL_SYMBOL]);
6295 -- EXTERNAL_SYMBOL ::=
6297 -- | static_string_EXPRESSION
6299 when Pragma_Import_Object => Import_Object : declare
6300 Args : Args_List (1 .. 3);
6301 Names : constant Name_List (1 .. 3) := (
6306 Internal : Node_Id renames Args (1);
6307 External : Node_Id renames Args (2);
6308 Size : Node_Id renames Args (3);
6312 Gather_Associations (Names, Args);
6313 Process_Extended_Import_Export_Object_Pragma (
6314 Arg_Internal => Internal,
6315 Arg_External => External,
6319 ----------------------
6320 -- Import_Procedure --
6321 ----------------------
6323 -- pragma Import_Procedure (
6324 -- [Internal =>] LOCAL_NAME,
6325 -- [, [External =>] EXTERNAL_SYMBOL]
6326 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6327 -- [, [Mechanism =>] MECHANISM]
6328 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
6330 -- EXTERNAL_SYMBOL ::=
6332 -- | static_string_EXPRESSION
6334 -- PARAMETER_TYPES ::=
6336 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6338 -- TYPE_DESIGNATOR ::=
6340 -- | subtype_Name ' Access
6344 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6346 -- MECHANISM_ASSOCIATION ::=
6347 -- [formal_parameter_NAME =>] MECHANISM_NAME
6349 -- MECHANISM_NAME ::=
6352 -- | Descriptor [([Class =>] CLASS_NAME)]
6354 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6356 when Pragma_Import_Procedure => Import_Procedure : declare
6357 Args : Args_List (1 .. 5);
6358 Names : constant Name_List (1 .. 5) := (
6361 Name_Parameter_Types,
6363 Name_First_Optional_Parameter);
6365 Internal : Node_Id renames Args (1);
6366 External : Node_Id renames Args (2);
6367 Parameter_Types : Node_Id renames Args (3);
6368 Mechanism : Node_Id renames Args (4);
6369 First_Optional_Parameter : Node_Id renames Args (5);
6373 Gather_Associations (Names, Args);
6374 Process_Extended_Import_Export_Subprogram_Pragma (
6375 Arg_Internal => Internal,
6376 Arg_External => External,
6377 Arg_Parameter_Types => Parameter_Types,
6378 Arg_Mechanism => Mechanism,
6379 Arg_First_Optional_Parameter => First_Optional_Parameter);
6380 end Import_Procedure;
6382 -----------------------------
6383 -- Import_Valued_Procedure --
6384 -----------------------------
6386 -- pragma Import_Valued_Procedure (
6387 -- [Internal =>] LOCAL_NAME,
6388 -- [, [External =>] EXTERNAL_SYMBOL]
6389 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6390 -- [, [Mechanism =>] MECHANISM]
6391 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
6393 -- EXTERNAL_SYMBOL ::=
6395 -- | static_string_EXPRESSION
6397 -- PARAMETER_TYPES ::=
6399 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6401 -- TYPE_DESIGNATOR ::=
6403 -- | subtype_Name ' Access
6407 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6409 -- MECHANISM_ASSOCIATION ::=
6410 -- [formal_parameter_NAME =>] MECHANISM_NAME
6412 -- MECHANISM_NAME ::=
6415 -- | Descriptor [([Class =>] CLASS_NAME)]
6417 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6419 when Pragma_Import_Valued_Procedure =>
6420 Import_Valued_Procedure : declare
6421 Args : Args_List (1 .. 5);
6422 Names : constant Name_List (1 .. 5) := (
6425 Name_Parameter_Types,
6427 Name_First_Optional_Parameter);
6429 Internal : Node_Id renames Args (1);
6430 External : Node_Id renames Args (2);
6431 Parameter_Types : Node_Id renames Args (3);
6432 Mechanism : Node_Id renames Args (4);
6433 First_Optional_Parameter : Node_Id renames Args (5);
6437 Gather_Associations (Names, Args);
6438 Process_Extended_Import_Export_Subprogram_Pragma (
6439 Arg_Internal => Internal,
6440 Arg_External => External,
6441 Arg_Parameter_Types => Parameter_Types,
6442 Arg_Mechanism => Mechanism,
6443 Arg_First_Optional_Parameter => First_Optional_Parameter);
6444 end Import_Valued_Procedure;
6446 ------------------------
6447 -- Initialize_Scalars --
6448 ------------------------
6450 -- pragma Initialize_Scalars;
6452 when Pragma_Initialize_Scalars =>
6454 Check_Arg_Count (0);
6455 Check_Valid_Configuration_Pragma;
6456 Check_Restriction (No_Initialize_Scalars, N);
6458 if not Restriction_Active (No_Initialize_Scalars) then
6459 Init_Or_Norm_Scalars := True;
6460 Initialize_Scalars := True;
6467 -- pragma Inline ( NAME {, NAME} );
6469 when Pragma_Inline =>
6471 -- Pragma is active if inlining option is active
6473 if Inline_Active then
6474 Process_Inline (True);
6476 -- Pragma is active in a predefined file in config run time mode
6478 elsif Configurable_Run_Time_Mode
6480 Is_Predefined_File_Name (Unit_File_Name (Current_Sem_Unit))
6482 Process_Inline (True);
6484 -- Otherwise inlining is not active
6487 Process_Inline (False);
6494 -- pragma Inline_Always ( NAME {, NAME} );
6496 when Pragma_Inline_Always =>
6497 Process_Inline (True);
6499 --------------------
6500 -- Inline_Generic --
6501 --------------------
6503 -- pragma Inline_Generic (NAME {, NAME});
6505 when Pragma_Inline_Generic =>
6506 Process_Generic_List;
6508 ----------------------
6509 -- Inspection_Point --
6510 ----------------------
6512 -- pragma Inspection_Point [(object_NAME {, object_NAME})];
6514 when Pragma_Inspection_Point => Inspection_Point : declare
6519 if Arg_Count > 0 then
6522 Exp := Expression (Arg);
6525 if not Is_Entity_Name (Exp)
6526 or else not Is_Object (Entity (Exp))
6528 Error_Pragma_Arg ("object name required", Arg);
6535 end Inspection_Point;
6541 -- pragma Interface (
6542 -- convention_IDENTIFIER,
6545 when Pragma_Interface =>
6547 Check_Arg_Count (2);
6548 Check_No_Identifiers;
6549 Process_Import_Or_Interface;
6551 --------------------
6552 -- Interface_Name --
6553 --------------------
6555 -- pragma Interface_Name (
6556 -- [ Entity =>] local_NAME
6557 -- [,[External_Name =>] static_string_EXPRESSION ]
6558 -- [,[Link_Name =>] static_string_EXPRESSION ]);
6560 when Pragma_Interface_Name => Interface_Name : declare
6568 Check_At_Least_N_Arguments (2);
6569 Check_At_Most_N_Arguments (3);
6570 Id := Expression (Arg1);
6573 if not Is_Entity_Name (Id) then
6575 ("first argument for pragma% must be entity name", Arg1);
6576 elsif Etype (Id) = Any_Type then
6579 Def_Id := Entity (Id);
6582 -- Special DEC-compatible processing for the object case,
6583 -- forces object to be imported.
6585 if Ekind (Def_Id) = E_Variable then
6586 Kill_Size_Check_Code (Def_Id);
6587 Note_Possible_Modification (Id);
6589 -- Initialization is not allowed for imported variable
6591 if Present (Expression (Parent (Def_Id)))
6592 and then Comes_From_Source (Expression (Parent (Def_Id)))
6594 Error_Msg_Sloc := Sloc (Def_Id);
6596 ("no initialization allowed for declaration of& #",
6600 -- For compatibility, support VADS usage of providing both
6601 -- pragmas Interface and Interface_Name to obtain the effect
6602 -- of a single Import pragma.
6604 if Is_Imported (Def_Id)
6605 and then Present (First_Rep_Item (Def_Id))
6606 and then Nkind (First_Rep_Item (Def_Id)) = N_Pragma
6607 and then Chars (First_Rep_Item (Def_Id)) = Name_Interface
6611 Set_Imported (Def_Id);
6614 Set_Is_Public (Def_Id);
6615 Process_Interface_Name (Def_Id, Arg2, Arg3);
6618 -- Otherwise must be subprogram
6620 elsif not Is_Subprogram (Def_Id) then
6622 ("argument of pragma% is not subprogram", Arg1);
6625 Check_At_Most_N_Arguments (3);
6629 -- Loop through homonyms
6632 Def_Id := Get_Base_Subprogram (Hom_Id);
6634 if Is_Imported (Def_Id) then
6635 Process_Interface_Name (Def_Id, Arg2, Arg3);
6639 Hom_Id := Homonym (Hom_Id);
6641 exit when No (Hom_Id)
6642 or else Scope (Hom_Id) /= Current_Scope;
6647 ("argument of pragma% is not imported subprogram",
6653 -----------------------
6654 -- Interrupt_Handler --
6655 -----------------------
6657 -- pragma Interrupt_Handler (handler_NAME);
6659 when Pragma_Interrupt_Handler =>
6660 Check_Ada_83_Warning;
6661 Check_Arg_Count (1);
6662 Check_No_Identifiers;
6664 if No_Run_Time_Mode then
6665 Error_Msg_CRT ("Interrupt_Handler pragma", N);
6667 Check_Interrupt_Or_Attach_Handler;
6668 Process_Interrupt_Or_Attach_Handler;
6671 ------------------------
6672 -- Interrupt_Priority --
6673 ------------------------
6675 -- pragma Interrupt_Priority [(EXPRESSION)];
6677 when Pragma_Interrupt_Priority => Interrupt_Priority : declare
6678 P : constant Node_Id := Parent (N);
6682 Check_Ada_83_Warning;
6684 if Arg_Count /= 0 then
6685 Arg := Expression (Arg1);
6686 Check_Arg_Count (1);
6687 Check_No_Identifiers;
6689 -- The expression must be analyzed in the special manner
6690 -- described in "Handling of Default and Per-Object
6691 -- Expressions" in sem.ads.
6693 Analyze_Per_Use_Expression (Arg, RTE (RE_Interrupt_Priority));
6696 if Nkind (P) /= N_Task_Definition
6697 and then Nkind (P) /= N_Protected_Definition
6702 elsif Has_Priority_Pragma (P) then
6703 Error_Pragma ("duplicate pragma% not allowed");
6706 Set_Has_Priority_Pragma (P, True);
6707 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
6709 end Interrupt_Priority;
6711 ---------------------
6712 -- Interrupt_State --
6713 ---------------------
6715 -- pragma Interrupt_State (
6716 -- [Name =>] INTERRUPT_ID,
6717 -- [State =>] INTERRUPT_STATE);
6719 -- INTERRUPT_ID => IDENTIFIER | static_integer_EXPRESSION
6720 -- INTERRUPT_STATE => System | Runtime | User
6722 -- Note: if the interrupt id is given as an identifier, then
6723 -- it must be one of the identifiers in Ada.Interrupts.Names.
6724 -- Otherwise it is given as a static integer expression which
6725 -- must be in the range of Ada.Interrupts.Interrupt_ID.
6727 when Pragma_Interrupt_State => Interrupt_State : declare
6729 Int_Id : constant Entity_Id := RTE (RE_Interrupt_ID);
6730 -- This is the entity Ada.Interrupts.Interrupt_ID;
6732 State_Type : Character;
6733 -- Set to 's'/'r'/'u' for System/Runtime/User
6736 -- Index to entry in Interrupt_States table
6739 -- Value of interrupt
6741 Arg1X : constant Node_Id := Get_Pragma_Arg (Arg1);
6742 -- The first argument to the pragma
6744 Int_Ent : Entity_Id;
6745 -- Interrupt entity in Ada.Interrupts.Names
6749 Check_Arg_Count (2);
6751 Check_Optional_Identifier (Arg1, Name_Name);
6752 Check_Optional_Identifier (Arg2, "state");
6753 Check_Arg_Is_Identifier (Arg2);
6755 -- First argument is identifier
6757 if Nkind (Arg1X) = N_Identifier then
6759 -- Search list of names in Ada.Interrupts.Names
6761 Int_Ent := First_Entity (RTE (RE_Names));
6763 if No (Int_Ent) then
6764 Error_Pragma_Arg ("invalid interrupt name", Arg1);
6766 elsif Chars (Int_Ent) = Chars (Arg1X) then
6767 Int_Val := Expr_Value (Constant_Value (Int_Ent));
6771 Next_Entity (Int_Ent);
6774 -- First argument is not an identifier, so it must be a
6775 -- static expression of type Ada.Interrupts.Interrupt_ID.
6778 Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
6779 Int_Val := Expr_Value (Arg1X);
6781 if Int_Val < Expr_Value (Type_Low_Bound (Int_Id))
6783 Int_Val > Expr_Value (Type_High_Bound (Int_Id))
6786 ("value not in range of type " &
6787 """Ada.Interrupts.Interrupt_'I'D""", Arg1);
6793 case Chars (Get_Pragma_Arg (Arg2)) is
6794 when Name_Runtime => State_Type := 'r';
6795 when Name_System => State_Type := 's';
6796 when Name_User => State_Type := 'u';
6799 Error_Pragma_Arg ("invalid interrupt state", Arg2);
6802 -- Check if entry is already stored
6804 IST_Num := Interrupt_States.First;
6806 -- If entry not found, add it
6808 if IST_Num > Interrupt_States.Last then
6809 Interrupt_States.Append
6810 ((Interrupt_Number => UI_To_Int (Int_Val),
6811 Interrupt_State => State_Type,
6812 Pragma_Loc => Loc));
6815 -- Case of entry for the same entry
6817 elsif Int_Val = Interrupt_States.Table (IST_Num).
6820 -- If state matches, done, no need to make redundant entry
6823 State_Type = Interrupt_States.Table (IST_Num).
6826 -- Otherwise if state does not match, error
6829 Interrupt_States.Table (IST_Num).Pragma_Loc;
6831 ("state conflicts with that given at #", Arg2);
6835 IST_Num := IST_Num + 1;
6837 end Interrupt_State;
6839 ----------------------
6840 -- Java_Constructor --
6841 ----------------------
6843 -- pragma Java_Constructor ([Entity =>] LOCAL_NAME);
6845 when Pragma_Java_Constructor => Java_Constructor : declare
6852 Check_Arg_Count (1);
6853 Check_Optional_Identifier (Arg1, Name_Entity);
6854 Check_Arg_Is_Local_Name (Arg1);
6856 Id := Expression (Arg1);
6857 Find_Program_Unit_Name (Id);
6859 -- If we did not find the name, we are done
6861 if Etype (Id) = Any_Type then
6865 Hom_Id := Entity (Id);
6867 -- Loop through homonyms
6870 Def_Id := Get_Base_Subprogram (Hom_Id);
6872 -- The constructor is required to be a function returning
6873 -- an access type whose designated type has convention Java.
6875 if Ekind (Def_Id) = E_Function
6876 and then Ekind (Etype (Def_Id)) in Access_Kind
6879 (Designated_Type (Etype (Def_Id))) = Convention_Java
6882 (Root_Type (Designated_Type (Etype (Def_Id))))
6885 Set_Is_Constructor (Def_Id);
6886 Set_Convention (Def_Id, Convention_Java);
6890 ("pragma% requires function returning a 'Java access type",
6894 Hom_Id := Homonym (Hom_Id);
6896 exit when No (Hom_Id) or else Scope (Hom_Id) /= Current_Scope;
6898 end Java_Constructor;
6900 ----------------------
6901 -- Java_Interface --
6902 ----------------------
6904 -- pragma Java_Interface ([Entity =>] LOCAL_NAME);
6906 when Pragma_Java_Interface => Java_Interface : declare
6912 Check_Arg_Count (1);
6913 Check_Optional_Identifier (Arg1, Name_Entity);
6914 Check_Arg_Is_Local_Name (Arg1);
6916 Arg := Expression (Arg1);
6919 if Etype (Arg) = Any_Type then
6923 if not Is_Entity_Name (Arg)
6924 or else not Is_Type (Entity (Arg))
6926 Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
6929 Typ := Underlying_Type (Entity (Arg));
6931 -- For now we simply check some of the semantic constraints
6932 -- on the type. This currently leaves out some restrictions
6933 -- on interface types, namely that the parent type must be
6934 -- java.lang.Object.Typ and that all primitives of the type
6935 -- should be declared abstract. ???
6937 if not Is_Tagged_Type (Typ) or else not Is_Abstract (Typ) then
6938 Error_Pragma_Arg ("pragma% requires an abstract "
6939 & "tagged type", Arg1);
6941 elsif not Has_Discriminants (Typ)
6942 or else Ekind (Etype (First_Discriminant (Typ)))
6943 /= E_Anonymous_Access_Type
6945 not Is_Class_Wide_Type
6946 (Designated_Type (Etype (First_Discriminant (Typ))))
6949 ("type must have a class-wide access discriminant", Arg1);
6957 -- pragma Keep_Names ([On => ] local_NAME);
6959 when Pragma_Keep_Names => Keep_Names : declare
6964 Check_Arg_Count (1);
6965 Check_Optional_Identifier (Arg1, Name_On);
6966 Check_Arg_Is_Local_Name (Arg1);
6968 Arg := Expression (Arg1);
6971 if Etype (Arg) = Any_Type then
6975 if not Is_Entity_Name (Arg)
6976 or else Ekind (Entity (Arg)) /= E_Enumeration_Type
6979 ("pragma% requires a local enumeration type", Arg1);
6982 Set_Discard_Names (Entity (Arg), False);
6989 -- pragma License (RESTRICTED | UNRESRICTED | GPL | MODIFIED_GPL);
6991 when Pragma_License =>
6993 Check_Arg_Count (1);
6994 Check_No_Identifiers;
6995 Check_Valid_Configuration_Pragma;
6996 Check_Arg_Is_Identifier (Arg1);
6999 Sind : constant Source_File_Index :=
7000 Source_Index (Current_Sem_Unit);
7003 case Chars (Get_Pragma_Arg (Arg1)) is
7005 Set_License (Sind, GPL);
7007 when Name_Modified_GPL =>
7008 Set_License (Sind, Modified_GPL);
7010 when Name_Restricted =>
7011 Set_License (Sind, Restricted);
7013 when Name_Unrestricted =>
7014 Set_License (Sind, Unrestricted);
7017 Error_Pragma_Arg ("invalid license name", Arg1);
7025 -- pragma Link_With (string_EXPRESSION {, string_EXPRESSION});
7027 when Pragma_Link_With => Link_With : declare
7033 if Operating_Mode = Generate_Code
7034 and then In_Extended_Main_Source_Unit (N)
7036 Check_At_Least_N_Arguments (1);
7037 Check_No_Identifiers;
7038 Check_Is_In_Decl_Part_Or_Package_Spec;
7039 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
7043 while Present (Arg) loop
7044 Check_Arg_Is_Static_Expression (Arg, Standard_String);
7046 -- Store argument, converting sequences of spaces
7047 -- to a single null character (this is one of the
7048 -- differences in processing between Link_With
7049 -- and Linker_Options).
7052 C : constant Char_Code := Get_Char_Code (' ');
7053 S : constant String_Id :=
7054 Strval (Expr_Value_S (Expression (Arg)));
7055 L : constant Nat := String_Length (S);
7058 procedure Skip_Spaces;
7059 -- Advance F past any spaces
7061 procedure Skip_Spaces is
7063 while F <= L and then Get_String_Char (S, F) = C loop
7069 Skip_Spaces; -- skip leading spaces
7071 -- Loop through characters, changing any embedded
7072 -- sequence of spaces to a single null character
7073 -- (this is how Link_With/Linker_Options differ)
7076 if Get_String_Char (S, F) = C then
7079 Store_String_Char (ASCII.NUL);
7082 Store_String_Char (Get_String_Char (S, F));
7090 if Present (Arg) then
7091 Store_String_Char (ASCII.NUL);
7095 Store_Linker_Option_String (End_String);
7103 -- pragma Linker_Alias (
7104 -- [Entity =>] LOCAL_NAME
7105 -- [Alias =>] static_string_EXPRESSION);
7107 when Pragma_Linker_Alias =>
7109 Check_Arg_Count (2);
7110 Check_Optional_Identifier (Arg1, Name_Entity);
7111 Check_Optional_Identifier (Arg2, "alias");
7112 Check_Arg_Is_Library_Level_Local_Name (Arg1);
7113 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
7115 -- The only processing required is to link this item on to the
7116 -- list of rep items for the given entity. This is accomplished
7117 -- by the call to Rep_Item_Too_Late (when no error is detected
7118 -- and False is returned).
7120 if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
7123 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
7126 --------------------
7127 -- Linker_Options --
7128 --------------------
7130 -- pragma Linker_Options (string_EXPRESSION {, string_EXPRESSION});
7132 when Pragma_Linker_Options => Linker_Options : declare
7136 Check_Ada_83_Warning;
7137 Check_No_Identifiers;
7138 Check_Arg_Count (1);
7139 Check_Is_In_Decl_Part_Or_Package_Spec;
7141 if Operating_Mode = Generate_Code
7142 and then In_Extended_Main_Source_Unit (N)
7144 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
7145 Start_String (Strval (Expr_Value_S (Expression (Arg1))));
7148 while Present (Arg) loop
7149 Check_Arg_Is_Static_Expression (Arg, Standard_String);
7150 Store_String_Char (ASCII.NUL);
7152 (Strval (Expr_Value_S (Expression (Arg))));
7156 Store_Linker_Option_String (End_String);
7160 --------------------
7161 -- Linker_Section --
7162 --------------------
7164 -- pragma Linker_Section (
7165 -- [Entity =>] LOCAL_NAME
7166 -- [Section =>] static_string_EXPRESSION);
7168 when Pragma_Linker_Section =>
7170 Check_Arg_Count (2);
7171 Check_Optional_Identifier (Arg1, Name_Entity);
7172 Check_Optional_Identifier (Arg2, Name_Section);
7173 Check_Arg_Is_Library_Level_Local_Name (Arg1);
7174 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
7176 -- The only processing required is to link this item on to the
7177 -- list of rep items for the given entity. This is accomplished
7178 -- by the call to Rep_Item_Too_Late (when no error is detected
7179 -- and False is returned).
7181 if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
7184 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
7191 -- pragma List (On | Off)
7193 -- There is nothing to do here, since we did all the processing
7194 -- for this pragma in Par.Prag (so that it works properly even in
7195 -- syntax only mode)
7200 --------------------
7201 -- Locking_Policy --
7202 --------------------
7204 -- pragma Locking_Policy (policy_IDENTIFIER);
7206 when Pragma_Locking_Policy => declare
7210 Check_Ada_83_Warning;
7211 Check_Arg_Count (1);
7212 Check_No_Identifiers;
7213 Check_Arg_Is_Locking_Policy (Arg1);
7214 Check_Valid_Configuration_Pragma;
7215 Get_Name_String (Chars (Expression (Arg1)));
7216 LP := Fold_Upper (Name_Buffer (1));
7218 if Locking_Policy /= ' '
7219 and then Locking_Policy /= LP
7221 Error_Msg_Sloc := Locking_Policy_Sloc;
7222 Error_Pragma ("locking policy incompatible with policy#");
7224 -- Set new policy, but always preserve System_Location since
7225 -- we like the error message with the run time name.
7228 Locking_Policy := LP;
7230 if Locking_Policy_Sloc /= System_Location then
7231 Locking_Policy_Sloc := Loc;
7240 -- pragma Long_Float (D_Float | G_Float);
7242 when Pragma_Long_Float =>
7244 Check_Valid_Configuration_Pragma;
7245 Check_Arg_Count (1);
7246 Check_No_Identifier (Arg1);
7247 Check_Arg_Is_One_Of (Arg1, Name_D_Float, Name_G_Float);
7249 if not OpenVMS_On_Target then
7250 Error_Pragma ("?pragma% ignored (applies only to Open'V'M'S)");
7255 if Chars (Expression (Arg1)) = Name_D_Float then
7256 if Opt.Float_Format_Long = 'G' then
7257 Error_Pragma ("G_Float previously specified");
7260 Opt.Float_Format_Long := 'D';
7262 -- G_Float case (this is the default, does not need overriding)
7265 if Opt.Float_Format_Long = 'D' then
7266 Error_Pragma ("D_Float previously specified");
7269 Opt.Float_Format_Long := 'G';
7272 Set_Standard_Fpt_Formats;
7274 -----------------------
7275 -- Machine_Attribute --
7276 -----------------------
7278 -- pragma Machine_Attribute (
7279 -- [Entity =>] LOCAL_NAME,
7280 -- [Attribute_Name =>] static_string_EXPRESSION
7281 -- [,[Info =>] static_string_EXPRESSION] );
7283 when Pragma_Machine_Attribute => Machine_Attribute : declare
7289 if Arg_Count = 3 then
7290 Check_Optional_Identifier (Arg3, "info");
7291 Check_Arg_Is_Static_Expression (Arg3, Standard_String);
7293 Check_Arg_Count (2);
7296 Check_Arg_Is_Local_Name (Arg1);
7297 Check_Optional_Identifier (Arg2, "attribute_name");
7298 Check_Optional_Identifier (Arg1, Name_Entity);
7299 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
7300 Def_Id := Entity (Expression (Arg1));
7302 if Is_Access_Type (Def_Id) then
7303 Def_Id := Designated_Type (Def_Id);
7306 if Rep_Item_Too_Early (Def_Id, N) then
7310 Def_Id := Underlying_Type (Def_Id);
7312 -- The only processing required is to link this item on to the
7313 -- list of rep items for the given entity. This is accomplished
7314 -- by the call to Rep_Item_Too_Late (when no error is detected
7315 -- and False is returned).
7317 if Rep_Item_Too_Late (Def_Id, N) then
7320 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
7322 end Machine_Attribute;
7328 -- pragma Main_Storage
7329 -- (MAIN_STORAGE_OPTION [, MAIN_STORAGE_OPTION]);
7331 -- MAIN_STORAGE_OPTION ::=
7332 -- [WORKING_STORAGE =>] static_SIMPLE_EXPRESSION
7333 -- | [TOP_GUARD =>] static_SIMPLE_EXPRESSION
7335 when Pragma_Main => Main : declare
7336 Args : Args_List (1 .. 3);
7337 Names : constant Name_List (1 .. 3) := (
7339 Name_Task_Stack_Size_Default,
7340 Name_Time_Slicing_Enabled);
7346 Gather_Associations (Names, Args);
7348 for J in 1 .. 2 loop
7349 if Present (Args (J)) then
7350 Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
7354 if Present (Args (3)) then
7355 Check_Arg_Is_Static_Expression (Args (3), Standard_Boolean);
7359 while Present (Nod) loop
7360 if Nkind (Nod) = N_Pragma
7361 and then Chars (Nod) = Name_Main
7363 Error_Msg_Name_1 := Chars (N);
7364 Error_Msg_N ("duplicate pragma% not permitted", Nod);
7375 -- pragma Main_Storage
7376 -- (MAIN_STORAGE_OPTION [, MAIN_STORAGE_OPTION]);
7378 -- MAIN_STORAGE_OPTION ::=
7379 -- [WORKING_STORAGE =>] static_SIMPLE_EXPRESSION
7380 -- | [TOP_GUARD =>] static_SIMPLE_EXPRESSION
7382 when Pragma_Main_Storage => Main_Storage : declare
7383 Args : Args_List (1 .. 2);
7384 Names : constant Name_List (1 .. 2) := (
7385 Name_Working_Storage,
7392 Gather_Associations (Names, Args);
7394 for J in 1 .. 2 loop
7395 if Present (Args (J)) then
7396 Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
7400 Check_In_Main_Program;
7403 while Present (Nod) loop
7404 if Nkind (Nod) = N_Pragma
7405 and then Chars (Nod) = Name_Main_Storage
7407 Error_Msg_Name_1 := Chars (N);
7408 Error_Msg_N ("duplicate pragma% not permitted", Nod);
7419 -- pragma Memory_Size (NUMERIC_LITERAL)
7421 when Pragma_Memory_Size =>
7424 -- Memory size is simply ignored
7426 Check_No_Identifiers;
7427 Check_Arg_Count (1);
7428 Check_Arg_Is_Integer_Literal (Arg1);
7434 -- pragma No_Return (procedure_LOCAL_NAME);
7436 when Pragma_No_Return => No_Return : declare
7443 Check_Arg_Count (1);
7444 Check_No_Identifiers;
7445 Check_Arg_Is_Local_Name (Arg1);
7446 Id := Expression (Arg1);
7449 if not Is_Entity_Name (Id) then
7450 Error_Pragma_Arg ("entity name required", Arg1);
7453 if Etype (Id) = Any_Type then
7461 and then Scope (E) = Current_Scope
7463 if Ekind (E) = E_Procedure
7464 or else Ekind (E) = E_Generic_Procedure
7474 Error_Pragma ("no procedures found for pragma%");
7482 -- pragma Obsolescent [(static_string_EXPRESSION)];
7484 when Pragma_Obsolescent => Obsolescent : declare
7487 Check_At_Most_N_Arguments (1);
7488 Check_No_Identifiers;
7490 if Arg_Count = 1 then
7491 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
7495 or else (Nkind (Prev (N))) /= N_Subprogram_Declaration
7498 ("pragma% misplaced, must immediately " &
7499 "follow subprogram spec");
7507 -- pragma No_Run_Time
7509 -- Note: this pragma is retained for backwards compatibiltiy.
7510 -- See body of Rtsfind for full details on its handling.
7512 when Pragma_No_Run_Time =>
7514 Check_Valid_Configuration_Pragma;
7515 Check_Arg_Count (0);
7517 No_Run_Time_Mode := True;
7518 Configurable_Run_Time_Mode := True;
7521 Word32 : constant Boolean := Ttypes.System_Word_Size = 32;
7524 Duration_32_Bits_On_Target := True;
7528 Set_Restriction (No_Finalization, N);
7529 Set_Restriction (No_Exception_Handlers, N);
7530 Set_Restriction (Max_Tasks, N, 0);
7531 Set_Restriction (No_Tasking, N);
7533 -----------------------
7534 -- Normalize_Scalars --
7535 -----------------------
7537 -- pragma Normalize_Scalars;
7539 when Pragma_Normalize_Scalars =>
7540 Check_Ada_83_Warning;
7541 Check_Arg_Count (0);
7542 Check_Valid_Configuration_Pragma;
7543 Normalize_Scalars := True;
7544 Init_Or_Norm_Scalars := True;
7550 -- pragma Optimize (Time | Space);
7552 -- The actual check for optimize is done in Gigi. Note that this
7553 -- pragma does not actually change the optimization setting, it
7554 -- simply checks that it is consistent with the pragma.
7556 when Pragma_Optimize =>
7557 Check_No_Identifiers;
7558 Check_Arg_Count (1);
7559 Check_Arg_Is_One_Of (Arg1, Name_Time, Name_Space, Name_Off);
7561 -------------------------
7562 -- Optional_Overriding --
7563 -------------------------
7565 -- These pragmas are treated as part of the previous subprogram
7566 -- declaration, and analyzed immediately after it (see sem_ch6,
7567 -- Check_Overriding_Operation). If the pragma has not been analyzed
7568 -- yet, it appears in the wrong place.
7570 when Pragma_Optional_Overriding =>
7571 Error_Msg_N ("pragma must appear immediately after subprogram", N);
7577 when Pragma_Overriding =>
7578 Error_Msg_N ("pragma must appear immediately after subprogram", N);
7584 -- pragma Pack (first_subtype_LOCAL_NAME);
7586 when Pragma_Pack => Pack : declare
7587 Assoc : constant Node_Id := Arg1;
7592 Check_No_Identifiers;
7593 Check_Arg_Count (1);
7594 Check_Arg_Is_Local_Name (Arg1);
7596 Type_Id := Expression (Assoc);
7597 Find_Type (Type_Id);
7598 Typ := Entity (Type_Id);
7601 or else Rep_Item_Too_Early (Typ, N)
7605 Typ := Underlying_Type (Typ);
7608 if not Is_Array_Type (Typ) and then not Is_Record_Type (Typ) then
7609 Error_Pragma ("pragma% must specify array or record type");
7612 Check_First_Subtype (Arg1);
7614 if Has_Pragma_Pack (Typ) then
7615 Error_Pragma ("duplicate pragma%, only one allowed");
7617 -- Array type. We set the Has_Pragma_Pack flag, and Is_Packed,
7618 -- but not Has_Non_Standard_Rep, because we don't actually know
7619 -- till freeze time if the array can have packed representation.
7620 -- That's because in the general case we do not know enough about
7621 -- the component type until it in turn is frozen, which certainly
7622 -- happens before the array type is frozen, but not necessarily
7623 -- till that point (i.e. right now it may be unfrozen).
7625 elsif Is_Array_Type (Typ) then
7626 if Has_Aliased_Components (Base_Type (Typ)) then
7628 ("pragma% ignored, cannot pack aliased components?");
7630 elsif Has_Atomic_Components (Typ)
7631 or else Is_Atomic (Component_Type (Typ))
7634 ("?pragma% ignored, cannot pack atomic components");
7636 elsif not Rep_Item_Too_Late (Typ, N) then
7637 Set_Is_Packed (Base_Type (Typ));
7638 Set_Has_Pragma_Pack (Base_Type (Typ));
7639 Set_Has_Non_Standard_Rep (Base_Type (Typ));
7642 -- Record type. For record types, the pack is always effective
7644 else pragma Assert (Is_Record_Type (Typ));
7645 if not Rep_Item_Too_Late (Typ, N) then
7646 Set_Has_Pragma_Pack (Base_Type (Typ));
7647 Set_Is_Packed (Base_Type (Typ));
7648 Set_Has_Non_Standard_Rep (Base_Type (Typ));
7659 -- There is nothing to do here, since we did all the processing
7660 -- for this pragma in Par.Prag (so that it works properly even in
7661 -- syntax only mode)
7670 -- pragma Passive [(PASSIVE_FORM)];
7672 -- PASSIVE_FORM ::= Semaphore | No
7674 when Pragma_Passive =>
7677 if Nkind (Parent (N)) /= N_Task_Definition then
7678 Error_Pragma ("pragma% must be within task definition");
7681 if Arg_Count /= 0 then
7682 Check_Arg_Count (1);
7683 Check_Arg_Is_One_Of (Arg1, Name_Semaphore, Name_No);
7690 -- pragma Polling (ON | OFF);
7692 when Pragma_Polling =>
7694 Check_Arg_Count (1);
7695 Check_No_Identifiers;
7696 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
7697 Polling_Required := (Chars (Expression (Arg1)) = Name_On);
7699 ---------------------
7700 -- Persistent_Data --
7701 ---------------------
7703 when Pragma_Persistent_Data => declare
7707 -- Register the pragma as applying to the compilation unit.
7708 -- Individual Persistent_Object pragmas for relevant objects
7709 -- are generated the end of the compilation.
7712 Check_Valid_Configuration_Pragma;
7713 Check_Arg_Count (0);
7714 Ent := Find_Lib_Unit_Name;
7715 Set_Is_Preelaborated (Ent);
7718 ------------------------
7719 -- Persistent_Object --
7720 ------------------------
7722 when Pragma_Persistent_Object => declare
7730 Check_Arg_Count (1);
7731 Check_Arg_Is_Library_Level_Local_Name (Arg1);
7732 if not Is_Entity_Name (Expression (Arg1))
7734 (Ekind (Entity (Expression (Arg1))) /= E_Variable
7735 and then Ekind (Entity (Expression (Arg1))) /= E_Constant)
7737 Error_Pragma_Arg ("pragma only applies to objects", Arg1);
7740 Ent := Entity (Expression (Arg1));
7741 Decl := Parent (Ent);
7743 if Nkind (Decl) /= N_Object_Declaration then
7747 -- Placement of the object depends on whether there is
7748 -- an initial value or none. If the No_Initialization flag
7749 -- is set, the initialization has been transformed into
7750 -- assignments, which is disallowed elaboration code.
7752 if No_Initialization (Decl) then
7754 ("initialization for persistent object"
7755 & "must be static expression", Decl);
7759 if No (Expression (Decl)) then
7761 Store_String_Chars ("section ("".persistent.bss"")");
7765 if not Is_OK_Static_Expression (Expression (Decl)) then
7766 Flag_Non_Static_Expr
7767 ("initialization for persistent object"
7768 & "must be static expression!", Expression (Decl));
7773 Store_String_Chars ("section ("".persistent.data"")");
7780 Name_Machine_Attribute,
7782 (Make_Pragma_Argument_Association
7783 (Sloc => Sloc (Arg1),
7784 Expression => New_Occurrence_Of (Ent, Sloc (Ent))),
7785 Make_Pragma_Argument_Association
7786 (Sloc => Sloc (Arg1),
7789 (Sloc => Sloc (Arg1),
7792 Insert_After (N, MA);
7794 Set_Has_Gigi_Rep_Item (Ent);
7801 -- pragma Preelaborate [(library_unit_NAME)];
7803 -- Set the flag Is_Preelaborated of program unit name entity
7805 when Pragma_Preelaborate => Preelaborate : declare
7806 Pa : constant Node_Id := Parent (N);
7807 Pk : constant Node_Kind := Nkind (Pa);
7811 Check_Ada_83_Warning;
7812 Check_Valid_Library_Unit_Pragma;
7814 if Nkind (N) = N_Null_Statement then
7818 Ent := Find_Lib_Unit_Name;
7820 -- This filters out pragmas inside generic parent then
7821 -- show up inside instantiation
7824 and then not (Pk = N_Package_Specification
7825 and then Present (Generic_Parent (Pa)))
7827 if not Debug_Flag_U then
7828 Set_Is_Preelaborated (Ent);
7829 Set_Suppress_Elaboration_Warnings (Ent);
7838 -- pragma Priority (EXPRESSION);
7840 when Pragma_Priority => Priority : declare
7841 P : constant Node_Id := Parent (N);
7845 Check_No_Identifiers;
7846 Check_Arg_Count (1);
7850 if Nkind (P) = N_Subprogram_Body then
7851 Check_In_Main_Program;
7853 Arg := Expression (Arg1);
7854 Analyze_And_Resolve (Arg, Standard_Integer);
7858 if not Is_Static_Expression (Arg) then
7859 Flag_Non_Static_Expr
7860 ("main subprogram priority is not static!", Arg);
7863 -- If constraint error, then we already signalled an error
7865 elsif Raises_Constraint_Error (Arg) then
7868 -- Otherwise check in range
7872 Val : constant Uint := Expr_Value (Arg);
7876 or else Val > Expr_Value (Expression
7877 (Parent (RTE (RE_Max_Priority))))
7880 ("main subprogram priority is out of range", Arg1);
7886 (Current_Sem_Unit, UI_To_Int (Expr_Value (Arg)));
7888 -- Task or Protected, must be of type Integer
7890 elsif Nkind (P) = N_Protected_Definition
7892 Nkind (P) = N_Task_Definition
7894 Arg := Expression (Arg1);
7896 -- The expression must be analyzed in the special manner
7897 -- described in "Handling of Default and Per-Object
7898 -- Expressions" in sem.ads.
7900 Analyze_Per_Use_Expression (Arg, Standard_Integer);
7902 if not Is_Static_Expression (Arg) then
7903 Check_Restriction (Static_Priorities, Arg);
7906 -- Anything else is incorrect
7912 if Has_Priority_Pragma (P) then
7913 Error_Pragma ("duplicate pragma% not allowed");
7915 Set_Has_Priority_Pragma (P, True);
7917 if Nkind (P) = N_Protected_Definition
7919 Nkind (P) = N_Task_Definition
7921 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
7922 -- exp_ch9 should use this ???
7927 --------------------------
7928 -- Propagate_Exceptions --
7929 --------------------------
7931 -- pragma Propagate_Exceptions;
7933 when Pragma_Propagate_Exceptions =>
7935 Check_Arg_Count (0);
7937 if In_Extended_Main_Source_Unit (N) then
7938 Propagate_Exceptions := True;
7945 -- pragma Psect_Object (
7946 -- [Internal =>] LOCAL_NAME,
7947 -- [, [External =>] EXTERNAL_SYMBOL]
7948 -- [, [Size =>] EXTERNAL_SYMBOL]);
7950 when Pragma_Psect_Object | Pragma_Common_Object =>
7951 Psect_Object : declare
7952 Args : Args_List (1 .. 3);
7953 Names : constant Name_List (1 .. 3) := (
7958 Internal : Node_Id renames Args (1);
7959 External : Node_Id renames Args (2);
7960 Size : Node_Id renames Args (3);
7962 R_Internal : Node_Id;
7963 R_External : Node_Id;
7970 procedure Check_Too_Long (Arg : Node_Id);
7971 -- Posts message if the argument is an identifier with more
7972 -- than 31 characters, or a string literal with more than
7973 -- 31 characters, and we are operating under VMS
7975 --------------------
7976 -- Check_Too_Long --
7977 --------------------
7979 procedure Check_Too_Long (Arg : Node_Id) is
7980 X : constant Node_Id := Original_Node (Arg);
7983 if Nkind (X) /= N_String_Literal
7985 Nkind (X) /= N_Identifier
7988 ("inappropriate argument for pragma %", Arg);
7991 if OpenVMS_On_Target then
7992 if (Nkind (X) = N_String_Literal
7993 and then String_Length (Strval (X)) > 31)
7995 (Nkind (X) = N_Identifier
7996 and then Length_Of_Name (Chars (X)) > 31)
7999 ("argument for pragma % is longer than 31 characters",
8005 -- Start of processing for Common_Object/Psect_Object
8009 Gather_Associations (Names, Args);
8010 Process_Extended_Import_Export_Internal_Arg (Internal);
8012 R_Internal := Relocate_Node (Internal);
8014 Def_Id := Entity (R_Internal);
8016 if Ekind (Def_Id) /= E_Constant
8017 and then Ekind (Def_Id) /= E_Variable
8020 ("pragma% must designate an object", Internal);
8023 Check_Too_Long (R_Internal);
8025 if Is_Imported (Def_Id) or else Is_Exported (Def_Id) then
8027 ("cannot use pragma% for imported/exported object",
8031 if Is_Concurrent_Type (Etype (R_Internal)) then
8033 ("cannot specify pragma % for task/protected object",
8037 if Is_Psected (Def_Id) then
8038 Error_Msg_N ("?duplicate Psect_Object pragma", N);
8040 Set_Is_Psected (Def_Id);
8043 if Ekind (Def_Id) = E_Constant then
8045 ("cannot specify pragma % for a constant", R_Internal);
8048 if Is_Record_Type (Etype (R_Internal)) then
8054 Ent := First_Entity (Etype (R_Internal));
8055 while Present (Ent) loop
8056 Decl := Declaration_Node (Ent);
8058 if Ekind (Ent) = E_Component
8059 and then Nkind (Decl) = N_Component_Declaration
8060 and then Present (Expression (Decl))
8061 and then Warn_On_Export_Import
8064 ("?object for pragma % has defaults", R_Internal);
8074 if Present (Size) then
8075 Check_Too_Long (Size);
8078 -- Make Psect case-insensitive.
8080 if Present (External) then
8081 Check_Too_Long (External);
8083 if Nkind (External) = N_String_Literal then
8084 String_To_Name_Buffer (Strval (External));
8086 Get_Name_String (Chars (External));
8091 Store_String_Chars (Name_Buffer (1 .. Name_Len));
8093 R_External := Make_String_Literal
8094 (Sloc => Sloc (External), Strval => Str);
8096 Get_Name_String (Chars (Internal));
8099 Store_String_Chars (Name_Buffer (1 .. Name_Len));
8101 R_External := Make_String_Literal
8102 (Sloc => Sloc (Internal), Strval => Str);
8105 -- Transform into pragma Linker_Section, add attributes to
8106 -- match what DEC Ada does. Ignore size for now?
8111 Name_Linker_Section,
8113 (Make_Pragma_Argument_Association
8114 (Sloc => Sloc (R_Internal),
8115 Expression => R_Internal),
8116 Make_Pragma_Argument_Association
8117 (Sloc => Sloc (R_External),
8118 Expression => R_External))));
8122 -- Add Machine_Attribute of "overlaid", so the section overlays
8123 -- other sections of the same name.
8126 Store_String_Chars ("overlaid");
8132 Name_Machine_Attribute,
8134 (Make_Pragma_Argument_Association
8135 (Sloc => Sloc (R_Internal),
8136 Expression => R_Internal),
8137 Make_Pragma_Argument_Association
8138 (Sloc => Sloc (R_External),
8141 (Sloc => Sloc (R_External),
8145 -- Add Machine_Attribute of "global", so the section is visible
8149 Store_String_Chars ("global");
8155 Name_Machine_Attribute,
8157 (Make_Pragma_Argument_Association
8158 (Sloc => Sloc (R_Internal),
8159 Expression => R_Internal),
8161 Make_Pragma_Argument_Association
8162 (Sloc => Sloc (R_External),
8165 (Sloc => Sloc (R_External),
8169 -- Add Machine_Attribute of "initialize", so the section is
8173 Store_String_Chars ("initialize");
8179 Name_Machine_Attribute,
8181 (Make_Pragma_Argument_Association
8182 (Sloc => Sloc (R_Internal),
8183 Expression => R_Internal),
8185 Make_Pragma_Argument_Association
8186 (Sloc => Sloc (R_External),
8189 (Sloc => Sloc (R_External),
8198 -- pragma Pure [(library_unit_NAME)];
8200 when Pragma_Pure => Pure : declare
8203 Check_Ada_83_Warning;
8204 Check_Valid_Library_Unit_Pragma;
8206 if Nkind (N) = N_Null_Statement then
8210 Ent := Find_Lib_Unit_Name;
8212 Set_Suppress_Elaboration_Warnings (Ent);
8219 -- pragma Pure_Function ([Entity =>] function_LOCAL_NAME);
8221 when Pragma_Pure_Function => Pure_Function : declare
8225 Effective : Boolean := False;
8229 Check_Arg_Count (1);
8230 Check_Optional_Identifier (Arg1, Name_Entity);
8231 Check_Arg_Is_Local_Name (Arg1);
8232 E_Id := Expression (Arg1);
8234 if Error_Posted (E_Id) then
8238 -- Loop through homonyms (overloadings) of referenced entity
8244 Def_Id := Get_Base_Subprogram (E);
8246 if Ekind (Def_Id) /= E_Function
8247 and then Ekind (Def_Id) /= E_Generic_Function
8248 and then Ekind (Def_Id) /= E_Operator
8251 ("pragma% requires a function name", Arg1);
8254 Set_Is_Pure (Def_Id);
8256 if not Has_Pragma_Pure_Function (Def_Id) then
8257 Set_Has_Pragma_Pure_Function (Def_Id);
8262 exit when No (E) or else Scope (E) /= Current_Scope;
8266 and then Warn_On_Redundant_Constructs
8268 Error_Msg_NE ("pragma Pure_Function on& is redundant?",
8274 --------------------
8275 -- Queuing_Policy --
8276 --------------------
8278 -- pragma Queuing_Policy (policy_IDENTIFIER);
8280 when Pragma_Queuing_Policy => declare
8284 Check_Ada_83_Warning;
8285 Check_Arg_Count (1);
8286 Check_No_Identifiers;
8287 Check_Arg_Is_Queuing_Policy (Arg1);
8288 Check_Valid_Configuration_Pragma;
8289 Get_Name_String (Chars (Expression (Arg1)));
8290 QP := Fold_Upper (Name_Buffer (1));
8292 if Queuing_Policy /= ' '
8293 and then Queuing_Policy /= QP
8295 Error_Msg_Sloc := Queuing_Policy_Sloc;
8296 Error_Pragma ("queuing policy incompatible with policy#");
8298 -- Set new policy, but always preserve System_Location since
8299 -- we like the error message with the run time name.
8302 Queuing_Policy := QP;
8304 if Queuing_Policy_Sloc /= System_Location then
8305 Queuing_Policy_Sloc := Loc;
8310 ---------------------------
8311 -- Remote_Call_Interface --
8312 ---------------------------
8314 -- pragma Remote_Call_Interface [(library_unit_NAME)];
8316 when Pragma_Remote_Call_Interface => Remote_Call_Interface : declare
8317 Cunit_Node : Node_Id;
8318 Cunit_Ent : Entity_Id;
8322 Check_Ada_83_Warning;
8323 Check_Valid_Library_Unit_Pragma;
8325 if Nkind (N) = N_Null_Statement then
8329 Cunit_Node := Cunit (Current_Sem_Unit);
8330 K := Nkind (Unit (Cunit_Node));
8331 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
8333 if K = N_Package_Declaration
8334 or else K = N_Generic_Package_Declaration
8335 or else K = N_Subprogram_Declaration
8336 or else K = N_Generic_Subprogram_Declaration
8337 or else (K = N_Subprogram_Body
8338 and then Acts_As_Spec (Unit (Cunit_Node)))
8343 "pragma% must apply to package or subprogram declaration");
8346 Set_Is_Remote_Call_Interface (Cunit_Ent);
8347 end Remote_Call_Interface;
8353 -- pragma Remote_Types [(library_unit_NAME)];
8355 when Pragma_Remote_Types => Remote_Types : declare
8356 Cunit_Node : Node_Id;
8357 Cunit_Ent : Entity_Id;
8360 Check_Ada_83_Warning;
8361 Check_Valid_Library_Unit_Pragma;
8363 if Nkind (N) = N_Null_Statement then
8367 Cunit_Node := Cunit (Current_Sem_Unit);
8368 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
8370 if Nkind (Unit (Cunit_Node)) /= N_Package_Declaration
8372 Nkind (Unit (Cunit_Node)) /= N_Generic_Package_Declaration
8375 "pragma% can only apply to a package declaration");
8378 Set_Is_Remote_Types (Cunit_Ent);
8385 -- pragma Ravenscar;
8387 when Pragma_Ravenscar =>
8389 Check_Arg_Count (0);
8390 Check_Valid_Configuration_Pragma;
8393 -------------------------
8394 -- Restricted_Run_Time --
8395 -------------------------
8397 -- pragma Restricted_Run_Time;
8399 when Pragma_Restricted_Run_Time =>
8401 Check_Arg_Count (0);
8402 Check_Valid_Configuration_Pragma;
8403 Set_Restricted_Profile (N);
8409 -- pragma Restrictions (RESTRICTION {, RESTRICTION});
8412 -- restriction_IDENTIFIER
8413 -- | restriction_parameter_IDENTIFIER => EXPRESSION
8415 when Pragma_Restrictions =>
8416 Process_Restrictions_Or_Restriction_Warnings;
8418 --------------------------
8419 -- Restriction_Warnings --
8420 --------------------------
8422 -- pragma Restriction_Warnings (RESTRICTION {, RESTRICTION});
8425 -- restriction_IDENTIFIER
8426 -- | restriction_parameter_IDENTIFIER => EXPRESSION
8428 when Pragma_Restriction_Warnings =>
8429 Process_Restrictions_Or_Restriction_Warnings;
8435 -- pragma Reviewable;
8437 when Pragma_Reviewable =>
8438 Check_Ada_83_Warning;
8439 Check_Arg_Count (0);
8445 -- pragma Share_Generic (NAME {, NAME});
8447 when Pragma_Share_Generic =>
8449 Process_Generic_List;
8455 -- pragma Shared (LOCAL_NAME);
8457 when Pragma_Shared =>
8459 Process_Atomic_Shared_Volatile;
8461 --------------------
8462 -- Shared_Passive --
8463 --------------------
8465 -- pragma Shared_Passive [(library_unit_NAME)];
8467 -- Set the flag Is_Shared_Passive of program unit name entity
8469 when Pragma_Shared_Passive => Shared_Passive : declare
8470 Cunit_Node : Node_Id;
8471 Cunit_Ent : Entity_Id;
8474 Check_Ada_83_Warning;
8475 Check_Valid_Library_Unit_Pragma;
8477 if Nkind (N) = N_Null_Statement then
8481 Cunit_Node := Cunit (Current_Sem_Unit);
8482 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
8484 if Nkind (Unit (Cunit_Node)) /= N_Package_Declaration
8486 Nkind (Unit (Cunit_Node)) /= N_Generic_Package_Declaration
8489 "pragma% can only apply to a package declaration");
8492 Set_Is_Shared_Passive (Cunit_Ent);
8495 ----------------------
8496 -- Source_File_Name --
8497 ----------------------
8499 -- pragma Source_File_Name (
8500 -- [UNIT_NAME =>] unit_NAME,
8501 -- [BODY_FILE_NAME | SPEC_FILE_NAME] => STRING_LITERAL);
8503 -- No processing here. Processing was completed during parsing,
8504 -- since we need to have file names set as early as possible.
8505 -- Units are loaded well before semantic processing starts.
8507 -- The only processing we defer to this point is the check
8508 -- for correct placement.
8510 when Pragma_Source_File_Name =>
8512 Check_Valid_Configuration_Pragma;
8514 ------------------------------
8515 -- Source_File_Name_Project --
8516 ------------------------------
8518 -- pragma Source_File_Name_Project (
8519 -- [UNIT_NAME =>] unit_NAME,
8520 -- [BODY_FILE_NAME | SPEC_FILE_NAME] => STRING_LITERAL);
8522 -- No processing here. Processing was completed during parsing,
8523 -- since we need to have file names set as early as possible.
8524 -- Units are loaded well before semantic processing starts.
8526 -- The only processing we defer to this point is the check
8527 -- for correct placement.
8529 when Pragma_Source_File_Name_Project =>
8531 Check_Valid_Configuration_Pragma;
8533 -- Check that a pragma Source_File_Name_Project is used only
8534 -- in a configuration pragmas file.
8535 -- Pragmas Source_File_Name_Project should only be generated
8536 -- by the Project Manager in configuration pragmas files.
8538 -- This is really an ugly test. It seems to depend on some
8539 -- accidental and undocumented property. At the very least
8540 -- it needs to be documented, but it would be better to have
8541 -- a clean way of testing if we are in a configuration file???
8543 if Present (Parent (N)) then
8545 ("pragma% can only appear in a configuration pragmas file");
8548 ----------------------
8549 -- Source_Reference --
8550 ----------------------
8552 -- pragma Source_Reference (INTEGER_LITERAL [, STRING_LITERAL]);
8554 -- Nothing to do, all processing completed in Par.Prag, since we
8555 -- need the information for possible parser messages that are output
8557 when Pragma_Source_Reference =>
8564 -- pragma Storage_Size (EXPRESSION);
8566 when Pragma_Storage_Size => Storage_Size : declare
8567 P : constant Node_Id := Parent (N);
8571 Check_No_Identifiers;
8572 Check_Arg_Count (1);
8574 -- The expression must be analyzed in the special manner
8575 -- described in "Handling of Default Expressions" in sem.ads.
8577 -- Set In_Default_Expression for per-object case ???
8579 Arg := Expression (Arg1);
8580 Analyze_Per_Use_Expression (Arg, Any_Integer);
8582 if not Is_Static_Expression (Arg) then
8583 Check_Restriction (Static_Storage_Size, Arg);
8586 if Nkind (P) /= N_Task_Definition then
8591 if Has_Storage_Size_Pragma (P) then
8592 Error_Pragma ("duplicate pragma% not allowed");
8594 Set_Has_Storage_Size_Pragma (P, True);
8597 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
8598 -- ??? exp_ch9 should use this!
8606 -- pragma Storage_Unit (NUMERIC_LITERAL);
8608 -- Only permitted argument is System'Storage_Unit value
8610 when Pragma_Storage_Unit =>
8611 Check_No_Identifiers;
8612 Check_Arg_Count (1);
8613 Check_Arg_Is_Integer_Literal (Arg1);
8615 if Intval (Expression (Arg1)) /=
8616 UI_From_Int (Ttypes.System_Storage_Unit)
8618 Error_Msg_Uint_1 := UI_From_Int (Ttypes.System_Storage_Unit);
8620 ("the only allowed argument for pragma% is ^", Arg1);
8623 --------------------
8624 -- Stream_Convert --
8625 --------------------
8627 -- pragma Stream_Convert (
8628 -- [Entity =>] type_LOCAL_NAME,
8629 -- [Read =>] function_NAME,
8630 -- [Write =>] function NAME);
8632 when Pragma_Stream_Convert => Stream_Convert : declare
8634 procedure Check_OK_Stream_Convert_Function (Arg : Node_Id);
8635 -- Check that the given argument is the name of a local
8636 -- function of one argument that is not overloaded earlier
8637 -- in the current local scope. A check is also made that the
8638 -- argument is a function with one parameter.
8640 --------------------------------------
8641 -- Check_OK_Stream_Convert_Function --
8642 --------------------------------------
8644 procedure Check_OK_Stream_Convert_Function (Arg : Node_Id) is
8648 Check_Arg_Is_Local_Name (Arg);
8649 Ent := Entity (Expression (Arg));
8651 if Has_Homonym (Ent) then
8653 ("argument for pragma% may not be overloaded", Arg);
8656 if Ekind (Ent) /= E_Function
8657 or else No (First_Formal (Ent))
8658 or else Present (Next_Formal (First_Formal (Ent)))
8661 ("argument for pragma% must be" &
8662 " function of one argument", Arg);
8664 end Check_OK_Stream_Convert_Function;
8666 -- Start of procecessing for Stream_Convert
8670 Check_Arg_Count (3);
8671 Check_Optional_Identifier (Arg1, Name_Entity);
8672 Check_Optional_Identifier (Arg2, Name_Read);
8673 Check_Optional_Identifier (Arg3, Name_Write);
8674 Check_Arg_Is_Local_Name (Arg1);
8675 Check_OK_Stream_Convert_Function (Arg2);
8676 Check_OK_Stream_Convert_Function (Arg3);
8679 Typ : constant Entity_Id :=
8680 Underlying_Type (Entity (Expression (Arg1)));
8681 Read : constant Entity_Id := Entity (Expression (Arg2));
8682 Write : constant Entity_Id := Entity (Expression (Arg3));
8685 if Etype (Typ) = Any_Type
8687 Etype (Read) = Any_Type
8689 Etype (Write) = Any_Type
8694 Check_First_Subtype (Arg1);
8696 if Rep_Item_Too_Early (Typ, N)
8698 Rep_Item_Too_Late (Typ, N)
8703 if Underlying_Type (Etype (Read)) /= Typ then
8705 ("incorrect return type for function&", Arg2);
8708 if Underlying_Type (Etype (First_Formal (Write))) /= Typ then
8710 ("incorrect parameter type for function&", Arg3);
8713 if Underlying_Type (Etype (First_Formal (Read))) /=
8714 Underlying_Type (Etype (Write))
8717 ("result type of & does not match Read parameter type",
8723 -------------------------
8724 -- Style_Checks (GNAT) --
8725 -------------------------
8727 -- pragma Style_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
8729 -- This is processed by the parser since some of the style
8730 -- checks take place during source scanning and parsing. This
8731 -- means that we don't need to issue error messages here.
8733 when Pragma_Style_Checks => Style_Checks : declare
8734 A : constant Node_Id := Expression (Arg1);
8740 Check_No_Identifiers;
8742 -- Two argument form
8744 if Arg_Count = 2 then
8745 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
8752 E_Id := Expression (Arg2);
8755 if not Is_Entity_Name (E_Id) then
8757 ("second argument of pragma% must be entity name",
8767 Set_Suppress_Style_Checks (E,
8768 (Chars (Expression (Arg1)) = Name_Off));
8769 exit when No (Homonym (E));
8775 -- One argument form
8778 Check_Arg_Count (1);
8780 if Nkind (A) = N_String_Literal then
8784 Slen : constant Natural := Natural (String_Length (S));
8785 Options : String (1 .. Slen);
8791 C := Get_String_Char (S, Int (J));
8792 exit when not In_Character_Range (C);
8793 Options (J) := Get_Character (C);
8796 Set_Style_Check_Options (Options);
8804 elsif Nkind (A) = N_Identifier then
8806 if Chars (A) = Name_All_Checks then
8807 Set_Default_Style_Check_Options;
8809 elsif Chars (A) = Name_On then
8810 Style_Check := True;
8812 elsif Chars (A) = Name_Off then
8813 Style_Check := False;
8824 -- pragma Subtitle ([Subtitle =>] STRING_LITERAL);
8826 when Pragma_Subtitle =>
8828 Check_Arg_Count (1);
8829 Check_Optional_Identifier (Arg1, Name_Subtitle);
8830 Check_Arg_Is_String_Literal (Arg1);
8836 -- pragma Suppress (IDENTIFIER [, [On =>] NAME]);
8838 when Pragma_Suppress =>
8839 Process_Suppress_Unsuppress (True);
8845 -- pragma Suppress_All;
8847 -- The only check made here is that the pragma appears in the
8848 -- proper place, i.e. following a compilation unit. If indeed
8849 -- it appears in this context, then the parser has already
8850 -- inserted an equivalent pragma Suppress (All_Checks) to get
8851 -- the required effect.
8853 when Pragma_Suppress_All =>
8855 Check_Arg_Count (0);
8857 if Nkind (Parent (N)) /= N_Compilation_Unit_Aux
8858 or else not Is_List_Member (N)
8859 or else List_Containing (N) /= Pragmas_After (Parent (N))
8862 ("misplaced pragma%, must follow compilation unit");
8865 -------------------------
8866 -- Suppress_Debug_Info --
8867 -------------------------
8869 -- pragma Suppress_Debug_Info ([Entity =>] LOCAL_NAME);
8871 when Pragma_Suppress_Debug_Info =>
8873 Check_Arg_Count (1);
8874 Check_Arg_Is_Local_Name (Arg1);
8875 Check_Optional_Identifier (Arg1, Name_Entity);
8876 Set_Debug_Info_Off (Entity (Get_Pragma_Arg (Arg1)));
8878 ----------------------------------
8879 -- Suppress_Exception_Locations --
8880 ----------------------------------
8882 -- pragma Suppress_Exception_Locations;
8884 when Pragma_Suppress_Exception_Locations =>
8886 Check_Arg_Count (0);
8887 Check_Valid_Configuration_Pragma;
8888 Exception_Locations_Suppressed := True;
8890 -----------------------------
8891 -- Suppress_Initialization --
8892 -----------------------------
8894 -- pragma Suppress_Initialization ([Entity =>] type_Name);
8896 when Pragma_Suppress_Initialization => Suppress_Init : declare
8902 Check_Arg_Count (1);
8903 Check_Optional_Identifier (Arg1, Name_Entity);
8904 Check_Arg_Is_Local_Name (Arg1);
8906 E_Id := Expression (Arg1);
8908 if Etype (E_Id) = Any_Type then
8915 if Is_Incomplete_Or_Private_Type (E) then
8916 if No (Full_View (Base_Type (E))) then
8918 ("argument of pragma% cannot be an incomplete type",
8921 Set_Suppress_Init_Proc (Full_View (Base_Type (E)));
8924 Set_Suppress_Init_Proc (Base_Type (E));
8929 ("pragma% requires argument that is a type name", Arg1);
8937 -- pragma System_Name (DIRECT_NAME);
8939 -- Syntax check: one argument, which must be the identifier GNAT
8940 -- or the identifier GCC, no other identifiers are acceptable.
8942 when Pragma_System_Name =>
8943 Check_No_Identifiers;
8944 Check_Arg_Count (1);
8945 Check_Arg_Is_One_Of (Arg1, Name_Gcc, Name_Gnat);
8947 -----------------------------
8948 -- Task_Dispatching_Policy --
8949 -----------------------------
8951 -- pragma Task_Dispatching_Policy (policy_IDENTIFIER);
8953 when Pragma_Task_Dispatching_Policy => declare
8957 Check_Ada_83_Warning;
8958 Check_Arg_Count (1);
8959 Check_No_Identifiers;
8960 Check_Arg_Is_Task_Dispatching_Policy (Arg1);
8961 Check_Valid_Configuration_Pragma;
8962 Get_Name_String (Chars (Expression (Arg1)));
8963 DP := Fold_Upper (Name_Buffer (1));
8965 if Task_Dispatching_Policy /= ' '
8966 and then Task_Dispatching_Policy /= DP
8968 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
8970 ("task dispatching policy incompatible with policy#");
8972 -- Set new policy, but always preserve System_Location since
8973 -- we like the error message with the run time name.
8976 Task_Dispatching_Policy := DP;
8978 if Task_Dispatching_Policy_Sloc /= System_Location then
8979 Task_Dispatching_Policy_Sloc := Loc;
8988 -- pragma Task_Info (EXPRESSION);
8990 when Pragma_Task_Info => Task_Info : declare
8991 P : constant Node_Id := Parent (N);
8996 if Nkind (P) /= N_Task_Definition then
8997 Error_Pragma ("pragma% must appear in task definition");
9000 Check_No_Identifiers;
9001 Check_Arg_Count (1);
9003 Analyze_And_Resolve (Expression (Arg1), RTE (RE_Task_Info_Type));
9005 if Etype (Expression (Arg1)) = Any_Type then
9009 if Has_Task_Info_Pragma (P) then
9010 Error_Pragma ("duplicate pragma% not allowed");
9012 Set_Has_Task_Info_Pragma (P, True);
9020 -- pragma Task_Name (string_EXPRESSION);
9022 when Pragma_Task_Name => Task_Name : declare
9023 -- pragma Priority (EXPRESSION);
9025 P : constant Node_Id := Parent (N);
9029 Check_No_Identifiers;
9030 Check_Arg_Count (1);
9032 Arg := Expression (Arg1);
9033 Analyze_And_Resolve (Arg, Standard_String);
9035 if Nkind (P) /= N_Task_Definition then
9039 if Has_Task_Name_Pragma (P) then
9040 Error_Pragma ("duplicate pragma% not allowed");
9042 Set_Has_Task_Name_Pragma (P, True);
9043 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
9051 -- pragma Task_Storage (
9052 -- [Task_Type =>] LOCAL_NAME,
9053 -- [Top_Guard =>] static_integer_EXPRESSION);
9055 when Pragma_Task_Storage => Task_Storage : declare
9056 Args : Args_List (1 .. 2);
9057 Names : constant Name_List (1 .. 2) := (
9061 Task_Type : Node_Id renames Args (1);
9062 Top_Guard : Node_Id renames Args (2);
9068 Gather_Associations (Names, Args);
9070 if No (Task_Type) then
9072 ("missing task_type argument for pragma%");
9075 Check_Arg_Is_Local_Name (Task_Type);
9077 Ent := Entity (Task_Type);
9079 if not Is_Task_Type (Ent) then
9081 ("argument for pragma% must be task type", Task_Type);
9084 if No (Top_Guard) then
9086 ("pragma% takes two arguments", Task_Type);
9088 Check_Arg_Is_Static_Expression (Top_Guard, Any_Integer);
9091 Check_First_Subtype (Task_Type);
9093 if Rep_Item_Too_Late (Ent, N) then
9102 -- pragma Thread_Body
9103 -- ( [Entity =>] LOCAL_NAME
9104 -- [,[Secondary_Stack_Size =>] static_integer_EXPRESSION]);
9106 when Pragma_Thread_Body => Thread_Body : declare
9113 Check_At_Least_N_Arguments (1);
9114 Check_At_Most_N_Arguments (2);
9115 Check_Optional_Identifier (Arg1, Name_Entity);
9116 Check_Arg_Is_Local_Name (Arg1);
9118 Id := Expression (Arg1);
9120 if not Is_Entity_Name (Id)
9121 or else not Is_Subprogram (Entity (Id))
9123 Error_Pragma_Arg ("subprogram name required", Arg1);
9128 -- Go to renamed subprogram if present, since Thread_Body applies
9129 -- to the actual renamed entity, not to the renaming entity.
9131 if Present (Alias (E))
9132 and then Nkind (Parent (Declaration_Node (E))) =
9133 N_Subprogram_Renaming_Declaration
9138 -- Various error checks
9140 if Nkind (Parent (Declaration_Node (E))) = N_Subprogram_Body then
9142 ("pragma% requires separate spec and must come before body");
9144 elsif Rep_Item_Too_Early (E, N)
9146 Rep_Item_Too_Late (E, N)
9150 elsif Is_Thread_Body (E) then
9152 ("only one thread body pragma allowed", Arg1);
9154 elsif Present (Homonym (E))
9155 and then Scope (Homonym (E)) = Current_Scope
9158 ("thread body subprogram must not be overloaded", Arg1);
9161 Set_Is_Thread_Body (E);
9163 -- Deal with secondary stack argument
9165 if Arg_Count = 2 then
9166 Check_Optional_Identifier (Arg2, Name_Secondary_Stack_Size);
9167 SS := Expression (Arg2);
9168 Analyze_And_Resolve (SS, Any_Integer);
9176 -- pragma Time_Slice (static_duration_EXPRESSION);
9178 when Pragma_Time_Slice => Time_Slice : declare
9184 Check_Arg_Count (1);
9185 Check_No_Identifiers;
9186 Check_In_Main_Program;
9187 Check_Arg_Is_Static_Expression (Arg1, Standard_Duration);
9189 if not Error_Posted (Arg1) then
9191 while Present (Nod) loop
9192 if Nkind (Nod) = N_Pragma
9193 and then Chars (Nod) = Name_Time_Slice
9195 Error_Msg_Name_1 := Chars (N);
9196 Error_Msg_N ("duplicate pragma% not permitted", Nod);
9203 -- Process only if in main unit
9205 if Get_Source_Unit (Loc) = Main_Unit then
9206 Opt.Time_Slice_Set := True;
9207 Val := Expr_Value_R (Expression (Arg1));
9209 if Val <= Ureal_0 then
9210 Opt.Time_Slice_Value := 0;
9212 elsif Val > UR_From_Uint (UI_From_Int (1000)) then
9213 Opt.Time_Slice_Value := 1_000_000_000;
9216 Opt.Time_Slice_Value :=
9217 UI_To_Int (UR_To_Uint (Val * UI_From_Int (1_000_000)));
9226 -- pragma Title (TITLING_OPTION [, TITLING OPTION]);
9228 -- TITLING_OPTION ::=
9229 -- [Title =>] STRING_LITERAL
9230 -- | [Subtitle =>] STRING_LITERAL
9232 when Pragma_Title => Title : declare
9233 Args : Args_List (1 .. 2);
9234 Names : constant Name_List (1 .. 2) := (
9240 Gather_Associations (Names, Args);
9242 for J in 1 .. 2 loop
9243 if Present (Args (J)) then
9244 Check_Arg_Is_String_Literal (Args (J));
9249 ---------------------
9250 -- Unchecked_Union --
9251 ---------------------
9253 -- pragma Unchecked_Union (first_subtype_LOCAL_NAME)
9255 when Pragma_Unchecked_Union => Unchecked_Union : declare
9256 Assoc : constant Node_Id := Arg1;
9257 Type_Id : constant Node_Id := Expression (Assoc);
9268 Check_No_Identifiers;
9269 Check_Arg_Count (1);
9270 Check_Arg_Is_Local_Name (Arg1);
9272 Find_Type (Type_Id);
9273 Typ := Entity (Type_Id);
9276 or else Rep_Item_Too_Early (Typ, N)
9280 Typ := Underlying_Type (Typ);
9283 if Rep_Item_Too_Late (Typ, N) then
9287 Check_First_Subtype (Arg1);
9289 -- Note remaining cases are references to a type in the current
9290 -- declarative part. If we find an error, we post the error on
9291 -- the relevant type declaration at an appropriate point.
9293 if not Is_Record_Type (Typ) then
9294 Error_Msg_N ("Unchecked_Union must be record type", Typ);
9297 elsif Is_Tagged_Type (Typ) then
9298 Error_Msg_N ("Unchecked_Union must not be tagged", Typ);
9301 elsif Is_Limited_Type (Typ) then
9303 ("Unchecked_Union must not be limited record type", Typ);
9304 Explain_Limited_Type (Typ, Typ);
9308 if not Has_Discriminants (Typ) then
9310 ("Unchecked_Union must have one discriminant", Typ);
9314 Discr := First_Discriminant (Typ);
9316 if Present (Next_Discriminant (Discr)) then
9318 ("Unchecked_Union must have exactly one discriminant",
9319 Next_Discriminant (Discr));
9323 if No (Discriminant_Default_Value (Discr)) then
9325 ("Unchecked_Union discriminant must have default value",
9329 Tdef := Type_Definition (Declaration_Node (Typ));
9330 Clist := Component_List (Tdef);
9332 if No (Clist) or else No (Variant_Part (Clist)) then
9334 ("Unchecked_Union must have variant part",
9339 Vpart := Variant_Part (Clist);
9341 if Is_Non_Empty_List (Component_Items (Clist)) then
9343 ("components before variant not allowed " &
9344 "in Unchecked_Union",
9345 First (Component_Items (Clist)));
9348 Variant := First (Variants (Vpart));
9349 while Present (Variant) loop
9350 Clist := Component_List (Variant);
9352 if Present (Variant_Part (Clist)) then
9354 ("Unchecked_Union may not have nested variants",
9355 Variant_Part (Clist));
9358 if not Is_Non_Empty_List (Component_Items (Clist)) then
9360 ("Unchecked_Union may not have empty component list",
9365 Comp := First (Component_Items (Clist));
9367 if Nkind (Comp) = N_Component_Declaration then
9369 if Present (Expression (Comp)) then
9371 ("default initialization not allowed " &
9372 "in Unchecked_Union",
9377 Sindic : constant Node_Id :=
9378 Subtype_Indication (Component_Definition (Comp));
9381 if Nkind (Sindic) = N_Subtype_Indication then
9382 Check_Static_Constraint (Constraint (Sindic));
9387 if Present (Next (Comp)) then
9389 ("Unchecked_Union variant can have only one component",
9397 Set_Is_Unchecked_Union (Typ, True);
9398 Set_Convention (Typ, Convention_C);
9400 Set_Has_Unchecked_Union (Base_Type (Typ), True);
9401 Set_Is_Unchecked_Union (Base_Type (Typ), True);
9402 end Unchecked_Union;
9404 ------------------------
9405 -- Unimplemented_Unit --
9406 ------------------------
9408 -- pragma Unimplemented_Unit;
9410 -- Note: this only gives an error if we are generating code,
9411 -- or if we are in a generic library unit (where the pragma
9412 -- appears in the body, not in the spec).
9414 when Pragma_Unimplemented_Unit => Unimplemented_Unit : declare
9415 Cunitent : constant Entity_Id :=
9416 Cunit_Entity (Get_Source_Unit (Loc));
9417 Ent_Kind : constant Entity_Kind :=
9422 Check_Arg_Count (0);
9424 if Operating_Mode = Generate_Code
9425 or else Ent_Kind = E_Generic_Function
9426 or else Ent_Kind = E_Generic_Procedure
9427 or else Ent_Kind = E_Generic_Package
9429 Get_Name_String (Chars (Cunitent));
9430 Set_Casing (Mixed_Case);
9431 Write_Str (Name_Buffer (1 .. Name_Len));
9432 Write_Str (" is not implemented");
9434 raise Unrecoverable_Error;
9436 end Unimplemented_Unit;
9438 --------------------
9439 -- Universal_Data --
9440 --------------------
9442 -- pragma Universal_Data [(library_unit_NAME)];
9444 when Pragma_Universal_Data =>
9447 -- If this is a configuration pragma, then set the universal
9448 -- addressing option, otherwise confirm that the pragma
9449 -- satisfies the requirements of library unit pragma placement
9450 -- and leave it to the GNAAMP back end to detect the pragma
9451 -- (avoids transitive setting of the option due to withed units).
9453 if Is_Configuration_Pragma then
9454 Universal_Addressing_On_AAMP := True;
9456 Check_Valid_Library_Unit_Pragma;
9459 if not AAMP_On_Target then
9460 Error_Pragma ("?pragma% ignored (applies only to AAMP)");
9467 -- pragma Unreferenced (local_Name {, local_Name});
9469 when Pragma_Unreferenced => Unreferenced : declare
9472 Arg_Ent : Entity_Id;
9476 Check_At_Least_N_Arguments (1);
9480 while Present (Arg_Node) loop
9481 Check_No_Identifier (Arg_Node);
9483 -- Note that the analyze call done by Check_Arg_Is_Local_Name
9484 -- will in fact generate a reference, so that the entity will
9485 -- have a reference, which will inhibit any warnings about it
9486 -- not being referenced, and also properly show up in the ali
9487 -- file as a reference. But this reference is recorded before
9488 -- the Has_Pragma_Unreferenced flag is set, so that no warning
9489 -- is generated for this reference.
9491 Check_Arg_Is_Local_Name (Arg_Node);
9492 Arg_Expr := Get_Pragma_Arg (Arg_Node);
9494 if Is_Entity_Name (Arg_Expr) then
9495 Arg_Ent := Entity (Arg_Expr);
9497 -- If the entity is overloaded, the pragma applies to the
9498 -- most recent overloading, as documented. In this case,
9499 -- name resolution does not generate a reference, so it
9500 -- must be done here explicitly.
9502 if Is_Overloaded (Arg_Expr) then
9503 Generate_Reference (Arg_Ent, N);
9506 Set_Has_Pragma_Unreferenced (Arg_Ent);
9513 ------------------------------
9514 -- Unreserve_All_Interrupts --
9515 ------------------------------
9517 -- pragma Unreserve_All_Interrupts;
9519 when Pragma_Unreserve_All_Interrupts =>
9521 Check_Arg_Count (0);
9523 if In_Extended_Main_Code_Unit (Main_Unit_Entity) then
9524 Unreserve_All_Interrupts := True;
9531 -- pragma Unsuppress (IDENTIFIER [, [On =>] NAME]);
9533 when Pragma_Unsuppress =>
9535 Process_Suppress_Unsuppress (False);
9541 -- pragma Use_VADS_Size;
9543 when Pragma_Use_VADS_Size =>
9545 Check_Arg_Count (0);
9546 Check_Valid_Configuration_Pragma;
9547 Use_VADS_Size := True;
9549 ---------------------
9550 -- Validity_Checks --
9551 ---------------------
9553 -- pragma Validity_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
9555 when Pragma_Validity_Checks => Validity_Checks : declare
9556 A : constant Node_Id := Expression (Arg1);
9562 Check_Arg_Count (1);
9563 Check_No_Identifiers;
9565 if Nkind (A) = N_String_Literal then
9569 Slen : constant Natural := Natural (String_Length (S));
9570 Options : String (1 .. Slen);
9576 C := Get_String_Char (S, Int (J));
9577 exit when not In_Character_Range (C);
9578 Options (J) := Get_Character (C);
9581 Set_Validity_Check_Options (Options);
9589 elsif Nkind (A) = N_Identifier then
9591 if Chars (A) = Name_All_Checks then
9592 Set_Validity_Check_Options ("a");
9594 elsif Chars (A) = Name_On then
9595 Validity_Checks_On := True;
9597 elsif Chars (A) = Name_Off then
9598 Validity_Checks_On := False;
9602 end Validity_Checks;
9608 -- pragma Volatile (LOCAL_NAME);
9610 when Pragma_Volatile =>
9611 Process_Atomic_Shared_Volatile;
9613 -------------------------
9614 -- Volatile_Components --
9615 -------------------------
9617 -- pragma Volatile_Components (array_LOCAL_NAME);
9619 -- Volatile is handled by the same circuit as Atomic_Components
9625 -- pragma Warnings (On | Off, [LOCAL_NAME])
9627 when Pragma_Warnings => Warnings : begin
9629 Check_At_Least_N_Arguments (1);
9630 Check_At_Most_N_Arguments (2);
9631 Check_No_Identifiers;
9633 -- One argument case was processed by parser in Par.Prag
9635 if Arg_Count /= 1 then
9636 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
9637 Check_Arg_Count (2);
9644 E_Id := Expression (Arg2);
9647 -- In the expansion of an inlined body, a reference to
9648 -- the formal may be wrapped in a conversion if the actual
9649 -- is a conversion. Retrieve the real entity name.
9652 and then Nkind (E_Id) = N_Unchecked_Type_Conversion
9654 E_Id := Expression (E_Id);
9657 if not Is_Entity_Name (E_Id) then
9659 ("second argument of pragma% must be entity name",
9669 Set_Warnings_Off (E,
9670 (Chars (Expression (Arg1)) = Name_Off));
9672 if Is_Enumeration_Type (E) then
9674 Lit : Entity_Id := First_Literal (E);
9677 while Present (Lit) loop
9678 Set_Warnings_Off (Lit);
9684 exit when No (Homonym (E));
9696 -- pragma Weak_External ([Entity =>] LOCAL_NAME);
9698 when Pragma_Weak_External => Weak_External : declare
9703 Check_Arg_Count (1);
9704 Check_Optional_Identifier (Arg1, Name_Entity);
9705 Check_Arg_Is_Library_Level_Local_Name (Arg1);
9706 Ent := Entity (Expression (Arg1));
9708 if Rep_Item_Too_Early (Ent, N) then
9711 Ent := Underlying_Type (Ent);
9714 -- The only processing required is to link this item on to the
9715 -- list of rep items for the given entity. This is accomplished
9716 -- by the call to Rep_Item_Too_Late (when no error is detected
9717 -- and False is returned).
9719 if Rep_Item_Too_Late (Ent, N) then
9722 Set_Has_Gigi_Rep_Item (Ent);
9726 --------------------
9727 -- Unknown_Pragma --
9728 --------------------
9730 -- Should be impossible, since the case of an unknown pragma is
9731 -- separately processed before the case statement is entered.
9733 when Unknown_Pragma =>
9734 raise Program_Error;
9739 when Pragma_Exit => null;
9742 ---------------------------------
9743 -- Delay_Config_Pragma_Analyze --
9744 ---------------------------------
9746 function Delay_Config_Pragma_Analyze (N : Node_Id) return Boolean is
9748 return Chars (N) = Name_Interrupt_State;
9749 end Delay_Config_Pragma_Analyze;
9751 -------------------------
9752 -- Get_Base_Subprogram --
9753 -------------------------
9755 function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id is
9761 -- Follow subprogram renaming chain
9763 while Is_Subprogram (Result)
9765 (Is_Generic_Instance (Result)
9766 or else Nkind (Parent (Declaration_Node (Result))) =
9767 N_Subprogram_Renaming_Declaration)
9768 and then Present (Alias (Result))
9770 Result := Alias (Result);
9774 end Get_Base_Subprogram;
9776 -----------------------------------------
9777 -- Is_Non_Significant_Pragma_Reference --
9778 -----------------------------------------
9780 -- This function makes use of the following static table which indicates
9781 -- whether a given pragma is significant. A value of -1 in this table
9782 -- indicates that the reference is significant. A value of zero indicates
9783 -- than appearence as any argument is insignificant, a positive value
9784 -- indicates that appearence in that parameter position is significant.
9786 Sig_Flags : constant array (Pragma_Id) of Int :=
9787 (Pragma_AST_Entry => -1,
9788 Pragma_Abort_Defer => -1,
9789 Pragma_Ada_83 => -1,
9790 Pragma_Ada_95 => -1,
9791 Pragma_All_Calls_Remote => -1,
9792 Pragma_Annotate => -1,
9793 Pragma_Assert => -1,
9794 Pragma_Asynchronous => -1,
9796 Pragma_Atomic_Components => 0,
9797 Pragma_Attach_Handler => -1,
9798 Pragma_CPP_Class => 0,
9799 Pragma_CPP_Constructor => 0,
9800 Pragma_CPP_Virtual => 0,
9801 Pragma_CPP_Vtable => 0,
9802 Pragma_C_Pass_By_Copy => 0,
9803 Pragma_Comment => 0,
9804 Pragma_Common_Object => -1,
9805 Pragma_Compile_Time_Warning => -1,
9806 Pragma_Complex_Representation => 0,
9807 Pragma_Component_Alignment => -1,
9808 Pragma_Controlled => 0,
9809 Pragma_Convention => 0,
9810 Pragma_Convention_Identifier => 0,
9812 Pragma_Discard_Names => 0,
9813 Pragma_Elaborate => -1,
9814 Pragma_Elaborate_All => -1,
9815 Pragma_Elaborate_Body => -1,
9816 Pragma_Elaboration_Checks => -1,
9817 Pragma_Eliminate => -1,
9818 Pragma_Explicit_Overriding => -1,
9819 Pragma_Export => -1,
9820 Pragma_Export_Exception => -1,
9821 Pragma_Export_Function => -1,
9822 Pragma_Export_Object => -1,
9823 Pragma_Export_Procedure => -1,
9824 Pragma_Export_Value => -1,
9825 Pragma_Export_Valued_Procedure => -1,
9826 Pragma_Extend_System => -1,
9827 Pragma_Extensions_Allowed => -1,
9828 Pragma_External => -1,
9829 Pragma_External_Name_Casing => -1,
9830 Pragma_Finalize_Storage_Only => 0,
9831 Pragma_Float_Representation => 0,
9833 Pragma_Import => +2,
9834 Pragma_Import_Exception => 0,
9835 Pragma_Import_Function => 0,
9836 Pragma_Import_Object => 0,
9837 Pragma_Import_Procedure => 0,
9838 Pragma_Import_Valued_Procedure => 0,
9839 Pragma_Initialize_Scalars => -1,
9841 Pragma_Inline_Always => 0,
9842 Pragma_Inline_Generic => 0,
9843 Pragma_Inspection_Point => -1,
9844 Pragma_Interface => +2,
9845 Pragma_Interface_Name => +2,
9846 Pragma_Interrupt_Handler => -1,
9847 Pragma_Interrupt_Priority => -1,
9848 Pragma_Interrupt_State => -1,
9849 Pragma_Java_Constructor => -1,
9850 Pragma_Java_Interface => -1,
9851 Pragma_Keep_Names => 0,
9852 Pragma_License => -1,
9853 Pragma_Link_With => -1,
9854 Pragma_Linker_Alias => -1,
9855 Pragma_Linker_Options => -1,
9856 Pragma_Linker_Section => -1,
9858 Pragma_Locking_Policy => -1,
9859 Pragma_Long_Float => -1,
9860 Pragma_Machine_Attribute => -1,
9862 Pragma_Main_Storage => -1,
9863 Pragma_Memory_Size => -1,
9864 Pragma_No_Return => 0,
9865 Pragma_No_Run_Time => -1,
9866 Pragma_Normalize_Scalars => -1,
9867 Pragma_Obsolescent => 0,
9868 Pragma_Optimize => -1,
9869 Pragma_Optional_Overriding => -1,
9870 Pragma_Overriding => -1,
9873 Pragma_Passive => -1,
9874 Pragma_Polling => -1,
9875 Pragma_Persistent_Data => -1,
9876 Pragma_Persistent_Object => -1,
9877 Pragma_Preelaborate => -1,
9878 Pragma_Priority => -1,
9879 Pragma_Propagate_Exceptions => -1,
9880 Pragma_Psect_Object => -1,
9882 Pragma_Pure_Function => 0,
9883 Pragma_Queuing_Policy => -1,
9884 Pragma_Ravenscar => -1,
9885 Pragma_Remote_Call_Interface => -1,
9886 Pragma_Remote_Types => -1,
9887 Pragma_Restricted_Run_Time => -1,
9888 Pragma_Restriction_Warnings => -1,
9889 Pragma_Restrictions => -1,
9890 Pragma_Reviewable => -1,
9891 Pragma_Share_Generic => -1,
9892 Pragma_Shared => -1,
9893 Pragma_Shared_Passive => -1,
9894 Pragma_Source_File_Name => -1,
9895 Pragma_Source_File_Name_Project => -1,
9896 Pragma_Source_Reference => -1,
9897 Pragma_Storage_Size => -1,
9898 Pragma_Storage_Unit => -1,
9899 Pragma_Stream_Convert => -1,
9900 Pragma_Style_Checks => -1,
9901 Pragma_Subtitle => -1,
9902 Pragma_Suppress => 0,
9903 Pragma_Suppress_Exception_Locations => 0,
9904 Pragma_Suppress_All => -1,
9905 Pragma_Suppress_Debug_Info => 0,
9906 Pragma_Suppress_Initialization => 0,
9907 Pragma_System_Name => -1,
9908 Pragma_Task_Dispatching_Policy => -1,
9909 Pragma_Task_Info => -1,
9910 Pragma_Task_Name => -1,
9911 Pragma_Task_Storage => 0,
9912 Pragma_Thread_Body => +2,
9913 Pragma_Time_Slice => -1,
9915 Pragma_Unchecked_Union => -1,
9916 Pragma_Unimplemented_Unit => -1,
9917 Pragma_Universal_Data => -1,
9918 Pragma_Unreferenced => -1,
9919 Pragma_Unreserve_All_Interrupts => -1,
9920 Pragma_Unsuppress => 0,
9921 Pragma_Use_VADS_Size => -1,
9922 Pragma_Validity_Checks => -1,
9923 Pragma_Volatile => 0,
9924 Pragma_Volatile_Components => 0,
9925 Pragma_Warnings => -1,
9926 Pragma_Weak_External => 0,
9927 Unknown_Pragma => 0);
9929 function Is_Non_Significant_Pragma_Reference (N : Node_Id) return Boolean is
9937 if Nkind (P) /= N_Pragma_Argument_Association then
9941 C := Sig_Flags (Get_Pragma_Id (Chars (Parent (P))));
9951 A := First (Pragma_Argument_Associations (Parent (P)));
9952 for J in 1 .. C - 1 loop
9963 end Is_Non_Significant_Pragma_Reference;
9965 ------------------------------
9966 -- Is_Pragma_String_Literal --
9967 ------------------------------
9969 -- This function returns true if the corresponding pragma argument is
9970 -- a static string expression. These are the only cases in which string
9971 -- literals can appear as pragma arguments. We also allow a string
9972 -- literal as the first argument to pragma Assert (although it will
9973 -- of course always generate a type error).
9975 function Is_Pragma_String_Literal (Par : Node_Id) return Boolean is
9976 Pragn : constant Node_Id := Parent (Par);
9977 Assoc : constant List_Id := Pragma_Argument_Associations (Pragn);
9978 Pname : constant Name_Id := Chars (Pragn);
9991 if Pname = Name_Assert then
9994 elsif Pname = Name_Export then
9997 elsif Pname = Name_Ident then
10000 elsif Pname = Name_Import then
10003 elsif Pname = Name_Interface_Name then
10006 elsif Pname = Name_Linker_Alias then
10009 elsif Pname = Name_Linker_Section then
10012 elsif Pname = Name_Machine_Attribute then
10015 elsif Pname = Name_Source_File_Name then
10018 elsif Pname = Name_Source_Reference then
10021 elsif Pname = Name_Title then
10024 elsif Pname = Name_Subtitle then
10030 end Is_Pragma_String_Literal;
10032 --------------------------------------
10033 -- Process_Compilation_Unit_Pragmas --
10034 --------------------------------------
10036 procedure Process_Compilation_Unit_Pragmas (N : Node_Id) is
10038 -- A special check for pragma Suppress_All. This is a strange DEC
10039 -- pragma, strange because it comes at the end of the unit. If we
10040 -- have a pragma Suppress_All in the Pragmas_After of the current
10041 -- unit, then we insert a pragma Suppress (All_Checks) at the start
10042 -- of the context clause to ensure the correct processing.
10045 PA : constant List_Id := Pragmas_After (Aux_Decls_Node (N));
10049 if Present (PA) then
10051 while Present (P) loop
10052 if Chars (P) = Name_Suppress_All then
10053 Prepend_To (Context_Items (N),
10054 Make_Pragma (Sloc (P),
10055 Chars => Name_Suppress,
10056 Pragma_Argument_Associations => New_List (
10057 Make_Pragma_Argument_Association (Sloc (P),
10059 Make_Identifier (Sloc (P),
10060 Chars => Name_All_Checks)))));
10068 end Process_Compilation_Unit_Pragmas;
10070 --------------------------------
10071 -- Set_Encoded_Interface_Name --
10072 --------------------------------
10074 procedure Set_Encoded_Interface_Name (E : Entity_Id; S : Node_Id) is
10075 Str : constant String_Id := Strval (S);
10076 Len : constant Int := String_Length (Str);
10081 Hex : constant array (0 .. 15) of Character := "0123456789abcdef";
10084 -- Stores encoded value of character code CC. The encoding we
10085 -- use an underscore followed by four lower case hex digits.
10087 procedure Encode is
10089 Store_String_Char (Get_Char_Code ('_'));
10091 (Get_Char_Code (Hex (Integer (CC / 2 ** 12))));
10093 (Get_Char_Code (Hex (Integer (CC / 2 ** 8 and 16#0F#))));
10095 (Get_Char_Code (Hex (Integer (CC / 2 ** 4 and 16#0F#))));
10097 (Get_Char_Code (Hex (Integer (CC and 16#0F#))));
10100 -- Start of processing for Set_Encoded_Interface_Name
10103 -- If first character is asterisk, this is a link name, and we
10104 -- leave it completely unmodified. We also ignore null strings
10105 -- (the latter case happens only in error cases) and no encoding
10106 -- should occur for Java interface names.
10109 or else Get_String_Char (Str, 1) = Get_Char_Code ('*')
10112 Set_Interface_Name (E, S);
10117 CC := Get_String_Char (Str, J);
10119 exit when not In_Character_Range (CC);
10121 C := Get_Character (CC);
10123 exit when C /= '_' and then C /= '$'
10124 and then C not in '0' .. '9'
10125 and then C not in 'a' .. 'z'
10126 and then C not in 'A' .. 'Z';
10129 Set_Interface_Name (E, S);
10137 -- Here we need to encode. The encoding we use as follows:
10138 -- three underscores + four hex digits (lower case)
10142 for J in 1 .. String_Length (Str) loop
10143 CC := Get_String_Char (Str, J);
10145 if not In_Character_Range (CC) then
10148 C := Get_Character (CC);
10150 if C = '_' or else C = '$'
10151 or else C in '0' .. '9'
10152 or else C in 'a' .. 'z'
10153 or else C in 'A' .. 'Z'
10155 Store_String_Char (CC);
10162 Set_Interface_Name (E,
10163 Make_String_Literal (Sloc (S),
10164 Strval => End_String));
10166 end Set_Encoded_Interface_Name;
10168 -------------------
10169 -- Set_Unit_Name --
10170 -------------------
10172 procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id) is
10177 if Nkind (N) = N_Identifier
10178 and then Nkind (With_Item) = N_Identifier
10180 Set_Entity (N, Entity (With_Item));
10182 elsif Nkind (N) = N_Selected_Component then
10183 Change_Selected_Component_To_Expanded_Name (N);
10184 Set_Entity (N, Entity (With_Item));
10185 Set_Entity (Selector_Name (N), Entity (N));
10187 Pref := Prefix (N);
10188 Scop := Scope (Entity (N));
10190 while Nkind (Pref) = N_Selected_Component loop
10191 Change_Selected_Component_To_Expanded_Name (Pref);
10192 Set_Entity (Selector_Name (Pref), Scop);
10193 Set_Entity (Pref, Scop);
10194 Pref := Prefix (Pref);
10195 Scop := Scope (Scop);
10198 Set_Entity (Pref, Scop);