1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2008, 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 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. 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 COPYING3. If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 -- This unit contains the semantic processing for all pragmas, both language
27 -- and implementation defined. For most pragmas, the parser only does the
28 -- most basic job of checking the syntax, so Sem_Prag also contains the code
29 -- to complete the syntax checks. Certain pragmas are handled partially or
30 -- completely by the parser (see Par.Prag for further details).
32 with Atree; use Atree;
33 with Casing; use Casing;
34 with Checks; use Checks;
35 with Csets; use Csets;
36 with Debug; use Debug;
37 with Einfo; use Einfo;
38 with Errout; use Errout;
39 with Exp_Dist; use Exp_Dist;
41 with Lib.Writ; use Lib.Writ;
42 with Lib.Xref; use Lib.Xref;
43 with Namet.Sp; use Namet.Sp;
44 with Nlists; use Nlists;
45 with Nmake; use Nmake;
47 with Output; use Output;
48 with Restrict; use Restrict;
49 with Rident; use Rident;
50 with Rtsfind; use Rtsfind;
52 with Sem_Aux; use Sem_Aux;
53 with Sem_Ch3; use Sem_Ch3;
54 with Sem_Ch6; use Sem_Ch6;
55 with Sem_Ch8; use Sem_Ch8;
56 with Sem_Ch12; use Sem_Ch12;
57 with Sem_Ch13; use Sem_Ch13;
58 with Sem_Dist; use Sem_Dist;
59 with Sem_Elim; use Sem_Elim;
60 with Sem_Eval; use Sem_Eval;
61 with Sem_Intr; use Sem_Intr;
62 with Sem_Mech; use Sem_Mech;
63 with Sem_Res; use Sem_Res;
64 with Sem_Type; use Sem_Type;
65 with Sem_Util; use Sem_Util;
66 with Sem_VFpt; use Sem_VFpt;
67 with Sem_Warn; use Sem_Warn;
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;
76 with Targparm; use Targparm;
77 with Tbuild; use Tbuild;
79 with Uintp; use Uintp;
80 with Uname; use Uname;
81 with Urealp; use Urealp;
82 with Validsw; use Validsw;
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 -- Checking for Duplicated External Names --
143 --------------------------------------------
145 -- It is suspicious if two separate Export pragmas use the same external
146 -- name. The following table is used to diagnose this situation so that
147 -- an appropriate warning can be issued.
149 -- The Node_Id stored is for the N_String_Literal node created to
150 -- hold the value of the external name. The Sloc of this node is
151 -- used to cross-reference the location of the duplication.
153 package Externals is new Table.Table (
154 Table_Component_Type => Node_Id,
155 Table_Index_Type => Int,
156 Table_Low_Bound => 0,
157 Table_Initial => 100,
158 Table_Increment => 100,
159 Table_Name => "Name_Externals");
161 -------------------------------------
162 -- Local Subprograms and Variables --
163 -------------------------------------
165 function Adjust_External_Name_Case (N : Node_Id) return Node_Id;
166 -- This routine is used for possible casing adjustment of an explicit
167 -- external name supplied as a string literal (the node N), according
168 -- to the casing requirement of Opt.External_Name_Casing. If this is
169 -- set to As_Is, then the string literal is returned unchanged, but if
170 -- it is set to Uppercase or Lowercase, then a new string literal with
171 -- appropriate casing is constructed.
173 function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id;
174 -- If Def_Id refers to a renamed subprogram, then the base subprogram
175 -- (the original one, following the renaming chain) is returned.
176 -- Otherwise the entity is returned unchanged. Should be in Einfo???
178 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id;
179 -- All the routines that check pragma arguments take either a pragma
180 -- argument association (in which case the expression of the argument
181 -- association is checked), or the expression directly. The function
182 -- Get_Pragma_Arg is a utility used to deal with these two cases. If Arg
183 -- is a pragma argument association node, then its expression is returned,
184 -- otherwise Arg is returned unchanged.
187 -- This is a dummy function called by the processing for pragma Reviewable.
188 -- It is there for assisting front end debugging. By placing a Reviewable
189 -- pragma in the source program, a breakpoint on rv catches this place in
190 -- the source, allowing convenient stepping to the point of interest.
192 procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id);
193 -- Place semantic information on the argument of an Elaborate or
194 -- Elaborate_All pragma. Entity name for unit and its parents is
195 -- taken from item in previous with_clause that mentions the unit.
197 -------------------------------
198 -- Adjust_External_Name_Case --
199 -------------------------------
201 function Adjust_External_Name_Case (N : Node_Id) return Node_Id is
205 -- Adjust case of literal if required
207 if Opt.External_Name_Exp_Casing = As_Is then
211 -- Copy existing string
217 for J in 1 .. String_Length (Strval (N)) loop
218 CC := Get_String_Char (Strval (N), J);
220 if Opt.External_Name_Exp_Casing = Uppercase
221 and then CC >= Get_Char_Code ('a')
222 and then CC <= Get_Char_Code ('z')
224 Store_String_Char (CC - 32);
226 elsif Opt.External_Name_Exp_Casing = Lowercase
227 and then CC >= Get_Char_Code ('A')
228 and then CC <= Get_Char_Code ('Z')
230 Store_String_Char (CC + 32);
233 Store_String_Char (CC);
238 Make_String_Literal (Sloc (N),
239 Strval => End_String);
241 end Adjust_External_Name_Case;
243 ------------------------------
244 -- Analyze_PPC_In_Decl_Part --
245 ------------------------------
247 procedure Analyze_PPC_In_Decl_Part (N : Node_Id; S : Entity_Id) is
248 Arg1 : constant Node_Id :=
249 First (Pragma_Argument_Associations (N));
250 Arg2 : constant Node_Id := Next (Arg1);
253 -- Install formals and push subprogram spec onto scope stack
254 -- so that we can see the formals from the pragma.
259 -- Preanalyze the boolean expression, we treat this as a
260 -- spec expression (i.e. similar to a default expression).
262 Preanalyze_Spec_Expression
263 (Get_Pragma_Arg (Arg1), Standard_Boolean);
265 -- If there is a message argument, analyze it the same way
267 if Present (Arg2) then
268 Preanalyze_Spec_Expression
269 (Get_Pragma_Arg (Arg2), Standard_String);
272 -- Remove the subprogram from the scope stack now that the
273 -- pre-analysis of the precondition/postcondition is done.
276 end Analyze_PPC_In_Decl_Part;
282 procedure Analyze_Pragma (N : Node_Id) is
283 Loc : constant Source_Ptr := Sloc (N);
284 Pname : constant Name_Id := Pragma_Name (N);
287 Pragma_Exit : exception;
288 -- This exception is used to exit pragma processing completely. It
289 -- is used when an error is detected, and no further processing is
290 -- required. It is also used if an earlier error has left the tree
291 -- in a state where the pragma should not be processed.
294 -- Number of pragma argument associations
300 -- First four pragma arguments (pragma argument association nodes,
301 -- or Empty if the corresponding argument does not exist).
303 type Name_List is array (Natural range <>) of Name_Id;
304 type Args_List is array (Natural range <>) of Node_Id;
305 -- Types used for arguments to Check_Arg_Order and Gather_Associations
307 procedure Ada_2005_Pragma;
308 -- Called for pragmas defined in Ada 2005, that are not in Ada 95. In
309 -- Ada 95 mode, these are implementation defined pragmas, so should be
310 -- caught by the No_Implementation_Pragmas restriction
312 procedure Check_Ada_83_Warning;
313 -- Issues a warning message for the current pragma if operating in Ada
314 -- 83 mode (used for language pragmas that are not a standard part of
315 -- Ada 83). This procedure does not raise Error_Pragma. Also notes use
318 procedure Check_Arg_Count (Required : Nat);
319 -- Check argument count for pragma is equal to given parameter.
320 -- If not, then issue an error message and raise Pragma_Exit.
322 -- Note: all routines whose name is Check_Arg_Is_xxx take an
323 -- argument Arg which can either be a pragma argument association,
324 -- in which case the check is applied to the expression of the
325 -- association or an expression directly.
327 procedure Check_Arg_Is_External_Name (Arg : Node_Id);
328 -- Check that an argument has the right form for an EXTERNAL_NAME
329 -- parameter of an extended import/export pragma. The rule is that
330 -- the name must be an identifier or string literal (in Ada 83 mode)
331 -- or a static string expression (in Ada 95 mode).
333 procedure Check_Arg_Is_Identifier (Arg : Node_Id);
334 -- Check the specified argument Arg to make sure that it is an
335 -- identifier. If not give error and raise Pragma_Exit.
337 procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id);
338 -- Check the specified argument Arg to make sure that it is an
339 -- integer literal. If not give error and raise Pragma_Exit.
341 procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id);
342 -- Check the specified argument Arg to make sure that it has the
343 -- proper syntactic form for a local name and meets the semantic
344 -- requirements for a local name. The local name is analyzed as
345 -- part of the processing for this call. In addition, the local
346 -- name is required to represent an entity at the library level.
348 procedure Check_Arg_Is_Local_Name (Arg : Node_Id);
349 -- Check the specified argument Arg to make sure that it has the
350 -- proper syntactic form for a local name and meets the semantic
351 -- requirements for a local name. The local name is analyzed as
352 -- part of the processing for this call.
354 procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id);
355 -- Check the specified argument Arg to make sure that it is a valid
356 -- locking policy name. If not give error and raise Pragma_Exit.
358 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id);
359 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2, N3 : Name_Id);
360 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2, N3, N4 : Name_Id);
361 -- Check the specified argument Arg to make sure that it is an
362 -- identifier whose name matches either N1 or N2 (or N3 if present).
363 -- If not then give error and raise Pragma_Exit.
365 procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id);
366 -- Check the specified argument Arg to make sure that it is a valid
367 -- queuing policy name. If not give error and raise Pragma_Exit.
369 procedure Check_Arg_Is_Static_Expression
372 -- Check the specified argument Arg to make sure that it is a static
373 -- expression of the given type (i.e. it will be analyzed and resolved
374 -- using this type, which can be any valid argument to Resolve, e.g.
375 -- Any_Integer is OK). If not, given error and raise Pragma_Exit.
377 procedure Check_Arg_Is_String_Literal (Arg : Node_Id);
378 -- Check the specified argument Arg to make sure that it is a
379 -- string literal. If not give error and raise Pragma_Exit
381 procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id);
382 -- Check the specified argument Arg to make sure that it is a valid
383 -- valid task dispatching policy name. If not give error and raise
386 procedure Check_Arg_Order (Names : Name_List);
387 -- Checks for an instance of two arguments with identifiers for the
388 -- current pragma which are not in the sequence indicated by Names,
389 -- and if so, generates a fatal message about bad order of arguments.
391 procedure Check_At_Least_N_Arguments (N : Nat);
392 -- Check there are at least N arguments present
394 procedure Check_At_Most_N_Arguments (N : Nat);
395 -- Check there are no more than N arguments present
397 procedure Check_Component (Comp : Node_Id);
398 -- Examine Unchecked_Union component for correct use of per-object
399 -- constrained subtypes, and for restrictions on finalizable components.
401 procedure Check_Duplicated_Export_Name (Nam : Node_Id);
402 -- Nam is an N_String_Literal node containing the external name set
403 -- by an Import or Export pragma (or extended Import or Export pragma).
404 -- This procedure checks for possible duplications if this is the
405 -- export case, and if found, issues an appropriate error message.
407 procedure Check_First_Subtype (Arg : Node_Id);
408 -- Checks that Arg, whose expression is an entity name referencing
409 -- a subtype, does not reference a type that is not a first subtype.
411 procedure Check_In_Main_Program;
412 -- Common checks for pragmas that appear within a main program
413 -- (Priority, Main_Storage, Time_Slice, Relative_Deadline).
415 procedure Check_Interrupt_Or_Attach_Handler;
416 -- Common processing for first argument of pragma Interrupt_Handler
417 -- or pragma Attach_Handler.
419 procedure Check_Is_In_Decl_Part_Or_Package_Spec;
420 -- Check that pragma appears in a declarative part, or in a package
421 -- specification, i.e. that it does not occur in a statement sequence
424 procedure Check_No_Identifier (Arg : Node_Id);
425 -- Checks that the given argument does not have an identifier. If
426 -- an identifier is present, then an error message is issued, and
427 -- Pragma_Exit is raised.
429 procedure Check_No_Identifiers;
430 -- Checks that none of the arguments to the pragma has an identifier.
431 -- If any argument has an identifier, then an error message is issued,
432 -- and Pragma_Exit is raised.
434 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id);
435 -- Checks if the given argument has an identifier, and if so, requires
436 -- it to match the given identifier name. If there is a non-matching
437 -- identifier, then an error message is given and Error_Pragmas raised.
439 procedure Check_Optional_Identifier (Arg : Node_Id; Id : String);
440 -- Checks if the given argument has an identifier, and if so, requires
441 -- it to match the given identifier name. If there is a non-matching
442 -- identifier, then an error message is given and Error_Pragmas raised.
443 -- In this version of the procedure, the identifier name is given as
444 -- a string with lower case letters.
446 procedure Check_Precondition_Postcondition (In_Body : out Boolean);
447 -- Called to process a precondition or postcondition pragma. There are
450 -- The pragma appears after a subprogram spec
452 -- If the corresponding check is not enabled, the pragma is analyzed
453 -- but otherwise ignored and control returns with In_Body set False.
455 -- If the check is enabled, then the first step is to analyze the
456 -- pragma, but this is skipped if the subprogram spec appears within
457 -- a package specification (because this is the case where we delay
458 -- analysis till the end of the spec). Then (whether or not it was
459 -- analyzed), the pragma is chained to the subprogram in question
460 -- (using Spec_PPC_List and Next_Pragma) and control returns to the
461 -- caller with In_Body set False.
463 -- The pragma appears at the start of subprogram body declarations
465 -- In this case an immediate return to the caller is made with
466 -- In_Body set True, and the pragma is NOT analyzed.
468 -- In all other cases, an error message for bad placement is given
470 procedure Check_Static_Constraint (Constr : Node_Id);
471 -- Constr is a constraint from an N_Subtype_Indication node from a
472 -- component constraint in an Unchecked_Union type. This routine checks
473 -- that the constraint is static as required by the restrictions for
476 procedure Check_Valid_Configuration_Pragma;
477 -- Legality checks for placement of a configuration pragma
479 procedure Check_Valid_Library_Unit_Pragma;
480 -- Legality checks for library unit pragmas. A special case arises for
481 -- pragmas in generic instances that come from copies of the original
482 -- library unit pragmas in the generic templates. In the case of other
483 -- than library level instantiations these can appear in contexts which
484 -- would normally be invalid (they only apply to the original template
485 -- and to library level instantiations), and they are simply ignored,
486 -- which is implemented by rewriting them as null statements.
488 procedure Check_Variant (Variant : Node_Id);
489 -- Check Unchecked_Union variant for lack of nested variants and
490 -- presence of at least one component.
492 procedure Error_Pragma (Msg : String);
493 pragma No_Return (Error_Pragma);
494 -- Outputs error message for current pragma. The message contains a %
495 -- that will be replaced with the pragma name, and the flag is placed
496 -- on the pragma itself. Pragma_Exit is then raised.
498 procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id);
499 pragma No_Return (Error_Pragma_Arg);
500 -- Outputs error message for current pragma. The message may contain
501 -- a % that will be replaced with the pragma name. The parameter Arg
502 -- may either be a pragma argument association, in which case the flag
503 -- is placed on the expression of this association, or an expression,
504 -- in which case the flag is placed directly on the expression. The
505 -- message is placed using Error_Msg_N, so the message may also contain
506 -- an & insertion character which will reference the given Arg value.
507 -- After placing the message, Pragma_Exit is raised.
509 procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id);
510 pragma No_Return (Error_Pragma_Arg);
511 -- Similar to above form of Error_Pragma_Arg except that two messages
512 -- are provided, the second is a continuation comment starting with \.
514 procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id);
515 pragma No_Return (Error_Pragma_Arg_Ident);
516 -- Outputs error message for current pragma. The message may contain
517 -- a % that will be replaced with the pragma name. The parameter Arg
518 -- must be a pragma argument association with a non-empty identifier
519 -- (i.e. its Chars field must be set), and the error message is placed
520 -- on the identifier. The message is placed using Error_Msg_N so
521 -- the message may also contain an & insertion character which will
522 -- reference the identifier. After placing the message, Pragma_Exit
525 procedure Error_Pragma_Ref (Msg : String; Ref : Entity_Id);
526 pragma No_Return (Error_Pragma_Ref);
527 -- Outputs error message for current pragma. The message may contain
528 -- a % that will be replaced with the pragma name. The parameter Ref
529 -- must be an entity whose name can be referenced by & and sloc by #.
530 -- After placing the message, Pragma_Exit is raised.
532 function Find_Lib_Unit_Name return Entity_Id;
533 -- Used for a library unit pragma to find the entity to which the
534 -- library unit pragma applies, returns the entity found.
536 procedure Find_Program_Unit_Name (Id : Node_Id);
537 -- If the pragma is a compilation unit pragma, the id must denote the
538 -- compilation unit in the same compilation, and the pragma must appear
539 -- in the list of preceding or trailing pragmas. If it is a program
540 -- unit pragma that is not a compilation unit pragma, then the
541 -- identifier must be visible.
543 function Find_Unique_Parameterless_Procedure
545 Arg : Node_Id) return Entity_Id;
546 -- Used for a procedure pragma to find the unique parameterless
547 -- procedure identified by Name, returns it if it exists, otherwise
548 -- errors out and uses Arg as the pragma argument for the message.
550 procedure Gather_Associations
552 Args : out Args_List);
553 -- This procedure is used to gather the arguments for a pragma that
554 -- permits arbitrary ordering of parameters using the normal rules
555 -- for named and positional parameters. The Names argument is a list
556 -- of Name_Id values that corresponds to the allowed pragma argument
557 -- association identifiers in order. The result returned in Args is
558 -- a list of corresponding expressions that are the pragma arguments.
559 -- Note that this is a list of expressions, not of pragma argument
560 -- associations (Gather_Associations has completely checked all the
561 -- optional identifiers when it returns). An entry in Args is Empty
562 -- on return if the corresponding argument is not present.
564 procedure GNAT_Pragma;
565 -- Called for all GNAT defined pragmas to check the relevant restriction
566 -- (No_Implementation_Pragmas).
568 function Is_Before_First_Decl
569 (Pragma_Node : Node_Id;
570 Decls : List_Id) return Boolean;
571 -- Return True if Pragma_Node is before the first declarative item in
572 -- Decls where Decls is the list of declarative items.
574 function Is_Configuration_Pragma return Boolean;
575 -- Determines if the placement of the current pragma is appropriate
576 -- for a configuration pragma.
578 function Is_In_Context_Clause return Boolean;
579 -- Returns True if pragma appears within the context clause of a unit,
580 -- and False for any other placement (does not generate any messages).
582 function Is_Static_String_Expression (Arg : Node_Id) return Boolean;
583 -- Analyzes the argument, and determines if it is a static string
584 -- expression, returns True if so, False if non-static or not String.
586 procedure Pragma_Misplaced;
587 pragma No_Return (Pragma_Misplaced);
588 -- Issue fatal error message for misplaced pragma
590 procedure Process_Atomic_Shared_Volatile;
591 -- Common processing for pragmas Atomic, Shared, Volatile. Note that
592 -- Shared is an obsolete Ada 83 pragma, treated as being identical
593 -- in effect to pragma Atomic.
595 procedure Process_Compile_Time_Warning_Or_Error;
596 -- Common processing for Compile_Time_Error and Compile_Time_Warning
598 procedure Process_Convention (C : out Convention_Id; E : out Entity_Id);
599 -- Common processing for Convention, Interface, Import and Export.
600 -- Checks first two arguments of pragma, and sets the appropriate
601 -- convention value in the specified entity or entities. On return
602 -- C is the convention, E is the referenced entity.
604 procedure Process_Extended_Import_Export_Exception_Pragma
605 (Arg_Internal : Node_Id;
606 Arg_External : Node_Id;
609 -- Common processing for the pragmas Import/Export_Exception.
610 -- The three arguments correspond to the three named parameters of
611 -- the pragma. An argument is empty if the corresponding parameter
612 -- is not present in the pragma.
614 procedure Process_Extended_Import_Export_Object_Pragma
615 (Arg_Internal : Node_Id;
616 Arg_External : Node_Id;
618 -- Common processing for the pragmas Import/Export_Object.
619 -- The three arguments correspond to the three named parameters
620 -- of the pragmas. An argument is empty if the corresponding
621 -- parameter is not present in the pragma.
623 procedure Process_Extended_Import_Export_Internal_Arg
624 (Arg_Internal : Node_Id := Empty);
625 -- Common processing for all extended Import and Export pragmas. The
626 -- argument is the pragma parameter for the Internal argument. If
627 -- Arg_Internal is empty or inappropriate, an error message is posted.
628 -- Otherwise, on normal return, the Entity_Field of Arg_Internal is
629 -- set to identify the referenced entity.
631 procedure Process_Extended_Import_Export_Subprogram_Pragma
632 (Arg_Internal : Node_Id;
633 Arg_External : Node_Id;
634 Arg_Parameter_Types : Node_Id;
635 Arg_Result_Type : Node_Id := Empty;
636 Arg_Mechanism : Node_Id;
637 Arg_Result_Mechanism : Node_Id := Empty;
638 Arg_First_Optional_Parameter : Node_Id := Empty);
639 -- Common processing for all extended Import and Export pragmas
640 -- applying to subprograms. The caller omits any arguments that do
641 -- not apply to the pragma in question (for example, Arg_Result_Type
642 -- can be non-Empty only in the Import_Function and Export_Function
643 -- cases). The argument names correspond to the allowed pragma
644 -- association identifiers.
646 procedure Process_Generic_List;
647 -- Common processing for Share_Generic and Inline_Generic
649 procedure Process_Import_Or_Interface;
650 -- Common processing for Import of Interface
652 procedure Process_Inline (Active : Boolean);
653 -- Common processing for Inline and Inline_Always. The parameter
654 -- indicates if the inline pragma is active, i.e. if it should
655 -- actually cause inlining to occur.
657 procedure Process_Interface_Name
658 (Subprogram_Def : Entity_Id;
661 -- Given the last two arguments of pragma Import, pragma Export, or
662 -- pragma Interface_Name, performs validity checks and sets the
663 -- Interface_Name field of the given subprogram entity to the
664 -- appropriate external or link name, depending on the arguments
665 -- given. Ext_Arg is always present, but Link_Arg may be missing.
666 -- Note that Ext_Arg may represent the Link_Name if Link_Arg is
667 -- missing, and appropriate named notation is used for Ext_Arg.
668 -- If neither Ext_Arg nor Link_Arg is present, the interface name
669 -- is set to the default from the subprogram name.
671 procedure Process_Interrupt_Or_Attach_Handler;
672 -- Common processing for Interrupt and Attach_Handler pragmas
674 procedure Process_Restrictions_Or_Restriction_Warnings (Warn : Boolean);
675 -- Common processing for Restrictions and Restriction_Warnings pragmas.
676 -- Warn is True for Restriction_Warnings, or for Restrictions if the
677 -- flag Treat_Restrictions_As_Warnings is set, and False if this flag
678 -- is not set in the Restrictions case.
680 procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean);
681 -- Common processing for Suppress and Unsuppress. The boolean parameter
682 -- Suppress_Case is True for the Suppress case, and False for the
685 procedure Set_Exported (E : Entity_Id; Arg : Node_Id);
686 -- This procedure sets the Is_Exported flag for the given entity,
687 -- checking that the entity was not previously imported. Arg is
688 -- the argument that specified the entity. A check is also made
689 -- for exporting inappropriate entities.
691 procedure Set_Extended_Import_Export_External_Name
692 (Internal_Ent : Entity_Id;
693 Arg_External : Node_Id);
694 -- Common processing for all extended import export pragmas. The first
695 -- argument, Internal_Ent, is the internal entity, which has already
696 -- been checked for validity by the caller. Arg_External is from the
697 -- Import or Export pragma, and may be null if no External parameter
698 -- was present. If Arg_External is present and is a non-null string
699 -- (a null string is treated as the default), then the Interface_Name
700 -- field of Internal_Ent is set appropriately.
702 procedure Set_Imported (E : Entity_Id);
703 -- This procedure sets the Is_Imported flag for the given entity,
704 -- checking that it is not previously exported or imported.
706 procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id);
707 -- Mech is a parameter passing mechanism (see Import_Function syntax
708 -- for MECHANISM_NAME). This routine checks that the mechanism argument
709 -- has the right form, and if not issues an error message. If the
710 -- argument has the right form then the Mechanism field of Ent is
711 -- set appropriately.
713 procedure Set_Ravenscar_Profile (N : Node_Id);
714 -- Activate the set of configuration pragmas and restrictions that
715 -- make up the Ravenscar Profile. N is the corresponding pragma
716 -- node, which is used for error messages on any constructs
717 -- that violate the profile.
719 ---------------------
720 -- Ada_2005_Pragma --
721 ---------------------
723 procedure Ada_2005_Pragma is
725 if Ada_Version <= Ada_95 then
726 Check_Restriction (No_Implementation_Pragmas, N);
730 --------------------------
731 -- Check_Ada_83_Warning --
732 --------------------------
734 procedure Check_Ada_83_Warning is
736 if Ada_Version = Ada_83 and then Comes_From_Source (N) then
737 Error_Msg_N ("(Ada 83) pragma& is non-standard?", N);
739 end Check_Ada_83_Warning;
741 ---------------------
742 -- Check_Arg_Count --
743 ---------------------
745 procedure Check_Arg_Count (Required : Nat) is
747 if Arg_Count /= Required then
748 Error_Pragma ("wrong number of arguments for pragma%");
752 --------------------------------
753 -- Check_Arg_Is_External_Name --
754 --------------------------------
756 procedure Check_Arg_Is_External_Name (Arg : Node_Id) is
757 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
760 if Nkind (Argx) = N_Identifier then
764 Analyze_And_Resolve (Argx, Standard_String);
766 if Is_OK_Static_Expression (Argx) then
769 elsif Etype (Argx) = Any_Type then
772 -- An interesting special case, if we have a string literal and
773 -- we are in Ada 83 mode, then we allow it even though it will
774 -- not be flagged as static. This allows expected Ada 83 mode
775 -- use of external names which are string literals, even though
776 -- technically these are not static in Ada 83.
778 elsif Ada_Version = Ada_83
779 and then Nkind (Argx) = N_String_Literal
783 -- Static expression that raises Constraint_Error. This has
784 -- already been flagged, so just exit from pragma processing.
786 elsif Is_Static_Expression (Argx) then
789 -- Here we have a real error (non-static expression)
792 Error_Msg_Name_1 := Pname;
794 ("argument for pragma% must be a identifier or " &
795 "static string expression!", Argx);
799 end Check_Arg_Is_External_Name;
801 -----------------------------
802 -- Check_Arg_Is_Identifier --
803 -----------------------------
805 procedure Check_Arg_Is_Identifier (Arg : Node_Id) is
806 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
808 if Nkind (Argx) /= N_Identifier then
810 ("argument for pragma% must be identifier", Argx);
812 end Check_Arg_Is_Identifier;
814 ----------------------------------
815 -- Check_Arg_Is_Integer_Literal --
816 ----------------------------------
818 procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id) is
819 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
821 if Nkind (Argx) /= N_Integer_Literal then
823 ("argument for pragma% must be integer literal", Argx);
825 end Check_Arg_Is_Integer_Literal;
827 -------------------------------------------
828 -- Check_Arg_Is_Library_Level_Local_Name --
829 -------------------------------------------
833 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
834 -- | library_unit_NAME
836 procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id) is
838 Check_Arg_Is_Local_Name (Arg);
840 if not Is_Library_Level_Entity (Entity (Expression (Arg)))
841 and then Comes_From_Source (N)
844 ("argument for pragma% must be library level entity", Arg);
846 end Check_Arg_Is_Library_Level_Local_Name;
848 -----------------------------
849 -- Check_Arg_Is_Local_Name --
850 -----------------------------
854 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
855 -- | library_unit_NAME
857 procedure Check_Arg_Is_Local_Name (Arg : Node_Id) is
858 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
863 if Nkind (Argx) not in N_Direct_Name
864 and then (Nkind (Argx) /= N_Attribute_Reference
865 or else Present (Expressions (Argx))
866 or else Nkind (Prefix (Argx)) /= N_Identifier)
867 and then (not Is_Entity_Name (Argx)
868 or else not Is_Compilation_Unit (Entity (Argx)))
870 Error_Pragma_Arg ("argument for pragma% must be local name", Argx);
873 if Is_Entity_Name (Argx)
874 and then Scope (Entity (Argx)) /= Current_Scope
877 ("pragma% argument must be in same declarative part", Arg);
879 end Check_Arg_Is_Local_Name;
881 ---------------------------------
882 -- Check_Arg_Is_Locking_Policy --
883 ---------------------------------
885 procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id) is
886 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
889 Check_Arg_Is_Identifier (Argx);
891 if not Is_Locking_Policy_Name (Chars (Argx)) then
893 ("& is not a valid locking policy name", Argx);
895 end Check_Arg_Is_Locking_Policy;
897 -------------------------
898 -- Check_Arg_Is_One_Of --
899 -------------------------
901 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id) is
902 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
905 Check_Arg_Is_Identifier (Argx);
907 if Chars (Argx) /= N1 and then Chars (Argx) /= N2 then
908 Error_Msg_Name_2 := N1;
909 Error_Msg_Name_3 := N2;
910 Error_Pragma_Arg ("argument for pragma% must be% or%", Argx);
912 end Check_Arg_Is_One_Of;
914 procedure Check_Arg_Is_One_Of
916 N1, N2, N3 : Name_Id)
918 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
921 Check_Arg_Is_Identifier (Argx);
923 if Chars (Argx) /= N1
924 and then Chars (Argx) /= N2
925 and then Chars (Argx) /= N3
927 Error_Pragma_Arg ("invalid argument for pragma%", Argx);
929 end Check_Arg_Is_One_Of;
931 procedure Check_Arg_Is_One_Of
933 N1, N2, N3, N4 : Name_Id)
935 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
938 Check_Arg_Is_Identifier (Argx);
940 if Chars (Argx) /= N1
941 and then Chars (Argx) /= N2
942 and then Chars (Argx) /= N3
943 and then Chars (Argx) /= N4
945 Error_Pragma_Arg ("invalid argument for pragma%", Argx);
947 end Check_Arg_Is_One_Of;
949 ---------------------------------
950 -- Check_Arg_Is_Queuing_Policy --
951 ---------------------------------
953 procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id) is
954 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
957 Check_Arg_Is_Identifier (Argx);
959 if not Is_Queuing_Policy_Name (Chars (Argx)) then
961 ("& is not a valid queuing policy name", Argx);
963 end Check_Arg_Is_Queuing_Policy;
965 ------------------------------------
966 -- Check_Arg_Is_Static_Expression --
967 ------------------------------------
969 procedure Check_Arg_Is_Static_Expression
973 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
976 Analyze_And_Resolve (Argx, Typ);
978 if Is_OK_Static_Expression (Argx) then
981 elsif Etype (Argx) = Any_Type then
984 -- An interesting special case, if we have a string literal and
985 -- we are in Ada 83 mode, then we allow it even though it will
986 -- not be flagged as static. This allows the use of Ada 95
987 -- pragmas like Import in Ada 83 mode. They will of course be
988 -- flagged with warnings as usual, but will not cause errors.
990 elsif Ada_Version = Ada_83
991 and then Nkind (Argx) = N_String_Literal
995 -- Static expression that raises Constraint_Error. This has
996 -- already been flagged, so just exit from pragma processing.
998 elsif Is_Static_Expression (Argx) then
1001 -- Finally, we have a real error
1004 Error_Msg_Name_1 := Pname;
1005 Flag_Non_Static_Expr
1006 ("argument for pragma% must be a static expression!", Argx);
1009 end Check_Arg_Is_Static_Expression;
1011 ---------------------------------
1012 -- Check_Arg_Is_String_Literal --
1013 ---------------------------------
1015 procedure Check_Arg_Is_String_Literal (Arg : Node_Id) is
1016 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1018 if Nkind (Argx) /= N_String_Literal then
1020 ("argument for pragma% must be string literal", Argx);
1022 end Check_Arg_Is_String_Literal;
1024 ------------------------------------------
1025 -- Check_Arg_Is_Task_Dispatching_Policy --
1026 ------------------------------------------
1028 procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id) is
1029 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1032 Check_Arg_Is_Identifier (Argx);
1034 if not Is_Task_Dispatching_Policy_Name (Chars (Argx)) then
1036 ("& is not a valid task dispatching policy name", Argx);
1038 end Check_Arg_Is_Task_Dispatching_Policy;
1040 ---------------------
1041 -- Check_Arg_Order --
1042 ---------------------
1044 procedure Check_Arg_Order (Names : Name_List) is
1047 Highest_So_Far : Natural := 0;
1048 -- Highest index in Names seen do far
1052 for J in 1 .. Arg_Count loop
1053 if Chars (Arg) /= No_Name then
1054 for K in Names'Range loop
1055 if Chars (Arg) = Names (K) then
1056 if K < Highest_So_Far then
1057 Error_Msg_Name_1 := Pname;
1059 ("parameters out of order for pragma%", Arg);
1060 Error_Msg_Name_1 := Names (K);
1061 Error_Msg_Name_2 := Names (Highest_So_Far);
1062 Error_Msg_N ("\% must appear before %", Arg);
1066 Highest_So_Far := K;
1074 end Check_Arg_Order;
1076 --------------------------------
1077 -- Check_At_Least_N_Arguments --
1078 --------------------------------
1080 procedure Check_At_Least_N_Arguments (N : Nat) is
1082 if Arg_Count < N then
1083 Error_Pragma ("too few arguments for pragma%");
1085 end Check_At_Least_N_Arguments;
1087 -------------------------------
1088 -- Check_At_Most_N_Arguments --
1089 -------------------------------
1091 procedure Check_At_Most_N_Arguments (N : Nat) is
1094 if Arg_Count > N then
1096 for J in 1 .. N loop
1098 Error_Pragma_Arg ("too many arguments for pragma%", Arg);
1101 end Check_At_Most_N_Arguments;
1103 ---------------------
1104 -- Check_Component --
1105 ---------------------
1107 procedure Check_Component (Comp : Node_Id) is
1109 if Nkind (Comp) = N_Component_Declaration then
1111 Sindic : constant Node_Id :=
1112 Subtype_Indication (Component_Definition (Comp));
1113 Typ : constant Entity_Id :=
1114 Etype (Defining_Identifier (Comp));
1116 if Nkind (Sindic) = N_Subtype_Indication then
1118 -- Ada 2005 (AI-216): If a component subtype is subject to
1119 -- a per-object constraint, then the component type shall
1120 -- be an Unchecked_Union.
1122 if Has_Per_Object_Constraint (Defining_Identifier (Comp))
1124 not Is_Unchecked_Union (Etype (Subtype_Mark (Sindic)))
1126 Error_Msg_N ("component subtype subject to per-object" &
1127 " constraint must be an Unchecked_Union", Comp);
1131 if Is_Controlled (Typ) then
1133 ("component of unchecked union cannot be controlled", Comp);
1135 elsif Has_Task (Typ) then
1137 ("component of unchecked union cannot have tasks", Comp);
1141 end Check_Component;
1143 ----------------------------------
1144 -- Check_Duplicated_Export_Name --
1145 ----------------------------------
1147 procedure Check_Duplicated_Export_Name (Nam : Node_Id) is
1148 String_Val : constant String_Id := Strval (Nam);
1151 -- We are only interested in the export case, and in the case of
1152 -- generics, it is the instance, not the template, that is the
1153 -- problem (the template will generate a warning in any case).
1155 if not Inside_A_Generic
1156 and then (Prag_Id = Pragma_Export
1158 Prag_Id = Pragma_Export_Procedure
1160 Prag_Id = Pragma_Export_Valued_Procedure
1162 Prag_Id = Pragma_Export_Function)
1164 for J in Externals.First .. Externals.Last loop
1165 if String_Equal (String_Val, Strval (Externals.Table (J))) then
1166 Error_Msg_Sloc := Sloc (Externals.Table (J));
1167 Error_Msg_N ("external name duplicates name given#", Nam);
1172 Externals.Append (Nam);
1174 end Check_Duplicated_Export_Name;
1176 -------------------------
1177 -- Check_First_Subtype --
1178 -------------------------
1180 procedure Check_First_Subtype (Arg : Node_Id) is
1181 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1183 if not Is_First_Subtype (Entity (Argx)) then
1185 ("pragma% cannot apply to subtype", Argx);
1187 end Check_First_Subtype;
1189 ---------------------------
1190 -- Check_In_Main_Program --
1191 ---------------------------
1193 procedure Check_In_Main_Program is
1194 P : constant Node_Id := Parent (N);
1197 -- Must be at in subprogram body
1199 if Nkind (P) /= N_Subprogram_Body then
1200 Error_Pragma ("% pragma allowed only in subprogram");
1202 -- Otherwise warn if obviously not main program
1204 elsif Present (Parameter_Specifications (Specification (P)))
1205 or else not Is_Compilation_Unit (Defining_Entity (P))
1207 Error_Msg_Name_1 := Pname;
1209 ("?pragma% is only effective in main program", N);
1211 end Check_In_Main_Program;
1213 ---------------------------------------
1214 -- Check_Interrupt_Or_Attach_Handler --
1215 ---------------------------------------
1217 procedure Check_Interrupt_Or_Attach_Handler is
1218 Arg1_X : constant Node_Id := Expression (Arg1);
1219 Handler_Proc, Proc_Scope : Entity_Id;
1224 if Prag_Id = Pragma_Interrupt_Handler then
1225 Check_Restriction (No_Dynamic_Attachment, N);
1228 Handler_Proc := Find_Unique_Parameterless_Procedure (Arg1_X, Arg1);
1229 Proc_Scope := Scope (Handler_Proc);
1231 -- On AAMP only, a pragma Interrupt_Handler is supported for
1232 -- nonprotected parameterless procedures.
1234 if not AAMP_On_Target
1235 or else Prag_Id = Pragma_Attach_Handler
1237 if Ekind (Proc_Scope) /= E_Protected_Type then
1239 ("argument of pragma% must be protected procedure", Arg1);
1242 if Parent (N) /= Protected_Definition (Parent (Proc_Scope)) then
1243 Error_Pragma ("pragma% must be in protected definition");
1247 if not Is_Library_Level_Entity (Proc_Scope)
1248 or else (AAMP_On_Target
1249 and then not Is_Library_Level_Entity (Handler_Proc))
1252 ("argument for pragma% must be library level entity", Arg1);
1254 end Check_Interrupt_Or_Attach_Handler;
1256 -------------------------------------------
1257 -- Check_Is_In_Decl_Part_Or_Package_Spec --
1258 -------------------------------------------
1260 procedure Check_Is_In_Decl_Part_Or_Package_Spec is
1269 elsif Nkind (P) = N_Handled_Sequence_Of_Statements then
1272 elsif Nkind (P) = N_Package_Specification then
1275 elsif Nkind (P) = N_Block_Statement then
1278 -- Note: the following tests seem a little peculiar, because
1279 -- they test for bodies, but if we were in the statement part
1280 -- of the body, we would already have hit the handled statement
1281 -- sequence, so the only way we get here is by being in the
1282 -- declarative part of the body.
1284 elsif Nkind (P) = N_Subprogram_Body
1285 or else Nkind (P) = N_Package_Body
1286 or else Nkind (P) = N_Task_Body
1287 or else Nkind (P) = N_Entry_Body
1295 Error_Pragma ("pragma% is not in declarative part or package spec");
1296 end Check_Is_In_Decl_Part_Or_Package_Spec;
1298 -------------------------
1299 -- Check_No_Identifier --
1300 -------------------------
1302 procedure Check_No_Identifier (Arg : Node_Id) is
1304 if Chars (Arg) /= No_Name then
1305 Error_Pragma_Arg_Ident
1306 ("pragma% does not permit identifier& here", Arg);
1308 end Check_No_Identifier;
1310 --------------------------
1311 -- Check_No_Identifiers --
1312 --------------------------
1314 procedure Check_No_Identifiers is
1317 if Arg_Count > 0 then
1319 while Present (Arg_Node) loop
1320 Check_No_Identifier (Arg_Node);
1324 end Check_No_Identifiers;
1326 -------------------------------
1327 -- Check_Optional_Identifier --
1328 -------------------------------
1330 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id) is
1332 if Present (Arg) and then Chars (Arg) /= No_Name then
1333 if Chars (Arg) /= Id then
1334 Error_Msg_Name_1 := Pname;
1335 Error_Msg_Name_2 := Id;
1336 Error_Msg_N ("pragma% argument expects identifier%", Arg);
1340 end Check_Optional_Identifier;
1342 procedure Check_Optional_Identifier (Arg : Node_Id; Id : String) is
1344 Name_Buffer (1 .. Id'Length) := Id;
1345 Name_Len := Id'Length;
1346 Check_Optional_Identifier (Arg, Name_Find);
1347 end Check_Optional_Identifier;
1349 --------------------------------------
1350 -- Check_Precondition_Postcondition --
1351 --------------------------------------
1353 procedure Check_Precondition_Postcondition (In_Body : out Boolean) is
1357 procedure Chain_PPC (PO : Node_Id);
1358 -- If PO is a subprogram declaration node (or a generic subprogram
1359 -- declaration node), then the precondition/postcondition applies
1360 -- to this subprogram and the processing for the pragma is completed.
1361 -- Otherwise the pragma is misplaced.
1367 procedure Chain_PPC (PO : Node_Id) is
1371 if not Nkind_In (PO, N_Subprogram_Declaration,
1372 N_Generic_Subprogram_Declaration)
1377 -- Here if we have subprogram or generic subprogram declaration
1379 S := Defining_Unit_Name (Specification (PO));
1381 -- Analyze the pragma unless it appears within a package spec,
1382 -- which is the case where we delay the analysis of the PPC until
1383 -- the end of the package declarations (for details, see
1384 -- Analyze_Package_Specification.Analyze_PPCs).
1386 if Ekind (Scope (S)) /= E_Package
1388 Ekind (Scope (S)) /= E_Generic_Package
1390 Analyze_PPC_In_Decl_Part (N, S);
1393 -- Chain spec PPC pragma to list for subprogram
1395 Set_Next_Pragma (N, Spec_PPC_List (S));
1396 Set_Spec_PPC_List (S, N);
1398 -- Return indicating spec case
1404 -- Start of processing for Check_Precondition_Postcondition
1407 if not Is_List_Member (N) then
1411 -- Record whether pragma is enabled
1413 Set_PPC_Enabled (N, Check_Enabled (Pname));
1415 -- If we are within an inlined body, the legality of the pragma
1416 -- has been checked already.
1418 if In_Inlined_Body then
1423 -- Search prior declarations
1426 while Present (Prev (P)) loop
1429 -- If the previous node is a generic subprogram, do not go to
1430 -- to the original node, which is the unanalyzed tree: we need
1431 -- to attach the pre/postconditions to the analyzed version
1432 -- at this point. They get propagated to the original tree when
1433 -- analyzing the corresponding body.
1435 if Nkind (P) not in N_Generic_Declaration then
1436 PO := Original_Node (P);
1441 -- Skip past prior pragma
1443 if Nkind (PO) = N_Pragma then
1446 -- Skip stuff not coming from source
1448 elsif not Comes_From_Source (PO) then
1451 -- Only remaining possibility is subprogram declaration
1459 -- If we fall through loop, pragma is at start of list, so see if
1460 -- it is at the start of declarations of a subprogram body.
1462 if Nkind (Parent (N)) = N_Subprogram_Body
1463 and then List_Containing (N) = Declarations (Parent (N))
1465 if Operating_Mode /= Generate_Code then
1467 -- Analyze expression in pragma, for correctness
1468 -- and for ASIS use.
1470 Preanalyze_Spec_Expression
1471 (Get_Pragma_Arg (Arg1), Standard_Boolean);
1477 -- See if it is in the pragmas after a library level subprogram
1479 elsif Nkind (Parent (N)) = N_Compilation_Unit_Aux then
1480 Chain_PPC (Unit (Parent (Parent (N))));
1484 -- If we fall through, pragma was misplaced
1487 end Check_Precondition_Postcondition;
1489 -----------------------------
1490 -- Check_Static_Constraint --
1491 -----------------------------
1493 -- Note: for convenience in writing this procedure, in addition to
1494 -- the officially (i.e. by spec) allowed argument which is always
1495 -- a constraint, it also allows ranges and discriminant associations.
1496 -- Above is not clear ???
1498 procedure Check_Static_Constraint (Constr : Node_Id) is
1500 procedure Require_Static (E : Node_Id);
1501 -- Require given expression to be static expression
1503 --------------------
1504 -- Require_Static --
1505 --------------------
1507 procedure Require_Static (E : Node_Id) is
1509 if not Is_OK_Static_Expression (E) then
1510 Flag_Non_Static_Expr
1511 ("non-static constraint not allowed in Unchecked_Union!", E);
1516 -- Start of processing for Check_Static_Constraint
1519 case Nkind (Constr) is
1520 when N_Discriminant_Association =>
1521 Require_Static (Expression (Constr));
1524 Require_Static (Low_Bound (Constr));
1525 Require_Static (High_Bound (Constr));
1527 when N_Attribute_Reference =>
1528 Require_Static (Type_Low_Bound (Etype (Prefix (Constr))));
1529 Require_Static (Type_High_Bound (Etype (Prefix (Constr))));
1531 when N_Range_Constraint =>
1532 Check_Static_Constraint (Range_Expression (Constr));
1534 when N_Index_Or_Discriminant_Constraint =>
1538 IDC := First (Constraints (Constr));
1539 while Present (IDC) loop
1540 Check_Static_Constraint (IDC);
1548 end Check_Static_Constraint;
1550 --------------------------------------
1551 -- Check_Valid_Configuration_Pragma --
1552 --------------------------------------
1554 -- A configuration pragma must appear in the context clause of a
1555 -- compilation unit, and only other pragmas may precede it. Note that
1556 -- the test also allows use in a configuration pragma file.
1558 procedure Check_Valid_Configuration_Pragma is
1560 if not Is_Configuration_Pragma then
1561 Error_Pragma ("incorrect placement for configuration pragma%");
1563 end Check_Valid_Configuration_Pragma;
1565 -------------------------------------
1566 -- Check_Valid_Library_Unit_Pragma --
1567 -------------------------------------
1569 procedure Check_Valid_Library_Unit_Pragma is
1571 Parent_Node : Node_Id;
1572 Unit_Name : Entity_Id;
1573 Unit_Kind : Node_Kind;
1574 Unit_Node : Node_Id;
1575 Sindex : Source_File_Index;
1578 if not Is_List_Member (N) then
1582 Plist := List_Containing (N);
1583 Parent_Node := Parent (Plist);
1585 if Parent_Node = Empty then
1588 -- Case of pragma appearing after a compilation unit. In this
1589 -- case it must have an argument with the corresponding name
1590 -- and must be part of the following pragmas of its parent.
1592 elsif Nkind (Parent_Node) = N_Compilation_Unit_Aux then
1593 if Plist /= Pragmas_After (Parent_Node) then
1596 elsif Arg_Count = 0 then
1598 ("argument required if outside compilation unit");
1601 Check_No_Identifiers;
1602 Check_Arg_Count (1);
1603 Unit_Node := Unit (Parent (Parent_Node));
1604 Unit_Kind := Nkind (Unit_Node);
1606 Analyze (Expression (Arg1));
1608 if Unit_Kind = N_Generic_Subprogram_Declaration
1609 or else Unit_Kind = N_Subprogram_Declaration
1611 Unit_Name := Defining_Entity (Unit_Node);
1613 elsif Unit_Kind in N_Generic_Instantiation then
1614 Unit_Name := Defining_Entity (Unit_Node);
1617 Unit_Name := Cunit_Entity (Current_Sem_Unit);
1620 if Chars (Unit_Name) /=
1621 Chars (Entity (Expression (Arg1)))
1624 ("pragma% argument is not current unit name", Arg1);
1627 if Ekind (Unit_Name) = E_Package
1628 and then Present (Renamed_Entity (Unit_Name))
1630 Error_Pragma ("pragma% not allowed for renamed package");
1634 -- Pragma appears other than after a compilation unit
1637 -- Here we check for the generic instantiation case and also
1638 -- for the case of processing a generic formal package. We
1639 -- detect these cases by noting that the Sloc on the node
1640 -- does not belong to the current compilation unit.
1642 Sindex := Source_Index (Current_Sem_Unit);
1644 if Loc not in Source_First (Sindex) .. Source_Last (Sindex) then
1645 Rewrite (N, Make_Null_Statement (Loc));
1648 -- If before first declaration, the pragma applies to the
1649 -- enclosing unit, and the name if present must be this name.
1651 elsif Is_Before_First_Decl (N, Plist) then
1652 Unit_Node := Unit_Declaration_Node (Current_Scope);
1653 Unit_Kind := Nkind (Unit_Node);
1655 if Nkind (Parent (Unit_Node)) /= N_Compilation_Unit then
1658 elsif Unit_Kind = N_Subprogram_Body
1659 and then not Acts_As_Spec (Unit_Node)
1663 elsif Nkind (Parent_Node) = N_Package_Body then
1666 elsif Nkind (Parent_Node) = N_Package_Specification
1667 and then Plist = Private_Declarations (Parent_Node)
1671 elsif (Nkind (Parent_Node) = N_Generic_Package_Declaration
1672 or else Nkind (Parent_Node) =
1673 N_Generic_Subprogram_Declaration)
1674 and then Plist = Generic_Formal_Declarations (Parent_Node)
1678 elsif Arg_Count > 0 then
1679 Analyze (Expression (Arg1));
1681 if Entity (Expression (Arg1)) /= Current_Scope then
1683 ("name in pragma% must be enclosing unit", Arg1);
1686 -- It is legal to have no argument in this context
1692 -- Error if not before first declaration. This is because a
1693 -- library unit pragma argument must be the name of a library
1694 -- unit (RM 10.1.5(7)), but the only names permitted in this
1695 -- context are (RM 10.1.5(6)) names of subprogram declarations,
1696 -- generic subprogram declarations or generic instantiations.
1700 ("pragma% misplaced, must be before first declaration");
1704 end Check_Valid_Library_Unit_Pragma;
1710 procedure Check_Variant (Variant : Node_Id) is
1711 Clist : constant Node_Id := Component_List (Variant);
1715 if not Is_Non_Empty_List (Component_Items (Clist)) then
1717 ("Unchecked_Union may not have empty component list",
1722 Comp := First (Component_Items (Clist));
1723 while Present (Comp) loop
1724 Check_Component (Comp);
1733 procedure Error_Pragma (Msg : String) is
1735 Error_Msg_Name_1 := Pname;
1736 Error_Msg_N (Msg, N);
1740 ----------------------
1741 -- Error_Pragma_Arg --
1742 ----------------------
1744 procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id) is
1746 Error_Msg_Name_1 := Pname;
1747 Error_Msg_N (Msg, Get_Pragma_Arg (Arg));
1749 end Error_Pragma_Arg;
1751 procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id) is
1753 Error_Msg_Name_1 := Pname;
1754 Error_Msg_N (Msg1, Get_Pragma_Arg (Arg));
1755 Error_Pragma_Arg (Msg2, Arg);
1756 end Error_Pragma_Arg;
1758 ----------------------------
1759 -- Error_Pragma_Arg_Ident --
1760 ----------------------------
1762 procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id) is
1764 Error_Msg_Name_1 := Pname;
1765 Error_Msg_N (Msg, Arg);
1767 end Error_Pragma_Arg_Ident;
1769 ----------------------
1770 -- Error_Pragma_Ref --
1771 ----------------------
1773 procedure Error_Pragma_Ref (Msg : String; Ref : Entity_Id) is
1775 Error_Msg_Name_1 := Pname;
1776 Error_Msg_Sloc := Sloc (Ref);
1777 Error_Msg_NE (Msg, N, Ref);
1779 end Error_Pragma_Ref;
1781 ------------------------
1782 -- Find_Lib_Unit_Name --
1783 ------------------------
1785 function Find_Lib_Unit_Name return Entity_Id is
1787 -- Return inner compilation unit entity, for case of nested
1788 -- categorization pragmas. This happens in generic unit.
1790 if Nkind (Parent (N)) = N_Package_Specification
1791 and then Defining_Entity (Parent (N)) /= Current_Scope
1793 return Defining_Entity (Parent (N));
1795 return Current_Scope;
1797 end Find_Lib_Unit_Name;
1799 ----------------------------
1800 -- Find_Program_Unit_Name --
1801 ----------------------------
1803 procedure Find_Program_Unit_Name (Id : Node_Id) is
1804 Unit_Name : Entity_Id;
1805 Unit_Kind : Node_Kind;
1806 P : constant Node_Id := Parent (N);
1809 if Nkind (P) = N_Compilation_Unit then
1810 Unit_Kind := Nkind (Unit (P));
1812 if Unit_Kind = N_Subprogram_Declaration
1813 or else Unit_Kind = N_Package_Declaration
1814 or else Unit_Kind in N_Generic_Declaration
1816 Unit_Name := Defining_Entity (Unit (P));
1818 if Chars (Id) = Chars (Unit_Name) then
1819 Set_Entity (Id, Unit_Name);
1820 Set_Etype (Id, Etype (Unit_Name));
1822 Set_Etype (Id, Any_Type);
1824 ("cannot find program unit referenced by pragma%");
1828 Set_Etype (Id, Any_Type);
1829 Error_Pragma ("pragma% inapplicable to this unit");
1835 end Find_Program_Unit_Name;
1837 -----------------------------------------
1838 -- Find_Unique_Parameterless_Procedure --
1839 -----------------------------------------
1841 function Find_Unique_Parameterless_Procedure
1843 Arg : Node_Id) return Entity_Id
1845 Proc : Entity_Id := Empty;
1848 -- The body of this procedure needs some comments ???
1850 if not Is_Entity_Name (Name) then
1852 ("argument of pragma% must be entity name", Arg);
1854 elsif not Is_Overloaded (Name) then
1855 Proc := Entity (Name);
1857 if Ekind (Proc) /= E_Procedure
1858 or else Present (First_Formal (Proc)) then
1860 ("argument of pragma% must be parameterless procedure", Arg);
1865 Found : Boolean := False;
1867 Index : Interp_Index;
1870 Get_First_Interp (Name, Index, It);
1871 while Present (It.Nam) loop
1874 if Ekind (Proc) = E_Procedure
1875 and then No (First_Formal (Proc))
1879 Set_Entity (Name, Proc);
1880 Set_Is_Overloaded (Name, False);
1883 ("ambiguous handler name for pragma% ", Arg);
1887 Get_Next_Interp (Index, It);
1892 ("argument of pragma% must be parameterless procedure",
1895 Proc := Entity (Name);
1901 end Find_Unique_Parameterless_Procedure;
1903 -------------------------
1904 -- Gather_Associations --
1905 -------------------------
1907 procedure Gather_Associations
1909 Args : out Args_List)
1914 -- Initialize all parameters to Empty
1916 for J in Args'Range loop
1920 -- That's all we have to do if there are no argument associations
1922 if No (Pragma_Argument_Associations (N)) then
1926 -- Otherwise first deal with any positional parameters present
1928 Arg := First (Pragma_Argument_Associations (N));
1929 for Index in Args'Range loop
1930 exit when No (Arg) or else Chars (Arg) /= No_Name;
1931 Args (Index) := Expression (Arg);
1935 -- Positional parameters all processed, if any left, then we
1936 -- have too many positional parameters.
1938 if Present (Arg) and then Chars (Arg) = No_Name then
1940 ("too many positional associations for pragma%", Arg);
1943 -- Process named parameters if any are present
1945 while Present (Arg) loop
1946 if Chars (Arg) = No_Name then
1948 ("positional association cannot follow named association",
1952 for Index in Names'Range loop
1953 if Names (Index) = Chars (Arg) then
1954 if Present (Args (Index)) then
1956 ("duplicate argument association for pragma%", Arg);
1958 Args (Index) := Expression (Arg);
1963 if Index = Names'Last then
1964 Error_Msg_Name_1 := Pname;
1965 Error_Msg_N ("pragma% does not allow & argument", Arg);
1967 -- Check for possible misspelling
1969 for Index1 in Names'Range loop
1970 if Is_Bad_Spelling_Of
1971 (Chars (Arg), Names (Index1))
1973 Error_Msg_Name_1 := Names (Index1);
1974 Error_Msg_N ("\possible misspelling of%", Arg);
1986 end Gather_Associations;
1992 procedure GNAT_Pragma is
1994 Check_Restriction (No_Implementation_Pragmas, N);
1997 --------------------------
1998 -- Is_Before_First_Decl --
1999 --------------------------
2001 function Is_Before_First_Decl
2002 (Pragma_Node : Node_Id;
2003 Decls : List_Id) return Boolean
2005 Item : Node_Id := First (Decls);
2008 -- Only other pragmas can come before this pragma
2011 if No (Item) or else Nkind (Item) /= N_Pragma then
2014 elsif Item = Pragma_Node then
2020 end Is_Before_First_Decl;
2022 -----------------------------
2023 -- Is_Configuration_Pragma --
2024 -----------------------------
2026 -- A configuration pragma must appear in the context clause of a
2027 -- compilation unit, and only other pragmas may precede it. Note that
2028 -- the test below also permits use in a configuration pragma file.
2030 function Is_Configuration_Pragma return Boolean is
2031 Lis : constant List_Id := List_Containing (N);
2032 Par : constant Node_Id := Parent (N);
2036 -- If no parent, then we are in the configuration pragma file,
2037 -- so the placement is definitely appropriate.
2042 -- Otherwise we must be in the context clause of a compilation unit
2043 -- and the only thing allowed before us in the context list is more
2044 -- configuration pragmas.
2046 elsif Nkind (Par) = N_Compilation_Unit
2047 and then Context_Items (Par) = Lis
2054 elsif Nkind (Prg) /= N_Pragma then
2064 end Is_Configuration_Pragma;
2066 --------------------------
2067 -- Is_In_Context_Clause --
2068 --------------------------
2070 function Is_In_Context_Clause return Boolean is
2072 Parent_Node : Node_Id;
2075 if not Is_List_Member (N) then
2079 Plist := List_Containing (N);
2080 Parent_Node := Parent (Plist);
2082 if Parent_Node = Empty
2083 or else Nkind (Parent_Node) /= N_Compilation_Unit
2084 or else Context_Items (Parent_Node) /= Plist
2091 end Is_In_Context_Clause;
2093 ---------------------------------
2094 -- Is_Static_String_Expression --
2095 ---------------------------------
2097 function Is_Static_String_Expression (Arg : Node_Id) return Boolean is
2098 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
2101 Analyze_And_Resolve (Argx);
2102 return Is_OK_Static_Expression (Argx)
2103 and then Nkind (Argx) = N_String_Literal;
2104 end Is_Static_String_Expression;
2106 ----------------------
2107 -- Pragma_Misplaced --
2108 ----------------------
2110 procedure Pragma_Misplaced is
2112 Error_Pragma ("incorrect placement of pragma%");
2113 end Pragma_Misplaced;
2115 ------------------------------------
2116 -- Process Atomic_Shared_Volatile --
2117 ------------------------------------
2119 procedure Process_Atomic_Shared_Volatile is
2126 procedure Set_Atomic (E : Entity_Id);
2127 -- Set given type as atomic, and if no explicit alignment was given,
2128 -- set alignment to unknown, since back end knows what the alignment
2129 -- requirements are for atomic arrays. Note: this step is necessary
2130 -- for derived types.
2136 procedure Set_Atomic (E : Entity_Id) is
2140 if not Has_Alignment_Clause (E) then
2141 Set_Alignment (E, Uint_0);
2145 -- Start of processing for Process_Atomic_Shared_Volatile
2148 Check_Ada_83_Warning;
2149 Check_No_Identifiers;
2150 Check_Arg_Count (1);
2151 Check_Arg_Is_Local_Name (Arg1);
2152 E_Id := Expression (Arg1);
2154 if Etype (E_Id) = Any_Type then
2159 D := Declaration_Node (E);
2163 if Rep_Item_Too_Early (E, N)
2165 Rep_Item_Too_Late (E, N)
2169 Check_First_Subtype (Arg1);
2172 if Prag_Id /= Pragma_Volatile then
2174 Set_Atomic (Underlying_Type (E));
2175 Set_Atomic (Base_Type (E));
2178 -- Attribute belongs on the base type. If the view of the type is
2179 -- currently private, it also belongs on the underlying type.
2181 Set_Is_Volatile (Base_Type (E));
2182 Set_Is_Volatile (Underlying_Type (E));
2184 Set_Treat_As_Volatile (E);
2185 Set_Treat_As_Volatile (Underlying_Type (E));
2187 elsif K = N_Object_Declaration
2188 or else (K = N_Component_Declaration
2189 and then Original_Record_Component (E) = E)
2191 if Rep_Item_Too_Late (E, N) then
2195 if Prag_Id /= Pragma_Volatile then
2198 -- If the object declaration has an explicit initialization, a
2199 -- temporary may have to be created to hold the expression, to
2200 -- ensure that access to the object remain atomic.
2202 if Nkind (Parent (E)) = N_Object_Declaration
2203 and then Present (Expression (Parent (E)))
2205 Set_Has_Delayed_Freeze (E);
2208 -- An interesting improvement here. If an object of type X
2209 -- is declared atomic, and the type X is not atomic, that's
2210 -- a pity, since it may not have appropriate alignment etc.
2211 -- We can rescue this in the special case where the object
2212 -- and type are in the same unit by just setting the type
2213 -- as atomic, so that the back end will process it as atomic.
2215 Utyp := Underlying_Type (Etype (E));
2218 and then Sloc (E) > No_Location
2219 and then Sloc (Utyp) > No_Location
2221 Get_Source_File_Index (Sloc (E)) =
2222 Get_Source_File_Index (Sloc (Underlying_Type (Etype (E))))
2224 Set_Is_Atomic (Underlying_Type (Etype (E)));
2228 Set_Is_Volatile (E);
2229 Set_Treat_As_Volatile (E);
2233 ("inappropriate entity for pragma%", Arg1);
2235 end Process_Atomic_Shared_Volatile;
2237 -------------------------------------------
2238 -- Process_Compile_Time_Warning_Or_Error --
2239 -------------------------------------------
2241 procedure Process_Compile_Time_Warning_Or_Error is
2242 Arg1x : constant Node_Id := Get_Pragma_Arg (Arg1);
2245 Check_Arg_Count (2);
2246 Check_No_Identifiers;
2247 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
2248 Analyze_And_Resolve (Arg1x, Standard_Boolean);
2250 if Compile_Time_Known_Value (Arg1x) then
2251 if Is_True (Expr_Value (Get_Pragma_Arg (Arg1))) then
2253 Str : constant String_Id :=
2254 Strval (Get_Pragma_Arg (Arg2));
2255 Len : constant Int := String_Length (Str);
2260 Cent : constant Entity_Id :=
2261 Cunit_Entity (Current_Sem_Unit);
2263 Force : constant Boolean :=
2264 Prag_Id = Pragma_Compile_Time_Warning
2266 Is_Spec_Name (Unit_Name (Current_Sem_Unit))
2267 and then (Ekind (Cent) /= E_Package
2268 or else not In_Private_Part (Cent));
2269 -- Set True if this is the warning case, and we are in the
2270 -- visible part of a package spec, or in a subprogram spec,
2271 -- in which case we want to force the client to see the
2272 -- warning, even though it is not in the main unit.
2275 -- Loop through segments of message separated by line
2276 -- feeds. We output these segments as separate messages
2277 -- with continuation marks for all but the first.
2282 Error_Msg_Strlen := 0;
2284 -- Loop to copy characters from argument to error
2285 -- message string buffer.
2288 exit when Ptr > Len;
2289 CC := Get_String_Char (Str, Ptr);
2292 -- Ignore wide chars ??? else store character
2294 if In_Character_Range (CC) then
2295 C := Get_Character (CC);
2296 exit when C = ASCII.LF;
2297 Error_Msg_Strlen := Error_Msg_Strlen + 1;
2298 Error_Msg_String (Error_Msg_Strlen) := C;
2302 -- Here with one line ready to go
2304 Error_Msg_Warn := Prag_Id = Pragma_Compile_Time_Warning;
2306 -- If this is a warning in a spec, then we want clients
2307 -- to see the warning, so mark the message with the
2308 -- special sequence !! to force the warning. In the case
2309 -- of a package spec, we do not force this if we are in
2310 -- the private part of the spec.
2313 if Cont = False then
2314 Error_Msg_N ("<~!!", Arg1);
2317 Error_Msg_N ("\<~!!", Arg1);
2320 -- Error, rather than warning, or in a body, so we do not
2321 -- need to force visibility for client (error will be
2322 -- output in any case, and this is the situation in which
2323 -- we do not want a client to get a warning, since the
2324 -- warning is in the body or the spec private part.
2327 if Cont = False then
2328 Error_Msg_N ("<~", Arg1);
2331 Error_Msg_N ("\<~", Arg1);
2335 exit when Ptr > Len;
2340 end Process_Compile_Time_Warning_Or_Error;
2342 ------------------------
2343 -- Process_Convention --
2344 ------------------------
2346 procedure Process_Convention
2347 (C : out Convention_Id;
2353 Comp_Unit : Unit_Number_Type;
2355 procedure Set_Convention_From_Pragma (E : Entity_Id);
2356 -- Set convention in entity E, and also flag that the entity has a
2357 -- convention pragma. If entity is for a private or incomplete type,
2358 -- also set convention and flag on underlying type. This procedure
2359 -- also deals with the special case of C_Pass_By_Copy convention.
2361 --------------------------------
2362 -- Set_Convention_From_Pragma --
2363 --------------------------------
2365 procedure Set_Convention_From_Pragma (E : Entity_Id) is
2367 -- Ada 2005 (AI-430): Check invalid attempt to change convention
2368 -- for an overridden dispatching operation. Technically this is
2369 -- an amendment and should only be done in Ada 2005 mode. However,
2370 -- this is clearly a mistake, since the problem that is addressed
2371 -- by this AI is that there is a clear gap in the RM!
2373 if Is_Dispatching_Operation (E)
2374 and then Present (Overridden_Operation (E))
2375 and then C /= Convention (Overridden_Operation (E))
2378 ("cannot change convention for " &
2379 "overridden dispatching operation",
2383 -- Set the convention
2385 Set_Convention (E, C);
2386 Set_Has_Convention_Pragma (E);
2388 if Is_Incomplete_Or_Private_Type (E) then
2389 Set_Convention (Underlying_Type (E), C);
2390 Set_Has_Convention_Pragma (Underlying_Type (E), True);
2393 -- A class-wide type should inherit the convention of
2394 -- the specific root type (although this isn't specified
2395 -- clearly by the RM).
2397 if Is_Type (E) and then Present (Class_Wide_Type (E)) then
2398 Set_Convention (Class_Wide_Type (E), C);
2401 -- If the entity is a record type, then check for special case of
2402 -- C_Pass_By_Copy, which is treated the same as C except that the
2403 -- special record flag is set. This convention is only permitted
2404 -- on record types (see AI95-00131).
2406 if Cname = Name_C_Pass_By_Copy then
2407 if Is_Record_Type (E) then
2408 Set_C_Pass_By_Copy (Base_Type (E));
2409 elsif Is_Incomplete_Or_Private_Type (E)
2410 and then Is_Record_Type (Underlying_Type (E))
2412 Set_C_Pass_By_Copy (Base_Type (Underlying_Type (E)));
2415 ("C_Pass_By_Copy convention allowed only for record type",
2420 -- If the entity is a derived boolean type, check for the
2421 -- special case of convention C, C++, or Fortran, where we
2422 -- consider any nonzero value to represent true.
2424 if Is_Discrete_Type (E)
2425 and then Root_Type (Etype (E)) = Standard_Boolean
2431 C = Convention_Fortran)
2433 Set_Nonzero_Is_True (Base_Type (E));
2435 end Set_Convention_From_Pragma;
2437 -- Start of processing for Process_Convention
2440 Check_At_Least_N_Arguments (2);
2441 Check_Optional_Identifier (Arg1, Name_Convention);
2442 Check_Arg_Is_Identifier (Arg1);
2443 Cname := Chars (Expression (Arg1));
2445 -- C_Pass_By_Copy is treated as a synonym for convention C
2446 -- (this is tested again below to set the critical flag)
2448 if Cname = Name_C_Pass_By_Copy then
2451 -- Otherwise we must have something in the standard convention list
2453 elsif Is_Convention_Name (Cname) then
2454 C := Get_Convention_Id (Chars (Expression (Arg1)));
2456 -- In DEC VMS, it seems that there is an undocumented feature that
2457 -- any unrecognized convention is treated as the default, which for
2458 -- us is convention C. It does not seem so terrible to do this
2459 -- unconditionally, silently in the VMS case, and with a warning
2460 -- in the non-VMS case.
2463 if Warn_On_Export_Import and not OpenVMS_On_Target then
2465 ("?unrecognized convention name, C assumed",
2472 Check_Optional_Identifier (Arg2, Name_Entity);
2473 Check_Arg_Is_Local_Name (Arg2);
2475 Id := Expression (Arg2);
2478 if not Is_Entity_Name (Id) then
2479 Error_Pragma_Arg ("entity name required", Arg2);
2484 -- Go to renamed subprogram if present, since convention applies to
2485 -- the actual renamed entity, not to the renaming entity. If the
2486 -- subprogram is inherited, go to parent subprogram.
2488 if Is_Subprogram (E)
2489 and then Present (Alias (E))
2491 if Nkind (Parent (Declaration_Node (E))) =
2492 N_Subprogram_Renaming_Declaration
2494 if Scope (E) /= Scope (Alias (E)) then
2496 ("cannot apply pragma% to non-local renaming&#", E);
2500 elsif Nkind (Parent (E)) = N_Full_Type_Declaration
2501 and then Scope (E) = Scope (Alias (E))
2507 -- Check that we are not applying this to a specless body
2509 if Is_Subprogram (E)
2510 and then Nkind (Parent (Declaration_Node (E))) = N_Subprogram_Body
2513 ("pragma% requires separate spec and must come before body");
2516 -- Check that we are not applying this to a named constant
2518 if Ekind (E) = E_Named_Integer
2520 Ekind (E) = E_Named_Real
2522 Error_Msg_Name_1 := Pname;
2524 ("cannot apply pragma% to named constant!",
2525 Get_Pragma_Arg (Arg2));
2527 ("\supply appropriate type for&!", Arg2);
2530 if Ekind (E) = E_Enumeration_Literal then
2531 Error_Pragma ("enumeration literal not allowed for pragma%");
2534 -- Check for rep item appearing too early or too late
2536 if Etype (E) = Any_Type
2537 or else Rep_Item_Too_Early (E, N)
2541 E := Underlying_Type (E);
2544 if Rep_Item_Too_Late (E, N) then
2548 if Has_Convention_Pragma (E) then
2550 ("at most one Convention/Export/Import pragma is allowed", Arg2);
2552 elsif Convention (E) = Convention_Protected
2553 or else Ekind (Scope (E)) = E_Protected_Type
2556 ("a protected operation cannot be given a different convention",
2560 -- For Intrinsic, a subprogram is required
2562 if C = Convention_Intrinsic
2563 and then not Is_Subprogram (E)
2564 and then not Is_Generic_Subprogram (E)
2567 ("second argument of pragma% must be a subprogram", Arg2);
2570 -- For Stdcall, a subprogram, variable or subprogram type is required
2572 if C = Convention_Stdcall
2573 and then not Is_Subprogram (E)
2574 and then not Is_Generic_Subprogram (E)
2575 and then Ekind (E) /= E_Variable
2578 and then Ekind (Designated_Type (E)) = E_Subprogram_Type)
2581 ("second argument of pragma% must be subprogram (type)",
2585 if not Is_Subprogram (E)
2586 and then not Is_Generic_Subprogram (E)
2588 Set_Convention_From_Pragma (E);
2592 Check_First_Subtype (Arg2);
2593 Set_Convention_From_Pragma (Base_Type (E));
2595 -- For subprograms, we must set the convention on the
2596 -- internally generated directly designated type as well.
2598 if Ekind (E) = E_Access_Subprogram_Type then
2599 Set_Convention_From_Pragma (Directly_Designated_Type (E));
2603 -- For the subprogram case, set proper convention for all homonyms
2604 -- in same scope and the same declarative part, i.e. the same
2605 -- compilation unit.
2608 Comp_Unit := Get_Source_Unit (E);
2609 Set_Convention_From_Pragma (E);
2611 -- Treat a pragma Import as an implicit body, for GPS use
2613 if Prag_Id = Pragma_Import then
2614 Generate_Reference (E, Id, 'b');
2620 exit when No (E1) or else Scope (E1) /= Current_Scope;
2622 -- Do not set the pragma on inherited operations or on
2623 -- formal subprograms.
2625 if Comes_From_Source (E1)
2626 and then Comp_Unit = Get_Source_Unit (E1)
2627 and then not Is_Formal_Subprogram (E1)
2628 and then Nkind (Original_Node (Parent (E1))) /=
2629 N_Full_Type_Declaration
2631 if Present (Alias (E1))
2632 and then Scope (E1) /= Scope (Alias (E1))
2635 ("cannot apply pragma% to non-local renaming&#", E1);
2637 Set_Convention_From_Pragma (E1);
2639 if Prag_Id = Pragma_Import then
2640 Generate_Reference (E, Id, 'b');
2645 end Process_Convention;
2647 -----------------------------------------------------
2648 -- Process_Extended_Import_Export_Exception_Pragma --
2649 -----------------------------------------------------
2651 procedure Process_Extended_Import_Export_Exception_Pragma
2652 (Arg_Internal : Node_Id;
2653 Arg_External : Node_Id;
2661 if not OpenVMS_On_Target then
2663 ("?pragma% ignored (applies only to Open'V'M'S)");
2666 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2667 Def_Id := Entity (Arg_Internal);
2669 if Ekind (Def_Id) /= E_Exception then
2671 ("pragma% must refer to declared exception", Arg_Internal);
2674 Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2676 if Present (Arg_Form) then
2677 Check_Arg_Is_One_Of (Arg_Form, Name_Ada, Name_VMS);
2680 if Present (Arg_Form)
2681 and then Chars (Arg_Form) = Name_Ada
2685 Set_Is_VMS_Exception (Def_Id);
2686 Set_Exception_Code (Def_Id, No_Uint);
2689 if Present (Arg_Code) then
2690 if not Is_VMS_Exception (Def_Id) then
2692 ("Code option for pragma% not allowed for Ada case",
2696 Check_Arg_Is_Static_Expression (Arg_Code, Any_Integer);
2697 Code_Val := Expr_Value (Arg_Code);
2699 if not UI_Is_In_Int_Range (Code_Val) then
2701 ("Code option for pragma% must be in 32-bit range",
2705 Set_Exception_Code (Def_Id, Code_Val);
2708 end Process_Extended_Import_Export_Exception_Pragma;
2710 -------------------------------------------------
2711 -- Process_Extended_Import_Export_Internal_Arg --
2712 -------------------------------------------------
2714 procedure Process_Extended_Import_Export_Internal_Arg
2715 (Arg_Internal : Node_Id := Empty)
2718 if No (Arg_Internal) then
2719 Error_Pragma ("Internal parameter required for pragma%");
2722 if Nkind (Arg_Internal) = N_Identifier then
2725 elsif Nkind (Arg_Internal) = N_Operator_Symbol
2726 and then (Prag_Id = Pragma_Import_Function
2728 Prag_Id = Pragma_Export_Function)
2734 ("wrong form for Internal parameter for pragma%", Arg_Internal);
2737 Check_Arg_Is_Local_Name (Arg_Internal);
2738 end Process_Extended_Import_Export_Internal_Arg;
2740 --------------------------------------------------
2741 -- Process_Extended_Import_Export_Object_Pragma --
2742 --------------------------------------------------
2744 procedure Process_Extended_Import_Export_Object_Pragma
2745 (Arg_Internal : Node_Id;
2746 Arg_External : Node_Id;
2752 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2753 Def_Id := Entity (Arg_Internal);
2755 if Ekind (Def_Id) /= E_Constant
2756 and then Ekind (Def_Id) /= E_Variable
2759 ("pragma% must designate an object", Arg_Internal);
2762 if Has_Rep_Pragma (Def_Id, Name_Common_Object)
2764 Has_Rep_Pragma (Def_Id, Name_Psect_Object)
2767 ("previous Common/Psect_Object applies, pragma % not permitted",
2771 if Rep_Item_Too_Late (Def_Id, N) then
2775 Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2777 if Present (Arg_Size) then
2778 Check_Arg_Is_External_Name (Arg_Size);
2781 -- Export_Object case
2783 if Prag_Id = Pragma_Export_Object then
2784 if not Is_Library_Level_Entity (Def_Id) then
2786 ("argument for pragma% must be library level entity",
2790 if Ekind (Current_Scope) = E_Generic_Package then
2791 Error_Pragma ("pragma& cannot appear in a generic unit");
2794 if not Size_Known_At_Compile_Time (Etype (Def_Id)) then
2796 ("exported object must have compile time known size",
2800 if Warn_On_Export_Import and then Is_Exported (Def_Id) then
2802 ("?duplicate Export_Object pragma", N);
2804 Set_Exported (Def_Id, Arg_Internal);
2807 -- Import_Object case
2810 if Is_Concurrent_Type (Etype (Def_Id)) then
2812 ("cannot use pragma% for task/protected object",
2816 if Ekind (Def_Id) = E_Constant then
2818 ("cannot import a constant", Arg_Internal);
2821 if Warn_On_Export_Import
2822 and then Has_Discriminants (Etype (Def_Id))
2825 ("imported value must be initialized?", Arg_Internal);
2828 if Warn_On_Export_Import
2829 and then Is_Access_Type (Etype (Def_Id))
2832 ("cannot import object of an access type?", Arg_Internal);
2835 if Warn_On_Export_Import
2836 and then Is_Imported (Def_Id)
2839 ("?duplicate Import_Object pragma", N);
2841 -- Check for explicit initialization present. Note that an
2842 -- initialization that generated by the code generator, e.g.
2843 -- for an access type, does not count here.
2845 elsif Present (Expression (Parent (Def_Id)))
2848 (Original_Node (Expression (Parent (Def_Id))))
2850 Error_Msg_Sloc := Sloc (Def_Id);
2852 ("imported entities cannot be initialized (RM B.1(24))",
2853 "\no initialization allowed for & declared#", Arg1);
2855 Set_Imported (Def_Id);
2856 Note_Possible_Modification (Arg_Internal, Sure => False);
2859 end Process_Extended_Import_Export_Object_Pragma;
2861 ------------------------------------------------------
2862 -- Process_Extended_Import_Export_Subprogram_Pragma --
2863 ------------------------------------------------------
2865 procedure Process_Extended_Import_Export_Subprogram_Pragma
2866 (Arg_Internal : Node_Id;
2867 Arg_External : Node_Id;
2868 Arg_Parameter_Types : Node_Id;
2869 Arg_Result_Type : Node_Id := Empty;
2870 Arg_Mechanism : Node_Id;
2871 Arg_Result_Mechanism : Node_Id := Empty;
2872 Arg_First_Optional_Parameter : Node_Id := Empty)
2878 Ambiguous : Boolean;
2882 function Same_Base_Type
2884 Formal : Entity_Id) return Boolean;
2885 -- Determines if Ptype references the type of Formal. Note that
2886 -- only the base types need to match according to the spec. Ptype
2887 -- here is the argument from the pragma, which is either a type
2888 -- name, or an access attribute.
2890 --------------------
2891 -- Same_Base_Type --
2892 --------------------
2894 function Same_Base_Type
2896 Formal : Entity_Id) return Boolean
2898 Ftyp : constant Entity_Id := Base_Type (Etype (Formal));
2902 -- Case where pragma argument is typ'Access
2904 if Nkind (Ptype) = N_Attribute_Reference
2905 and then Attribute_Name (Ptype) = Name_Access
2907 Pref := Prefix (Ptype);
2910 if not Is_Entity_Name (Pref)
2911 or else Entity (Pref) = Any_Type
2916 -- We have a match if the corresponding argument is of an
2917 -- anonymous access type, and its designated type matches
2918 -- the type of the prefix of the access attribute
2920 return Ekind (Ftyp) = E_Anonymous_Access_Type
2921 and then Base_Type (Entity (Pref)) =
2922 Base_Type (Etype (Designated_Type (Ftyp)));
2924 -- Case where pragma argument is a type name
2929 if not Is_Entity_Name (Ptype)
2930 or else Entity (Ptype) = Any_Type
2935 -- We have a match if the corresponding argument is of
2936 -- the type given in the pragma (comparing base types)
2938 return Base_Type (Entity (Ptype)) = Ftyp;
2942 -- Start of processing for
2943 -- Process_Extended_Import_Export_Subprogram_Pragma
2946 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2950 -- Loop through homonyms (overloadings) of the entity
2952 Hom_Id := Entity (Arg_Internal);
2953 while Present (Hom_Id) loop
2954 Def_Id := Get_Base_Subprogram (Hom_Id);
2956 -- We need a subprogram in the current scope
2958 if not Is_Subprogram (Def_Id)
2959 or else Scope (Def_Id) /= Current_Scope
2966 -- Pragma cannot apply to subprogram body
2968 if Is_Subprogram (Def_Id)
2971 (Declaration_Node (Def_Id))) = N_Subprogram_Body
2974 ("pragma% requires separate spec"
2975 & " and must come before body");
2978 -- Test result type if given, note that the result type
2979 -- parameter can only be present for the function cases.
2981 if Present (Arg_Result_Type)
2982 and then not Same_Base_Type (Arg_Result_Type, Def_Id)
2986 elsif Etype (Def_Id) /= Standard_Void_Type
2988 (Pname = Name_Export_Procedure
2990 Pname = Name_Import_Procedure)
2994 -- Test parameter types if given. Note that this parameter
2995 -- has not been analyzed (and must not be, since it is
2996 -- semantic nonsense), so we get it as the parser left it.
2998 elsif Present (Arg_Parameter_Types) then
2999 Check_Matching_Types : declare
3004 Formal := First_Formal (Def_Id);
3006 if Nkind (Arg_Parameter_Types) = N_Null then
3007 if Present (Formal) then
3011 -- A list of one type, e.g. (List) is parsed as
3012 -- a parenthesized expression.
3014 elsif Nkind (Arg_Parameter_Types) /= N_Aggregate
3015 and then Paren_Count (Arg_Parameter_Types) = 1
3018 or else Present (Next_Formal (Formal))
3023 Same_Base_Type (Arg_Parameter_Types, Formal);
3026 -- A list of more than one type is parsed as a aggregate
3028 elsif Nkind (Arg_Parameter_Types) = N_Aggregate
3029 and then Paren_Count (Arg_Parameter_Types) = 0
3031 Ptype := First (Expressions (Arg_Parameter_Types));
3032 while Present (Ptype) or else Present (Formal) loop
3035 or else not Same_Base_Type (Ptype, Formal)
3040 Next_Formal (Formal);
3045 -- Anything else is of the wrong form
3049 ("wrong form for Parameter_Types parameter",
3050 Arg_Parameter_Types);
3052 end Check_Matching_Types;
3055 -- Match is now False if the entry we found did not match
3056 -- either a supplied Parameter_Types or Result_Types argument
3062 -- Ambiguous case, the flag Ambiguous shows if we already
3063 -- detected this and output the initial messages.
3066 if not Ambiguous then
3068 Error_Msg_Name_1 := Pname;
3070 ("pragma% does not uniquely identify subprogram!",
3072 Error_Msg_Sloc := Sloc (Ent);
3073 Error_Msg_N ("matching subprogram #!", N);
3077 Error_Msg_Sloc := Sloc (Def_Id);
3078 Error_Msg_N ("matching subprogram #!", N);
3083 Hom_Id := Homonym (Hom_Id);
3086 -- See if we found an entry
3089 if not Ambiguous then
3090 if Is_Generic_Subprogram (Entity (Arg_Internal)) then
3092 ("pragma% cannot be given for generic subprogram");
3095 ("pragma% does not identify local subprogram");
3102 -- Import pragmas must be be for imported entities
3104 if Prag_Id = Pragma_Import_Function
3106 Prag_Id = Pragma_Import_Procedure
3108 Prag_Id = Pragma_Import_Valued_Procedure
3110 if not Is_Imported (Ent) then
3112 ("pragma Import or Interface must precede pragma%");
3115 -- Here we have the Export case which can set the entity as exported
3117 -- But does not do so if the specified external name is null, since
3118 -- that is taken as a signal in DEC Ada 83 (with which we want to be
3119 -- compatible) to request no external name.
3121 elsif Nkind (Arg_External) = N_String_Literal
3122 and then String_Length (Strval (Arg_External)) = 0
3126 -- In all other cases, set entity as exported
3129 Set_Exported (Ent, Arg_Internal);
3132 -- Special processing for Valued_Procedure cases
3134 if Prag_Id = Pragma_Import_Valued_Procedure
3136 Prag_Id = Pragma_Export_Valued_Procedure
3138 Formal := First_Formal (Ent);
3142 ("at least one parameter required for pragma%");
3144 elsif Ekind (Formal) /= E_Out_Parameter then
3146 ("first parameter must have mode out for pragma%");
3149 Set_Is_Valued_Procedure (Ent);
3153 Set_Extended_Import_Export_External_Name (Ent, Arg_External);
3155 -- Process Result_Mechanism argument if present. We have already
3156 -- checked that this is only allowed for the function case.
3158 if Present (Arg_Result_Mechanism) then
3159 Set_Mechanism_Value (Ent, Arg_Result_Mechanism);
3162 -- Process Mechanism parameter if present. Note that this parameter
3163 -- is not analyzed, and must not be analyzed since it is semantic
3164 -- nonsense, so we get it in exactly as the parser left it.
3166 if Present (Arg_Mechanism) then
3174 -- A single mechanism association without a formal parameter
3175 -- name is parsed as a parenthesized expression. All other
3176 -- cases are parsed as aggregates, so we rewrite the single
3177 -- parameter case as an aggregate for consistency.
3179 if Nkind (Arg_Mechanism) /= N_Aggregate
3180 and then Paren_Count (Arg_Mechanism) = 1
3182 Rewrite (Arg_Mechanism,
3183 Make_Aggregate (Sloc (Arg_Mechanism),
3184 Expressions => New_List (
3185 Relocate_Node (Arg_Mechanism))));
3188 -- Case of only mechanism name given, applies to all formals
3190 if Nkind (Arg_Mechanism) /= N_Aggregate then
3191 Formal := First_Formal (Ent);
3192 while Present (Formal) loop
3193 Set_Mechanism_Value (Formal, Arg_Mechanism);
3194 Next_Formal (Formal);
3197 -- Case of list of mechanism associations given
3200 if Null_Record_Present (Arg_Mechanism) then
3202 ("inappropriate form for Mechanism parameter",
3206 -- Deal with positional ones first
3208 Formal := First_Formal (Ent);
3210 if Present (Expressions (Arg_Mechanism)) then
3211 Mname := First (Expressions (Arg_Mechanism));
3212 while Present (Mname) loop
3215 ("too many mechanism associations", Mname);
3218 Set_Mechanism_Value (Formal, Mname);
3219 Next_Formal (Formal);
3224 -- Deal with named entries
3226 if Present (Component_Associations (Arg_Mechanism)) then
3227 Massoc := First (Component_Associations (Arg_Mechanism));
3228 while Present (Massoc) loop
3229 Choice := First (Choices (Massoc));
3231 if Nkind (Choice) /= N_Identifier
3232 or else Present (Next (Choice))
3235 ("incorrect form for mechanism association",
3239 Formal := First_Formal (Ent);
3243 ("parameter name & not present", Choice);
3246 if Chars (Choice) = Chars (Formal) then
3248 (Formal, Expression (Massoc));
3250 -- Set entity on identifier for ASIS
3252 Set_Entity (Choice, Formal);
3257 Next_Formal (Formal);
3267 -- Process First_Optional_Parameter argument if present. We have
3268 -- already checked that this is only allowed for the Import case.
3270 if Present (Arg_First_Optional_Parameter) then
3271 if Nkind (Arg_First_Optional_Parameter) /= N_Identifier then
3273 ("first optional parameter must be formal parameter name",
3274 Arg_First_Optional_Parameter);
3277 Formal := First_Formal (Ent);
3281 ("specified formal parameter& not found",
3282 Arg_First_Optional_Parameter);
3285 exit when Chars (Formal) =
3286 Chars (Arg_First_Optional_Parameter);
3288 Next_Formal (Formal);
3291 Set_First_Optional_Parameter (Ent, Formal);
3293 -- Check specified and all remaining formals have right form
3295 while Present (Formal) loop
3296 if Ekind (Formal) /= E_In_Parameter then
3298 ("optional formal& is not of mode in!",
3299 Arg_First_Optional_Parameter, Formal);
3302 Dval := Default_Value (Formal);
3306 ("optional formal& does not have default value!",
3307 Arg_First_Optional_Parameter, Formal);
3309 elsif Compile_Time_Known_Value_Or_Aggr (Dval) then
3314 ("default value for optional formal& is non-static!",
3315 Arg_First_Optional_Parameter, Formal);
3319 Set_Is_Optional_Parameter (Formal);
3320 Next_Formal (Formal);
3323 end Process_Extended_Import_Export_Subprogram_Pragma;
3325 --------------------------
3326 -- Process_Generic_List --
3327 --------------------------
3329 procedure Process_Generic_List is
3334 Check_No_Identifiers;
3335 Check_At_Least_N_Arguments (1);
3338 while Present (Arg) loop
3339 Exp := Expression (Arg);
3342 if not Is_Entity_Name (Exp)
3344 (not Is_Generic_Instance (Entity (Exp))
3346 not Is_Generic_Unit (Entity (Exp)))
3349 ("pragma% argument must be name of generic unit/instance",
3355 end Process_Generic_List;
3357 ---------------------------------
3358 -- Process_Import_Or_Interface --
3359 ---------------------------------
3361 procedure Process_Import_Or_Interface is
3367 Process_Convention (C, Def_Id);
3368 Kill_Size_Check_Code (Def_Id);
3369 Note_Possible_Modification (Expression (Arg2), Sure => False);
3371 if Ekind (Def_Id) = E_Variable
3373 Ekind (Def_Id) = E_Constant
3375 -- We do not permit Import to apply to a renaming declaration
3377 if Present (Renamed_Object (Def_Id)) then
3379 ("pragma% not allowed for object renaming", Arg2);
3381 -- User initialization is not allowed for imported object, but
3382 -- the object declaration may contain a default initialization,
3383 -- that will be discarded. Note that an explicit initialization
3384 -- only counts if it comes from source, otherwise it is simply
3385 -- the code generator making an implicit initialization explicit.
3387 elsif Present (Expression (Parent (Def_Id)))
3388 and then Comes_From_Source (Expression (Parent (Def_Id)))
3390 Error_Msg_Sloc := Sloc (Def_Id);
3392 ("no initialization allowed for declaration of& #",
3393 "\imported entities cannot be initialized (RM B.1(24))",
3397 Set_Imported (Def_Id);
3398 Process_Interface_Name (Def_Id, Arg3, Arg4);
3400 -- Note that we do not set Is_Public here. That's because we
3401 -- only want to set if if there is no address clause, and we
3402 -- don't know that yet, so we delay that processing till
3405 -- pragma Import completes deferred constants
3407 if Ekind (Def_Id) = E_Constant then
3408 Set_Has_Completion (Def_Id);
3411 -- It is not possible to import a constant of an unconstrained
3412 -- array type (e.g. string) because there is no simple way to
3413 -- write a meaningful subtype for it.
3415 if Is_Array_Type (Etype (Def_Id))
3416 and then not Is_Constrained (Etype (Def_Id))
3419 ("imported constant& must have a constrained subtype",
3424 elsif Is_Subprogram (Def_Id)
3425 or else Is_Generic_Subprogram (Def_Id)
3427 -- If the name is overloaded, pragma applies to all of the
3428 -- denoted entities in the same declarative part.
3431 while Present (Hom_Id) loop
3432 Def_Id := Get_Base_Subprogram (Hom_Id);
3434 -- Ignore inherited subprograms because the pragma will
3435 -- apply to the parent operation, which is the one called.
3437 if Is_Overloadable (Def_Id)
3438 and then Present (Alias (Def_Id))
3442 -- If it is not a subprogram, it must be in an outer
3443 -- scope and pragma does not apply.
3445 elsif not Is_Subprogram (Def_Id)
3446 and then not Is_Generic_Subprogram (Def_Id)
3450 -- Verify that the homonym is in the same declarative
3451 -- part (not just the same scope).
3453 elsif Parent (Unit_Declaration_Node (Def_Id)) /= Parent (N)
3454 and then Nkind (Parent (N)) /= N_Compilation_Unit_Aux
3459 Set_Imported (Def_Id);
3461 -- Special processing for Convention_Intrinsic
3463 if C = Convention_Intrinsic then
3465 -- Link_Name argument not allowed for intrinsic
3468 and then Chars (Arg3) = Name_Link_Name
3473 if Present (Arg4) then
3475 ("Link_Name argument not allowed for " &
3480 Set_Is_Intrinsic_Subprogram (Def_Id);
3482 -- If no external name is present, then check that
3483 -- this is a valid intrinsic subprogram. If an external
3484 -- name is present, then this is handled by the back end.
3487 Check_Intrinsic_Subprogram (Def_Id, Expression (Arg2));
3491 -- All interfaced procedures need an external symbol
3492 -- created for them since they are always referenced
3493 -- from another object file.
3495 Set_Is_Public (Def_Id);
3497 -- Verify that the subprogram does not have a completion
3498 -- through a renaming declaration. For other completions
3499 -- the pragma appears as a too late representation.
3502 Decl : constant Node_Id := Unit_Declaration_Node (Def_Id);
3506 and then Nkind (Decl) = N_Subprogram_Declaration
3507 and then Present (Corresponding_Body (Decl))
3510 (Unit_Declaration_Node
3511 (Corresponding_Body (Decl))) =
3512 N_Subprogram_Renaming_Declaration
3514 Error_Msg_Sloc := Sloc (Def_Id);
3516 ("cannot import&, renaming already provided for " &
3517 "declaration #", N, Def_Id);
3521 Set_Has_Completion (Def_Id);
3522 Process_Interface_Name (Def_Id, Arg3, Arg4);
3525 if Is_Compilation_Unit (Hom_Id) then
3527 -- Its possible homonyms are not affected by the pragma.
3528 -- Such homonyms might be present in the context of other
3529 -- units being compiled.
3534 Hom_Id := Homonym (Hom_Id);
3538 -- When the convention is Java or CIL, we also allow Import to be
3539 -- given for packages, generic packages, exceptions, and record
3542 elsif (C = Convention_Java or else C = Convention_CIL)
3544 (Ekind (Def_Id) = E_Package
3545 or else Ekind (Def_Id) = E_Generic_Package
3546 or else Ekind (Def_Id) = E_Exception
3547 or else Nkind (Parent (Def_Id)) = N_Component_Declaration)
3549 Set_Imported (Def_Id);
3550 Set_Is_Public (Def_Id);
3551 Process_Interface_Name (Def_Id, Arg3, Arg4);
3553 -- Import a CPP class
3555 elsif Is_Record_Type (Def_Id)
3556 and then C = Convention_CPP
3558 if not Is_Tagged_Type (Def_Id) then
3559 Error_Msg_Sloc := Sloc (Def_Id);
3560 Error_Pragma_Arg ("imported 'C'P'P type must be tagged", Arg2);
3563 -- Types treated as CPP classes are treated as limited, but we
3564 -- don't require them to be declared this way. A warning is
3565 -- issued to encourage the user to declare them as limited.
3566 -- This is not an error, for compatibility reasons, because
3567 -- these types have been supported this way for some time.
3569 if not Is_Limited_Type (Def_Id) then
3571 ("imported 'C'P'P type should be " &
3572 "explicitly declared limited?",
3573 Get_Pragma_Arg (Arg2));
3575 ("\type will be considered limited",
3576 Get_Pragma_Arg (Arg2));
3579 Set_Is_CPP_Class (Def_Id);
3580 Set_Is_Limited_Record (Def_Id);
3585 ("second argument of pragma% must be object or subprogram",
3589 -- If this pragma applies to a compilation unit, then the unit,
3590 -- which is a subprogram, does not require (or allow) a body.
3591 -- We also do not need to elaborate imported procedures.
3593 if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
3595 Cunit : constant Node_Id := Parent (Parent (N));
3597 Set_Body_Required (Cunit, False);
3600 end Process_Import_Or_Interface;
3602 --------------------
3603 -- Process_Inline --
3604 --------------------
3606 procedure Process_Inline (Active : Boolean) is
3612 Effective : Boolean := False;
3614 procedure Make_Inline (Subp : Entity_Id);
3615 -- Subp is the defining unit name of the subprogram
3616 -- declaration. Set the flag, as well as the flag in the
3617 -- corresponding body, if there is one present.
3619 procedure Set_Inline_Flags (Subp : Entity_Id);
3620 -- Sets Is_Inlined and Has_Pragma_Inline flags for Subp and also
3621 -- Has_Pragma_Inline_Always for the Inline_Always case.
3623 function Inlining_Not_Possible (Subp : Entity_Id) return Boolean;
3624 -- Returns True if it can be determined at this stage that inlining
3625 -- is not possible, for example if the body is available and contains
3626 -- exception handlers, we prevent inlining, since otherwise we can
3627 -- get undefined symbols at link time. This function also emits a
3628 -- warning if front-end inlining is enabled and the pragma appears
3631 -- ??? is business with link symbols still valid, or does it relate
3632 -- to front end ZCX which is being phased out ???
3634 ---------------------------
3635 -- Inlining_Not_Possible --
3636 ---------------------------
3638 function Inlining_Not_Possible (Subp : Entity_Id) return Boolean is
3639 Decl : constant Node_Id := Unit_Declaration_Node (Subp);
3643 if Nkind (Decl) = N_Subprogram_Body then
3644 Stats := Handled_Statement_Sequence (Decl);
3645 return Present (Exception_Handlers (Stats))
3646 or else Present (At_End_Proc (Stats));
3648 elsif Nkind (Decl) = N_Subprogram_Declaration
3649 and then Present (Corresponding_Body (Decl))
3651 if Front_End_Inlining
3652 and then Analyzed (Corresponding_Body (Decl))
3654 Error_Msg_N ("pragma appears too late, ignored?", N);
3657 -- If the subprogram is a renaming as body, the body is
3658 -- just a call to the renamed subprogram, and inlining is
3659 -- trivially possible.
3662 Nkind (Unit_Declaration_Node (Corresponding_Body (Decl))) =
3663 N_Subprogram_Renaming_Declaration
3669 Handled_Statement_Sequence
3670 (Unit_Declaration_Node (Corresponding_Body (Decl)));
3673 Present (Exception_Handlers (Stats))
3674 or else Present (At_End_Proc (Stats));
3678 -- If body is not available, assume the best, the check is
3679 -- performed again when compiling enclosing package bodies.
3683 end Inlining_Not_Possible;
3689 procedure Make_Inline (Subp : Entity_Id) is
3690 Kind : constant Entity_Kind := Ekind (Subp);
3691 Inner_Subp : Entity_Id := Subp;
3694 -- Ignore if bad type, avoid cascaded error
3696 if Etype (Subp) = Any_Type then
3700 -- Ignore if all inlining is suppressed
3702 elsif Suppress_All_Inlining then
3706 -- If inlining is not possible, for now do not treat as an error
3708 elsif Inlining_Not_Possible (Subp) then
3712 -- Here we have a candidate for inlining, but we must exclude
3713 -- derived operations. Otherwise we would end up trying to inline
3714 -- a phantom declaration, and the result would be to drag in a
3715 -- body which has no direct inlining associated with it. That
3716 -- would not only be inefficient but would also result in the
3717 -- backend doing cross-unit inlining in cases where it was
3718 -- definitely inappropriate to do so.
3720 -- However, a simple Comes_From_Source test is insufficient, since
3721 -- we do want to allow inlining of generic instances which also do
3722 -- not come from source. We also need to recognize specs
3723 -- generated by the front-end for bodies that carry the pragma.
3724 -- Finally, predefined operators do not come from source but are
3725 -- not inlineable either.
3727 elsif Is_Generic_Instance (Subp)
3728 or else Nkind (Parent (Parent (Subp))) = N_Subprogram_Declaration
3732 elsif not Comes_From_Source (Subp)
3733 and then Scope (Subp) /= Standard_Standard
3739 -- The referenced entity must either be the enclosing entity,
3740 -- or an entity declared within the current open scope.
3742 if Present (Scope (Subp))
3743 and then Scope (Subp) /= Current_Scope
3744 and then Subp /= Current_Scope
3747 ("argument of% must be entity in current scope", Assoc);
3751 -- Processing for procedure, operator or function.
3752 -- If subprogram is aliased (as for an instance) indicate
3753 -- that the renamed entity (if declared in the same unit)
3756 if Is_Subprogram (Subp) then
3757 while Present (Alias (Inner_Subp)) loop
3758 Inner_Subp := Alias (Inner_Subp);
3761 if In_Same_Source_Unit (Subp, Inner_Subp) then
3762 Set_Inline_Flags (Inner_Subp);
3764 Decl := Parent (Parent (Inner_Subp));
3766 if Nkind (Decl) = N_Subprogram_Declaration
3767 and then Present (Corresponding_Body (Decl))
3769 Set_Inline_Flags (Corresponding_Body (Decl));
3771 elsif Is_Generic_Instance (Subp) then
3773 -- Indicate that the body needs to be created for
3774 -- inlining subsequent calls. The instantiation
3775 -- node follows the declaration of the wrapper
3776 -- package created for it.
3778 if Scope (Subp) /= Standard_Standard
3780 Need_Subprogram_Instance_Body
3781 (Next (Unit_Declaration_Node (Scope (Alias (Subp)))),
3791 -- For a generic subprogram set flag as well, for use at
3792 -- the point of instantiation, to determine whether the
3793 -- body should be generated.
3795 elsif Is_Generic_Subprogram (Subp) then
3796 Set_Inline_Flags (Subp);
3799 -- Literals are by definition inlined
3801 elsif Kind = E_Enumeration_Literal then
3804 -- Anything else is an error
3808 ("expect subprogram name for pragma%", Assoc);
3812 ----------------------
3813 -- Set_Inline_Flags --
3814 ----------------------
3816 procedure Set_Inline_Flags (Subp : Entity_Id) is
3819 Set_Is_Inlined (Subp, True);
3822 if not Has_Pragma_Inline (Subp) then
3823 Set_Has_Pragma_Inline (Subp);
3827 if Prag_Id = Pragma_Inline_Always then
3828 Set_Has_Pragma_Inline_Always (Subp);
3830 end Set_Inline_Flags;
3832 -- Start of processing for Process_Inline
3835 Check_No_Identifiers;
3836 Check_At_Least_N_Arguments (1);
3839 Inline_Processing_Required := True;
3843 while Present (Assoc) loop
3844 Subp_Id := Expression (Assoc);
3848 if Is_Entity_Name (Subp_Id) then
3849 Subp := Entity (Subp_Id);
3851 if Subp = Any_Id then
3853 -- If previous error, avoid cascaded errors
3861 while Present (Homonym (Subp))
3862 and then Scope (Homonym (Subp)) = Current_Scope
3864 Make_Inline (Homonym (Subp));
3865 Subp := Homonym (Subp);
3872 ("inappropriate argument for pragma%", Assoc);
3875 and then Warn_On_Redundant_Constructs
3876 and then not Suppress_All_Inlining
3878 if Inlining_Not_Possible (Subp) then
3880 ("pragma Inline for& is ignored?", N, Entity (Subp_Id));
3883 ("pragma Inline for& is redundant?", N, Entity (Subp_Id));
3891 ----------------------------
3892 -- Process_Interface_Name --
3893 ----------------------------
3895 procedure Process_Interface_Name
3896 (Subprogram_Def : Entity_Id;
3902 String_Val : String_Id;
3904 procedure Check_Form_Of_Interface_Name
3906 Ext_Name_Case : Boolean);
3907 -- SN is a string literal node for an interface name. This routine
3908 -- performs some minimal checks that the name is reasonable. In
3909 -- particular that no spaces or other obviously incorrect characters
3910 -- appear. This is only a warning, since any characters are allowed.
3911 -- Ext_Name_Case is True for an External_Name, False for a Link_Name.
3913 ----------------------------------
3914 -- Check_Form_Of_Interface_Name --
3915 ----------------------------------
3917 procedure Check_Form_Of_Interface_Name
3919 Ext_Name_Case : Boolean)
3921 S : constant String_Id := Strval (Expr_Value_S (SN));
3922 SL : constant Nat := String_Length (S);
3927 Error_Msg_N ("interface name cannot be null string", SN);
3930 for J in 1 .. SL loop
3931 C := Get_String_Char (S, J);
3933 -- Look for dubious character and issue unconditional warning.
3934 -- Definitely dubious if not in character range.
3936 if not In_Character_Range (C)
3940 or else Get_Character (C) = ','
3942 -- For all cases except link names on a CLI target, spaces
3943 -- and slashes are also dubious (in CLI for link names, we
3944 -- use spaces and possibly slashes for special purposes).
3946 -- Where is this usage documented ???
3948 or else ((Ext_Name_Case or else VM_Target /= CLI_Target)
3949 and then (Get_Character (C) = ' '
3951 Get_Character (C) = '/'
3953 Get_Character (C) = '\'))
3956 ("?interface name contains illegal character",
3957 Sloc (SN) + Source_Ptr (J));
3960 end Check_Form_Of_Interface_Name;
3962 -- Start of processing for Process_Interface_Name
3965 if No (Link_Arg) then
3966 if No (Ext_Arg) then
3967 if VM_Target = CLI_Target
3968 and then Ekind (Subprogram_Def) = E_Package
3969 and then Nkind (Parent (Subprogram_Def)) =
3970 N_Package_Specification
3971 and then Present (Generic_Parent (Parent (Subprogram_Def)))
3976 (Generic_Parent (Parent (Subprogram_Def))));
3981 elsif Chars (Ext_Arg) = Name_Link_Name then
3983 Link_Nam := Expression (Ext_Arg);
3986 Check_Optional_Identifier (Ext_Arg, Name_External_Name);
3987 Ext_Nam := Expression (Ext_Arg);
3992 Check_Optional_Identifier (Ext_Arg, Name_External_Name);
3993 Check_Optional_Identifier (Link_Arg, Name_Link_Name);
3994 Ext_Nam := Expression (Ext_Arg);
3995 Link_Nam := Expression (Link_Arg);
3998 -- Check expressions for external name and link name are static
4000 if Present (Ext_Nam) then
4001 Check_Arg_Is_Static_Expression (Ext_Nam, Standard_String);
4002 Check_Form_Of_Interface_Name (Ext_Nam, Ext_Name_Case => True);
4004 -- Verify that external name is not the name of a local entity,
4005 -- which would hide the imported one and could lead to run-time
4006 -- surprises. The problem can only arise for entities declared in
4007 -- a package body (otherwise the external name is fully qualified
4008 -- and will not conflict).
4016 if Prag_Id = Pragma_Import then
4017 String_To_Name_Buffer (Strval (Expr_Value_S (Ext_Nam)));
4019 E := Entity_Id (Get_Name_Table_Info (Nam));
4021 if Nam /= Chars (Subprogram_Def)
4022 and then Present (E)
4023 and then not Is_Overloadable (E)
4024 and then Is_Immediately_Visible (E)
4025 and then not Is_Imported (E)
4026 and then Ekind (Scope (E)) = E_Package
4029 while Present (Par) loop
4030 if Nkind (Par) = N_Package_Body then
4031 Error_Msg_Sloc := Sloc (E);
4033 ("imported entity is hidden by & declared#",
4038 Par := Parent (Par);
4045 if Present (Link_Nam) then
4046 Check_Arg_Is_Static_Expression (Link_Nam, Standard_String);
4047 Check_Form_Of_Interface_Name (Link_Nam, Ext_Name_Case => False);
4050 -- If there is no link name, just set the external name
4052 if No (Link_Nam) then
4053 Link_Nam := Adjust_External_Name_Case (Expr_Value_S (Ext_Nam));
4055 -- For the Link_Name case, the given literal is preceded by an
4056 -- asterisk, which indicates to GCC that the given name should
4057 -- be taken literally, and in particular that no prepending of
4058 -- underlines should occur, even in systems where this is the
4064 if VM_Target = No_VM then
4065 Store_String_Char (Get_Char_Code ('*'));
4068 String_Val := Strval (Expr_Value_S (Link_Nam));
4069 Store_String_Chars (String_Val);
4071 Make_String_Literal (Sloc (Link_Nam),
4072 Strval => End_String);
4075 Set_Encoded_Interface_Name
4076 (Get_Base_Subprogram (Subprogram_Def), Link_Nam);
4077 Check_Duplicated_Export_Name (Link_Nam);
4078 end Process_Interface_Name;
4080 -----------------------------------------
4081 -- Process_Interrupt_Or_Attach_Handler --
4082 -----------------------------------------
4084 procedure Process_Interrupt_Or_Attach_Handler is
4085 Arg1_X : constant Node_Id := Expression (Arg1);
4086 Handler_Proc : constant Entity_Id := Entity (Arg1_X);
4087 Proc_Scope : constant Entity_Id := Scope (Handler_Proc);
4090 Set_Is_Interrupt_Handler (Handler_Proc);
4092 -- If the pragma is not associated with a handler procedure
4093 -- within a protected type, then it must be for a nonprotected
4094 -- procedure for the AAMP target, in which case we don't
4095 -- associate a representation item with the procedure's scope.
4097 if Ekind (Proc_Scope) = E_Protected_Type then
4098 if Prag_Id = Pragma_Interrupt_Handler
4100 Prag_Id = Pragma_Attach_Handler
4102 Record_Rep_Item (Proc_Scope, N);
4105 end Process_Interrupt_Or_Attach_Handler;
4107 --------------------------------------------------
4108 -- Process_Restrictions_Or_Restriction_Warnings --
4109 --------------------------------------------------
4111 -- Note: some of the simple identifier cases were handled in par-prag,
4112 -- but it is harmless (and more straightforward) to simply handle all
4113 -- cases here, even if it means we repeat a bit of work in some cases.
4115 procedure Process_Restrictions_Or_Restriction_Warnings
4119 R_Id : Restriction_Id;
4124 procedure Check_Unit_Name (N : Node_Id);
4125 -- Checks unit name parameter for No_Dependence. Returns if it has
4126 -- an appropriate form, otherwise raises pragma argument error.
4128 ---------------------
4129 -- Check_Unit_Name --
4130 ---------------------
4132 procedure Check_Unit_Name (N : Node_Id) is
4134 if Nkind (N) = N_Selected_Component then
4135 Check_Unit_Name (Prefix (N));
4136 Check_Unit_Name (Selector_Name (N));
4138 elsif Nkind (N) = N_Identifier then
4143 ("wrong form for unit name for No_Dependence", N);
4145 end Check_Unit_Name;
4147 -- Start of processing for Process_Restrictions_Or_Restriction_Warnings
4150 Check_Ada_83_Warning;
4151 Check_At_Least_N_Arguments (1);
4152 Check_Valid_Configuration_Pragma;
4155 while Present (Arg) loop
4157 Expr := Expression (Arg);
4159 -- Case of no restriction identifier present
4161 if Id = No_Name then
4162 if Nkind (Expr) /= N_Identifier then
4164 ("invalid form for restriction", Arg);
4169 (Process_Restriction_Synonyms (Expr));
4171 if R_Id not in All_Boolean_Restrictions then
4172 Error_Msg_Name_1 := Pname;
4174 ("invalid restriction identifier&", Get_Pragma_Arg (Arg));
4176 -- Check for possible misspelling
4178 for J in Restriction_Id loop
4180 Rnm : constant String := Restriction_Id'Image (J);
4183 Name_Buffer (1 .. Rnm'Length) := Rnm;
4184 Name_Len := Rnm'Length;
4185 Set_Casing (All_Lower_Case);
4187 if Is_Bad_Spelling_Of (Chars (Expr), Name_Enter) then
4189 (Identifier_Casing (Current_Source_File));
4190 Error_Msg_String (1 .. Rnm'Length) :=
4191 Name_Buffer (1 .. Name_Len);
4192 Error_Msg_Strlen := Rnm'Length;
4194 ("\possible misspelling of ""~""",
4195 Get_Pragma_Arg (Arg));
4204 if Implementation_Restriction (R_Id) then
4205 Check_Restriction (No_Implementation_Restrictions, Arg);
4208 -- If this is a warning, then set the warning unless we already
4209 -- have a real restriction active (we never want a warning to
4210 -- override a real restriction).
4213 if not Restriction_Active (R_Id) then
4214 Set_Restriction (R_Id, N);
4215 Restriction_Warnings (R_Id) := True;
4218 -- If real restriction case, then set it and make sure that the
4219 -- restriction warning flag is off, since a real restriction
4220 -- always overrides a warning.
4223 Set_Restriction (R_Id, N);
4224 Restriction_Warnings (R_Id) := False;
4227 -- A very special case that must be processed here: pragma
4228 -- Restrictions (No_Exceptions) turns off all run-time
4229 -- checking. This is a bit dubious in terms of the formal
4230 -- language definition, but it is what is intended by RM
4231 -- H.4(12). Restriction_Warnings never affects generated code
4232 -- so this is done only in the real restriction case.
4234 if R_Id = No_Exceptions and then not Warn then
4235 Scope_Suppress := (others => True);
4238 -- Case of No_Dependence => unit-name. Note that the parser
4239 -- already made the necessary entry in the No_Dependence table.
4241 elsif Id = Name_No_Dependence then
4242 Check_Unit_Name (Expr);
4244 -- All other cases of restriction identifier present
4247 R_Id := Get_Restriction_Id (Process_Restriction_Synonyms (Arg));
4248 Analyze_And_Resolve (Expr, Any_Integer);
4250 if R_Id not in All_Parameter_Restrictions then
4252 ("invalid restriction parameter identifier", Arg);
4254 elsif not Is_OK_Static_Expression (Expr) then
4255 Flag_Non_Static_Expr
4256 ("value must be static expression!", Expr);
4259 elsif not Is_Integer_Type (Etype (Expr))
4260 or else Expr_Value (Expr) < 0
4263 ("value must be non-negative integer", Arg);
4266 -- Restriction pragma is active
4268 Val := Expr_Value (Expr);
4270 if not UI_Is_In_Int_Range (Val) then
4272 ("pragma ignored, value too large?", Arg);
4275 -- Warning case. If the real restriction is active, then we
4276 -- ignore the request, since warning never overrides a real
4277 -- restriction. Otherwise we set the proper warning. Note that
4278 -- this circuit sets the warning again if it is already set,
4279 -- which is what we want, since the constant may have changed.
4282 if not Restriction_Active (R_Id) then
4284 (R_Id, N, Integer (UI_To_Int (Val)));
4285 Restriction_Warnings (R_Id) := True;
4288 -- Real restriction case, set restriction and make sure warning
4289 -- flag is off since real restriction always overrides warning.
4292 Set_Restriction (R_Id, N, Integer (UI_To_Int (Val)));
4293 Restriction_Warnings (R_Id) := False;
4299 end Process_Restrictions_Or_Restriction_Warnings;
4301 ---------------------------------
4302 -- Process_Suppress_Unsuppress --
4303 ---------------------------------
4305 -- Note: this procedure makes entries in the check suppress data
4306 -- structures managed by Sem. See spec of package Sem for full
4307 -- details on how we handle recording of check suppression.
4309 procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean) is
4314 In_Package_Spec : constant Boolean :=
4315 (Ekind (Current_Scope) = E_Package
4317 Ekind (Current_Scope) = E_Generic_Package)
4318 and then not In_Package_Body (Current_Scope);
4320 procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id);
4321 -- Used to suppress a single check on the given entity
4323 --------------------------------
4324 -- Suppress_Unsuppress_Echeck --
4325 --------------------------------
4327 procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id) is
4329 Set_Checks_May_Be_Suppressed (E);
4331 if In_Package_Spec then
4332 Push_Global_Suppress_Stack_Entry
4335 Suppress => Suppress_Case);
4338 Push_Local_Suppress_Stack_Entry
4341 Suppress => Suppress_Case);
4344 -- If this is a first subtype, and the base type is distinct,
4345 -- then also set the suppress flags on the base type.
4347 if Is_First_Subtype (E)
4348 and then Etype (E) /= E
4350 Suppress_Unsuppress_Echeck (Etype (E), C);
4352 end Suppress_Unsuppress_Echeck;
4354 -- Start of processing for Process_Suppress_Unsuppress
4357 -- Suppress/Unsuppress can appear as a configuration pragma,
4358 -- or in a declarative part or a package spec (RM 11.5(5))
4360 if not Is_Configuration_Pragma then
4361 Check_Is_In_Decl_Part_Or_Package_Spec;
4364 Check_At_Least_N_Arguments (1);
4365 Check_At_Most_N_Arguments (2);
4366 Check_No_Identifier (Arg1);
4367 Check_Arg_Is_Identifier (Arg1);
4369 C := Get_Check_Id (Chars (Expression (Arg1)));
4371 if C = No_Check_Id then
4373 ("argument of pragma% is not valid check name", Arg1);
4376 if not Suppress_Case
4377 and then (C = All_Checks or else C = Overflow_Check)
4379 Opt.Overflow_Checks_Unsuppressed := True;
4382 if Arg_Count = 1 then
4384 -- Make an entry in the local scope suppress table. This is the
4385 -- table that directly shows the current value of the scope
4386 -- suppress check for any check id value.
4388 if C = All_Checks then
4390 -- For All_Checks, we set all specific predefined checks with
4391 -- the exception of Elaboration_Check, which is handled
4392 -- specially because of not wanting All_Checks to have the
4393 -- effect of deactivating static elaboration order processing.
4395 for J in Scope_Suppress'Range loop
4396 if J /= Elaboration_Check then
4397 Scope_Suppress (J) := Suppress_Case;
4401 -- If not All_Checks, and predefined check, then set appropriate
4402 -- scope entry. Note that we will set Elaboration_Check if this
4403 -- is explicitly specified.
4405 elsif C in Predefined_Check_Id then
4406 Scope_Suppress (C) := Suppress_Case;
4409 -- Also make an entry in the Local_Entity_Suppress table
4411 Push_Local_Suppress_Stack_Entry
4414 Suppress => Suppress_Case);
4416 -- Case of two arguments present, where the check is suppressed for
4417 -- a specified entity (given as the second argument of the pragma)
4420 Check_Optional_Identifier (Arg2, Name_On);
4421 E_Id := Expression (Arg2);
4424 if not Is_Entity_Name (E_Id) then
4426 ("second argument of pragma% must be entity name", Arg2);
4435 -- Enforce RM 11.5(7) which requires that for a pragma that
4436 -- appears within a package spec, the named entity must be
4437 -- within the package spec. We allow the package name itself
4438 -- to be mentioned since that makes sense, although it is not
4439 -- strictly allowed by 11.5(7).
4442 and then E /= Current_Scope
4443 and then Scope (E) /= Current_Scope
4446 ("entity in pragma% is not in package spec (RM 11.5(7))",
4450 -- Loop through homonyms. As noted below, in the case of a package
4451 -- spec, only homonyms within the package spec are considered.
4454 Suppress_Unsuppress_Echeck (E, C);
4456 if Is_Generic_Instance (E)
4457 and then Is_Subprogram (E)
4458 and then Present (Alias (E))
4460 Suppress_Unsuppress_Echeck (Alias (E), C);
4463 -- Move to next homonym
4468 -- If we are within a package specification, the
4469 -- pragma only applies to homonyms in the same scope.
4471 exit when In_Package_Spec
4472 and then Scope (E) /= Current_Scope;
4475 end Process_Suppress_Unsuppress;
4481 procedure Set_Exported (E : Entity_Id; Arg : Node_Id) is
4483 if Is_Imported (E) then
4485 ("cannot export entity& that was previously imported", Arg);
4487 elsif Present (Address_Clause (E)) then
4489 ("cannot export entity& that has an address clause", Arg);
4492 Set_Is_Exported (E);
4494 -- Generate a reference for entity explicitly, because the
4495 -- identifier may be overloaded and name resolution will not
4498 Generate_Reference (E, Arg);
4500 -- Deal with exporting non-library level entity
4502 if not Is_Library_Level_Entity (E) then
4504 -- Not allowed at all for subprograms
4506 if Is_Subprogram (E) then
4507 Error_Pragma_Arg ("local subprogram& cannot be exported", Arg);
4509 -- Otherwise set public and statically allocated
4513 Set_Is_Statically_Allocated (E);
4515 -- Warn if the corresponding W flag is set and the pragma
4516 -- comes from source. The latter may not be true e.g. on
4517 -- VMS where we expand export pragmas for exception codes
4518 -- associated with imported or exported exceptions. We do
4519 -- not want to generate a warning for something that the
4520 -- user did not write.
4522 if Warn_On_Export_Import
4523 and then Comes_From_Source (Arg)
4526 ("?& has been made static as a result of Export", Arg, E);
4528 ("\this usage is non-standard and non-portable", Arg);
4533 if Warn_On_Export_Import and then Is_Type (E) then
4535 ("exporting a type has no effect?", Arg, E);
4538 if Warn_On_Export_Import and Inside_A_Generic then
4540 ("all instances of& will have the same external name?", Arg, E);
4544 ----------------------------------------------
4545 -- Set_Extended_Import_Export_External_Name --
4546 ----------------------------------------------
4548 procedure Set_Extended_Import_Export_External_Name
4549 (Internal_Ent : Entity_Id;
4550 Arg_External : Node_Id)
4552 Old_Name : constant Node_Id := Interface_Name (Internal_Ent);
4556 if No (Arg_External) then
4560 Check_Arg_Is_External_Name (Arg_External);
4562 if Nkind (Arg_External) = N_String_Literal then
4563 if String_Length (Strval (Arg_External)) = 0 then
4566 New_Name := Adjust_External_Name_Case (Arg_External);
4569 elsif Nkind (Arg_External) = N_Identifier then
4570 New_Name := Get_Default_External_Name (Arg_External);
4572 -- Check_Arg_Is_External_Name should let through only
4573 -- identifiers and string literals or static string
4574 -- expressions (which are folded to string literals).
4577 raise Program_Error;
4580 -- If we already have an external name set (by a prior normal
4581 -- Import or Export pragma), then the external names must match
4583 if Present (Interface_Name (Internal_Ent)) then
4584 Check_Matching_Internal_Names : declare
4585 S1 : constant String_Id := Strval (Old_Name);
4586 S2 : constant String_Id := Strval (New_Name);
4589 -- Called if names do not match
4595 procedure Mismatch is
4597 Error_Msg_Sloc := Sloc (Old_Name);
4599 ("external name does not match that given #",
4603 -- Start of processing for Check_Matching_Internal_Names
4606 if String_Length (S1) /= String_Length (S2) then
4610 for J in 1 .. String_Length (S1) loop
4611 if Get_String_Char (S1, J) /= Get_String_Char (S2, J) then
4616 end Check_Matching_Internal_Names;
4618 -- Otherwise set the given name
4621 Set_Encoded_Interface_Name (Internal_Ent, New_Name);
4622 Check_Duplicated_Export_Name (New_Name);
4624 end Set_Extended_Import_Export_External_Name;
4630 procedure Set_Imported (E : Entity_Id) is
4632 -- Error message if already imported or exported
4634 if Is_Exported (E) or else Is_Imported (E) then
4635 if Is_Exported (E) then
4636 Error_Msg_NE ("entity& was previously exported", N, E);
4638 Error_Msg_NE ("entity& was previously imported", N, E);
4641 Error_Msg_Name_1 := Pname;
4643 ("\(pragma% applies to all previous entities)", N);
4645 Error_Msg_Sloc := Sloc (E);
4646 Error_Msg_NE ("\import not allowed for& declared#", N, E);
4648 -- Here if not previously imported or exported, OK to import
4651 Set_Is_Imported (E);
4653 -- If the entity is an object that is not at the library
4654 -- level, then it is statically allocated. We do not worry
4655 -- about objects with address clauses in this context since
4656 -- they are not really imported in the linker sense.
4659 and then not Is_Library_Level_Entity (E)
4660 and then No (Address_Clause (E))
4662 Set_Is_Statically_Allocated (E);
4667 -------------------------
4668 -- Set_Mechanism_Value --
4669 -------------------------
4671 -- Note: the mechanism name has not been analyzed (and cannot indeed
4672 -- be analyzed, since it is semantic nonsense), so we get it in the
4673 -- exact form created by the parser.
4675 procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id) is
4678 Mech_Name_Id : Name_Id;
4680 procedure Bad_Class;
4681 -- Signal bad descriptor class name
4683 procedure Bad_Mechanism;
4684 -- Signal bad mechanism name
4690 procedure Bad_Class is
4692 Error_Pragma_Arg ("unrecognized descriptor class name", Class);
4695 -------------------------
4696 -- Bad_Mechanism_Value --
4697 -------------------------
4699 procedure Bad_Mechanism is
4701 Error_Pragma_Arg ("unrecognized mechanism name", Mech_Name);
4704 -- Start of processing for Set_Mechanism_Value
4707 if Mechanism (Ent) /= Default_Mechanism then
4709 ("mechanism for & has already been set", Mech_Name, Ent);
4712 -- MECHANISM_NAME ::= value | reference | descriptor |
4715 if Nkind (Mech_Name) = N_Identifier then
4716 if Chars (Mech_Name) = Name_Value then
4717 Set_Mechanism (Ent, By_Copy);
4720 elsif Chars (Mech_Name) = Name_Reference then
4721 Set_Mechanism (Ent, By_Reference);
4724 elsif Chars (Mech_Name) = Name_Descriptor then
4725 Check_VMS (Mech_Name);
4726 Set_Mechanism (Ent, By_Descriptor);
4729 elsif Chars (Mech_Name) = Name_Short_Descriptor then
4730 Check_VMS (Mech_Name);
4731 Set_Mechanism (Ent, By_Short_Descriptor);
4734 elsif Chars (Mech_Name) = Name_Copy then
4736 ("bad mechanism name, Value assumed", Mech_Name);
4742 -- MECHANISM_NAME ::= descriptor (CLASS_NAME) |
4743 -- short_descriptor (CLASS_NAME)
4744 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
4746 -- Note: this form is parsed as an indexed component
4748 elsif Nkind (Mech_Name) = N_Indexed_Component then
4750 Class := First (Expressions (Mech_Name));
4752 if Nkind (Prefix (Mech_Name)) /= N_Identifier
4753 or else not (Chars (Prefix (Mech_Name)) = Name_Descriptor or else
4754 Chars (Prefix (Mech_Name)) = Name_Short_Descriptor)
4755 or else Present (Next (Class))
4759 Mech_Name_Id := Chars (Prefix (Mech_Name));
4762 -- MECHANISM_NAME ::= descriptor (Class => CLASS_NAME) |
4763 -- short_descriptor (Class => CLASS_NAME)
4764 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
4766 -- Note: this form is parsed as a function call
4768 elsif Nkind (Mech_Name) = N_Function_Call then
4770 Param := First (Parameter_Associations (Mech_Name));
4772 if Nkind (Name (Mech_Name)) /= N_Identifier
4773 or else not (Chars (Name (Mech_Name)) = Name_Descriptor or else
4774 Chars (Name (Mech_Name)) = Name_Short_Descriptor)
4775 or else Present (Next (Param))
4776 or else No (Selector_Name (Param))
4777 or else Chars (Selector_Name (Param)) /= Name_Class
4781 Class := Explicit_Actual_Parameter (Param);
4782 Mech_Name_Id := Chars (Name (Mech_Name));
4789 -- Fall through here with Class set to descriptor class name
4791 Check_VMS (Mech_Name);
4793 if Nkind (Class) /= N_Identifier then
4796 elsif Mech_Name_Id = Name_Descriptor
4797 and then Chars (Class) = Name_UBS
4799 Set_Mechanism (Ent, By_Descriptor_UBS);
4801 elsif Mech_Name_Id = Name_Descriptor
4802 and then Chars (Class) = Name_UBSB
4804 Set_Mechanism (Ent, By_Descriptor_UBSB);
4806 elsif Mech_Name_Id = Name_Descriptor
4807 and then Chars (Class) = Name_UBA
4809 Set_Mechanism (Ent, By_Descriptor_UBA);
4811 elsif Mech_Name_Id = Name_Descriptor
4812 and then Chars (Class) = Name_S
4814 Set_Mechanism (Ent, By_Descriptor_S);
4816 elsif Mech_Name_Id = Name_Descriptor
4817 and then Chars (Class) = Name_SB
4819 Set_Mechanism (Ent, By_Descriptor_SB);
4821 elsif Mech_Name_Id = Name_Descriptor
4822 and then Chars (Class) = Name_A
4824 Set_Mechanism (Ent, By_Descriptor_A);
4826 elsif Mech_Name_Id = Name_Descriptor
4827 and then Chars (Class) = Name_NCA
4829 Set_Mechanism (Ent, By_Descriptor_NCA);
4831 elsif Mech_Name_Id = Name_Short_Descriptor
4832 and then Chars (Class) = Name_UBS
4834 Set_Mechanism (Ent, By_Short_Descriptor_UBS);
4836 elsif Mech_Name_Id = Name_Short_Descriptor
4837 and then Chars (Class) = Name_UBSB
4839 Set_Mechanism (Ent, By_Short_Descriptor_UBSB);
4841 elsif Mech_Name_Id = Name_Short_Descriptor
4842 and then Chars (Class) = Name_UBA
4844 Set_Mechanism (Ent, By_Short_Descriptor_UBA);
4846 elsif Mech_Name_Id = Name_Short_Descriptor
4847 and then Chars (Class) = Name_S
4849 Set_Mechanism (Ent, By_Short_Descriptor_S);
4851 elsif Mech_Name_Id = Name_Short_Descriptor
4852 and then Chars (Class) = Name_SB
4854 Set_Mechanism (Ent, By_Short_Descriptor_SB);
4856 elsif Mech_Name_Id = Name_Short_Descriptor
4857 and then Chars (Class) = Name_A
4859 Set_Mechanism (Ent, By_Short_Descriptor_A);
4861 elsif Mech_Name_Id = Name_Short_Descriptor
4862 and then Chars (Class) = Name_NCA
4864 Set_Mechanism (Ent, By_Short_Descriptor_NCA);
4869 end Set_Mechanism_Value;
4871 ---------------------------
4872 -- Set_Ravenscar_Profile --
4873 ---------------------------
4875 -- The tasks to be done here are
4877 -- Set required policies
4879 -- pragma Task_Dispatching_Policy (FIFO_Within_Priorities)
4880 -- pragma Locking_Policy (Ceiling_Locking)
4882 -- Set Detect_Blocking mode
4884 -- Set required restrictions (see System.Rident for detailed list)
4886 procedure Set_Ravenscar_Profile (N : Node_Id) is
4888 -- pragma Task_Dispatching_Policy (FIFO_Within_Priorities)
4890 if Task_Dispatching_Policy /= ' '
4891 and then Task_Dispatching_Policy /= 'F'
4893 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
4894 Error_Pragma ("Profile (Ravenscar) incompatible with policy#");
4896 -- Set the FIFO_Within_Priorities policy, but always preserve
4897 -- System_Location since we like the error message with the run time
4901 Task_Dispatching_Policy := 'F';
4903 if Task_Dispatching_Policy_Sloc /= System_Location then
4904 Task_Dispatching_Policy_Sloc := Loc;
4908 -- pragma Locking_Policy (Ceiling_Locking)
4910 if Locking_Policy /= ' '
4911 and then Locking_Policy /= 'C'
4913 Error_Msg_Sloc := Locking_Policy_Sloc;
4914 Error_Pragma ("Profile (Ravenscar) incompatible with policy#");
4916 -- Set the Ceiling_Locking policy, but preserve System_Location since
4917 -- we like the error message with the run time name.
4920 Locking_Policy := 'C';
4922 if Locking_Policy_Sloc /= System_Location then
4923 Locking_Policy_Sloc := Loc;
4927 -- pragma Detect_Blocking
4929 Detect_Blocking := True;
4931 -- Set the corresponding restrictions
4933 Set_Profile_Restrictions
4934 (Ravenscar, N, Warn => Treat_Restrictions_As_Warnings);
4935 end Set_Ravenscar_Profile;
4937 -- Start of processing for Analyze_Pragma
4940 -- Deal with unrecognized pragma
4942 if not Is_Pragma_Name (Pname) then
4943 if Warn_On_Unrecognized_Pragma then
4944 Error_Msg_Name_1 := Pname;
4945 Error_Msg_N ("?unrecognized pragma%!", Pragma_Identifier (N));
4947 for PN in First_Pragma_Name .. Last_Pragma_Name loop
4948 if Is_Bad_Spelling_Of (Pname, PN) then
4949 Error_Msg_Name_1 := PN;
4951 ("\?possible misspelling of %!", Pragma_Identifier (N));
4960 -- Here to start processing for recognized pragma
4962 Prag_Id := Get_Pragma_Id (Pname);
4971 if Present (Pragma_Argument_Associations (N)) then
4972 Arg1 := First (Pragma_Argument_Associations (N));
4974 if Present (Arg1) then
4975 Arg2 := Next (Arg1);
4977 if Present (Arg2) then
4978 Arg3 := Next (Arg2);
4980 if Present (Arg3) then
4981 Arg4 := Next (Arg3);
4987 -- Count number of arguments
4994 while Present (Arg_Node) loop
4995 Arg_Count := Arg_Count + 1;
5000 -- An enumeration type defines the pragmas that are supported by the
5001 -- implementation. Get_Pragma_Id (in package Prag) transforms a name
5002 -- into the corresponding enumeration value for the following case.
5010 -- pragma Abort_Defer;
5012 when Pragma_Abort_Defer =>
5014 Check_Arg_Count (0);
5016 -- The only required semantic processing is to check the
5017 -- placement. This pragma must appear at the start of the
5018 -- statement sequence of a handled sequence of statements.
5020 if Nkind (Parent (N)) /= N_Handled_Sequence_Of_Statements
5021 or else N /= First (Statements (Parent (N)))
5032 -- Note: this pragma also has some specific processing in Par.Prag
5033 -- because we want to set the Ada version mode during parsing.
5035 when Pragma_Ada_83 =>
5037 Check_Arg_Count (0);
5039 -- We really should check unconditionally for proper configuration
5040 -- pragma placement, since we really don't want mixed Ada modes
5041 -- within a single unit, and the GNAT reference manual has always
5042 -- said this was a configuration pragma, but we did not check and
5043 -- are hesitant to add the check now.
5045 -- However, we really cannot tolerate mixing Ada 2005 with Ada 83
5046 -- or Ada 95, so we must check if we are in Ada 2005 mode.
5048 if Ada_Version >= Ada_05 then
5049 Check_Valid_Configuration_Pragma;
5052 -- Now set Ada 83 mode
5054 Ada_Version := Ada_83;
5055 Ada_Version_Explicit := Ada_Version;
5063 -- Note: this pragma also has some specific processing in Par.Prag
5064 -- because we want to set the Ada 83 version mode during parsing.
5066 when Pragma_Ada_95 =>
5068 Check_Arg_Count (0);
5070 -- We really should check unconditionally for proper configuration
5071 -- pragma placement, since we really don't want mixed Ada modes
5072 -- within a single unit, and the GNAT reference manual has always
5073 -- said this was a configuration pragma, but we did not check and
5074 -- are hesitant to add the check now.
5076 -- However, we really cannot tolerate mixing Ada 2005 with Ada 83
5077 -- or Ada 95, so we must check if we are in Ada 2005 mode.
5079 if Ada_Version >= Ada_05 then
5080 Check_Valid_Configuration_Pragma;
5083 -- Now set Ada 95 mode
5085 Ada_Version := Ada_95;
5086 Ada_Version_Explicit := Ada_Version;
5088 ---------------------
5089 -- Ada_05/Ada_2005 --
5090 ---------------------
5093 -- pragma Ada_05 (LOCAL_NAME);
5096 -- pragma Ada_2005 (LOCAL_NAME):
5098 -- Note: these pragma also have some specific processing in Par.Prag
5099 -- because we want to set the Ada 2005 version mode during parsing.
5101 when Pragma_Ada_05 | Pragma_Ada_2005 => declare
5107 if Arg_Count = 1 then
5108 Check_Arg_Is_Local_Name (Arg1);
5109 E_Id := Expression (Arg1);
5111 if Etype (E_Id) = Any_Type then
5115 Set_Is_Ada_2005_Only (Entity (E_Id));
5118 Check_Arg_Count (0);
5120 -- For Ada_2005 we unconditionally enforce the documented
5121 -- configuration pragma placement, since we do not want to
5122 -- tolerate mixed modes in a unit involving Ada 2005. That
5123 -- would cause real difficulties for those cases where there
5124 -- are incompatibilities between Ada 95 and Ada 2005.
5126 Check_Valid_Configuration_Pragma;
5128 -- Now set Ada 2005 mode
5130 Ada_Version := Ada_05;
5131 Ada_Version_Explicit := Ada_05;
5135 ----------------------
5136 -- All_Calls_Remote --
5137 ----------------------
5139 -- pragma All_Calls_Remote [(library_package_NAME)];
5141 when Pragma_All_Calls_Remote => All_Calls_Remote : declare
5142 Lib_Entity : Entity_Id;
5145 Check_Ada_83_Warning;
5146 Check_Valid_Library_Unit_Pragma;
5148 if Nkind (N) = N_Null_Statement then
5152 Lib_Entity := Find_Lib_Unit_Name;
5154 -- This pragma should only apply to a RCI unit (RM E.2.3(23))
5156 if Present (Lib_Entity)
5157 and then not Debug_Flag_U
5159 if not Is_Remote_Call_Interface (Lib_Entity) then
5160 Error_Pragma ("pragma% only apply to rci unit");
5162 -- Set flag for entity of the library unit
5165 Set_Has_All_Calls_Remote (Lib_Entity);
5169 end All_Calls_Remote;
5175 -- pragma Annotate (IDENTIFIER {, ARG});
5176 -- ARG ::= NAME | EXPRESSION
5178 when Pragma_Annotate => Annotate : begin
5180 Check_At_Least_N_Arguments (1);
5181 Check_Arg_Is_Identifier (Arg1);
5189 while Present (Arg) loop
5190 Exp := Expression (Arg);
5193 if Is_Entity_Name (Exp) then
5196 elsif Nkind (Exp) = N_String_Literal then
5197 Resolve (Exp, Standard_String);
5199 elsif Is_Overloaded (Exp) then
5200 Error_Pragma_Arg ("ambiguous argument for pragma%", Exp);
5215 -- pragma Assert ([Check =>] Boolean_EXPRESSION
5216 -- [, [Message =>] Static_String_EXPRESSION]);
5218 when Pragma_Assert => Assert : declare
5224 Check_At_Least_N_Arguments (1);
5225 Check_At_Most_N_Arguments (2);
5226 Check_Arg_Order ((Name_Check, Name_Message));
5227 Check_Optional_Identifier (Arg1, Name_Check);
5229 -- We treat pragma Assert as equivalent to:
5231 -- pragma Check (Assertion, condition [, msg]);
5233 -- So rewrite pragma in this manner, and analyze the result
5235 Expr := Get_Pragma_Arg (Arg1);
5237 Make_Pragma_Argument_Association (Loc,
5239 Make_Identifier (Loc,
5240 Chars => Name_Assertion)),
5242 Make_Pragma_Argument_Association (Sloc (Expr),
5243 Expression => Expr));
5245 if Arg_Count > 1 then
5246 Check_Optional_Identifier (Arg2, Name_Message);
5247 Analyze_And_Resolve (Get_Pragma_Arg (Arg2), Standard_String);
5248 Append_To (Newa, Relocate_Node (Arg2));
5253 Chars => Name_Check,
5254 Pragma_Argument_Associations => Newa));
5258 ----------------------
5259 -- Assertion_Policy --
5260 ----------------------
5262 -- pragma Assertion_Policy (Check | Ignore)
5264 when Pragma_Assertion_Policy => Assertion_Policy : declare
5269 Check_Valid_Configuration_Pragma;
5270 Check_Arg_Count (1);
5271 Check_No_Identifiers;
5272 Check_Arg_Is_One_Of (Arg1, Name_Check, Name_Ignore);
5274 -- We treat pragma Assertion_Policy as equivalent to:
5276 -- pragma Check_Policy (Assertion, policy)
5278 -- So rewrite the pragma in that manner and link on to the chain
5279 -- of Check_Policy pragmas, marking the pragma as analyzed.
5281 Policy := Get_Pragma_Arg (Arg1);
5285 Chars => Name_Check_Policy,
5287 Pragma_Argument_Associations => New_List (
5288 Make_Pragma_Argument_Association (Loc,
5290 Make_Identifier (Loc,
5291 Chars => Name_Assertion)),
5293 Make_Pragma_Argument_Association (Loc,
5295 Make_Identifier (Sloc (Policy),
5296 Chars => Chars (Policy))))));
5299 Set_Next_Pragma (N, Opt.Check_Policy_List);
5300 Opt.Check_Policy_List := N;
5301 end Assertion_Policy;
5307 -- pragma AST_Entry (entry_IDENTIFIER);
5309 when Pragma_AST_Entry => AST_Entry : declare
5315 Check_Arg_Count (1);
5316 Check_No_Identifiers;
5317 Check_Arg_Is_Local_Name (Arg1);
5318 Ent := Entity (Expression (Arg1));
5320 -- Note: the implementation of the AST_Entry pragma could handle
5321 -- the entry family case fine, but for now we are consistent with
5322 -- the DEC rules, and do not allow the pragma, which of course
5323 -- has the effect of also forbidding the attribute.
5325 if Ekind (Ent) /= E_Entry then
5327 ("pragma% argument must be simple entry name", Arg1);
5329 elsif Is_AST_Entry (Ent) then
5331 ("duplicate % pragma for entry", Arg1);
5333 elsif Has_Homonym (Ent) then
5335 ("pragma% argument cannot specify overloaded entry", Arg1);
5339 FF : constant Entity_Id := First_Formal (Ent);
5342 if Present (FF) then
5343 if Present (Next_Formal (FF)) then
5345 ("entry for pragma% can have only one argument",
5348 elsif Parameter_Mode (FF) /= E_In_Parameter then
5350 ("entry parameter for pragma% must have mode IN",
5356 Set_Is_AST_Entry (Ent);
5364 -- pragma Asynchronous (LOCAL_NAME);
5366 when Pragma_Asynchronous => Asynchronous : declare
5374 procedure Process_Async_Pragma;
5375 -- Common processing for procedure and access-to-procedure case
5377 --------------------------
5378 -- Process_Async_Pragma --
5379 --------------------------
5381 procedure Process_Async_Pragma is
5384 Set_Is_Asynchronous (Nm);
5388 -- The formals should be of mode IN (RM E.4.1(6))
5391 while Present (S) loop
5392 Formal := Defining_Identifier (S);
5394 if Nkind (Formal) = N_Defining_Identifier
5395 and then Ekind (Formal) /= E_In_Parameter
5398 ("pragma% procedure can only have IN parameter",
5405 Set_Is_Asynchronous (Nm);
5406 end Process_Async_Pragma;
5408 -- Start of processing for pragma Asynchronous
5411 Check_Ada_83_Warning;
5412 Check_No_Identifiers;
5413 Check_Arg_Count (1);
5414 Check_Arg_Is_Local_Name (Arg1);
5416 if Debug_Flag_U then
5420 C_Ent := Cunit_Entity (Current_Sem_Unit);
5421 Analyze (Expression (Arg1));
5422 Nm := Entity (Expression (Arg1));
5424 if not Is_Remote_Call_Interface (C_Ent)
5425 and then not Is_Remote_Types (C_Ent)
5427 -- This pragma should only appear in an RCI or Remote Types
5428 -- unit (RM E.4.1(4))
5431 ("pragma% not in Remote_Call_Interface or " &
5432 "Remote_Types unit");
5435 if Ekind (Nm) = E_Procedure
5436 and then Nkind (Parent (Nm)) = N_Procedure_Specification
5438 if not Is_Remote_Call_Interface (Nm) then
5440 ("pragma% cannot be applied on non-remote procedure",
5444 L := Parameter_Specifications (Parent (Nm));
5445 Process_Async_Pragma;
5448 elsif Ekind (Nm) = E_Function then
5450 ("pragma% cannot be applied to function", Arg1);
5452 elsif Is_Remote_Access_To_Subprogram_Type (Nm) then
5454 if Is_Record_Type (Nm) then
5455 -- A record type that is the Equivalent_Type for
5456 -- a remote access-to-subprogram type.
5458 N := Declaration_Node (Corresponding_Remote_Type (Nm));
5461 -- A non-expanded RAS type (case where distribution is
5464 N := Declaration_Node (Nm);
5467 if Nkind (N) = N_Full_Type_Declaration
5468 and then Nkind (Type_Definition (N)) =
5469 N_Access_Procedure_Definition
5471 L := Parameter_Specifications (Type_Definition (N));
5472 Process_Async_Pragma;
5474 if Is_Asynchronous (Nm)
5475 and then Expander_Active
5476 and then Get_PCS_Name /= Name_No_DSA
5478 RACW_Type_Is_Asynchronous (Underlying_RACW_Type (Nm));
5483 ("pragma% cannot reference access-to-function type",
5487 -- Only other possibility is Access-to-class-wide type
5489 elsif Is_Access_Type (Nm)
5490 and then Is_Class_Wide_Type (Designated_Type (Nm))
5492 Check_First_Subtype (Arg1);
5493 Set_Is_Asynchronous (Nm);
5494 if Expander_Active then
5495 RACW_Type_Is_Asynchronous (Nm);
5499 Error_Pragma_Arg ("inappropriate argument for pragma%", Arg1);
5507 -- pragma Atomic (LOCAL_NAME);
5509 when Pragma_Atomic =>
5510 Process_Atomic_Shared_Volatile;
5512 -----------------------
5513 -- Atomic_Components --
5514 -----------------------
5516 -- pragma Atomic_Components (array_LOCAL_NAME);
5518 -- This processing is shared by Volatile_Components
5520 when Pragma_Atomic_Components |
5521 Pragma_Volatile_Components =>
5523 Atomic_Components : declare
5530 Check_Ada_83_Warning;
5531 Check_No_Identifiers;
5532 Check_Arg_Count (1);
5533 Check_Arg_Is_Local_Name (Arg1);
5534 E_Id := Expression (Arg1);
5536 if Etype (E_Id) = Any_Type then
5542 if Rep_Item_Too_Early (E, N)
5544 Rep_Item_Too_Late (E, N)
5549 D := Declaration_Node (E);
5552 if (K = N_Full_Type_Declaration and then Is_Array_Type (E))
5554 ((Ekind (E) = E_Constant or else Ekind (E) = E_Variable)
5555 and then Nkind (D) = N_Object_Declaration
5556 and then Nkind (Object_Definition (D)) =
5557 N_Constrained_Array_Definition)
5559 -- The flag is set on the object, or on the base type
5561 if Nkind (D) /= N_Object_Declaration then
5565 Set_Has_Volatile_Components (E);
5567 if Prag_Id = Pragma_Atomic_Components then
5568 Set_Has_Atomic_Components (E);
5570 if Is_Packed (E) then
5571 Set_Is_Packed (E, False);
5574 ("?Pack canceled, cannot pack atomic components",
5580 Error_Pragma_Arg ("inappropriate entity for pragma%", Arg1);
5582 end Atomic_Components;
5584 --------------------
5585 -- Attach_Handler --
5586 --------------------
5588 -- pragma Attach_Handler (handler_NAME, EXPRESSION);
5590 when Pragma_Attach_Handler =>
5591 Check_Ada_83_Warning;
5592 Check_No_Identifiers;
5593 Check_Arg_Count (2);
5595 if No_Run_Time_Mode then
5596 Error_Msg_CRT ("Attach_Handler pragma", N);
5598 Check_Interrupt_Or_Attach_Handler;
5600 -- The expression that designates the attribute may
5601 -- depend on a discriminant, and is therefore a per-
5602 -- object expression, to be expanded in the init proc.
5603 -- If expansion is enabled, perform semantic checks
5606 if Expander_Active then
5608 Temp : constant Node_Id :=
5609 New_Copy_Tree (Expression (Arg2));
5611 Set_Parent (Temp, N);
5612 Preanalyze_And_Resolve (Temp, RTE (RE_Interrupt_ID));
5616 Analyze (Expression (Arg2));
5617 Resolve (Expression (Arg2), RTE (RE_Interrupt_ID));
5620 Process_Interrupt_Or_Attach_Handler;
5623 --------------------
5624 -- C_Pass_By_Copy --
5625 --------------------
5627 -- pragma C_Pass_By_Copy ([Max_Size =>] static_integer_EXPRESSION);
5629 when Pragma_C_Pass_By_Copy => C_Pass_By_Copy : declare
5635 Check_Valid_Configuration_Pragma;
5636 Check_Arg_Count (1);
5637 Check_Optional_Identifier (Arg1, "max_size");
5639 Arg := Expression (Arg1);
5640 Check_Arg_Is_Static_Expression (Arg, Any_Integer);
5642 Val := Expr_Value (Arg);
5646 ("maximum size for pragma% must be positive", Arg1);
5648 elsif UI_Is_In_Int_Range (Val) then
5649 Default_C_Record_Mechanism := UI_To_Int (Val);
5651 -- If a giant value is given, Int'Last will do well enough.
5652 -- If sometime someone complains that a record larger than
5653 -- two gigabytes is not copied, we will worry about it then!
5656 Default_C_Record_Mechanism := Mechanism_Type'Last;
5664 -- pragma Check ([Name =>] Identifier,
5665 -- [Check =>] Boolean_Expression
5666 -- [,[Message =>] String_Expression]);
5668 when Pragma_Check => Check : declare
5673 -- Set True if category of assertions referenced by Name enabled
5677 Check_At_Least_N_Arguments (2);
5678 Check_At_Most_N_Arguments (3);
5679 Check_Optional_Identifier (Arg1, Name_Name);
5680 Check_Optional_Identifier (Arg2, Name_Check);
5682 if Arg_Count = 3 then
5683 Check_Optional_Identifier (Arg3, Name_Message);
5684 Analyze_And_Resolve (Get_Pragma_Arg (Arg3), Standard_String);
5687 Check_Arg_Is_Identifier (Arg1);
5688 Check_On := Check_Enabled (Chars (Get_Pragma_Arg (Arg1)));
5690 -- If expansion is active and the check is not enabled then we
5691 -- rewrite the Check as:
5693 -- if False and then condition then
5697 -- The reason we do this rewriting during semantic analysis rather
5698 -- than as part of normal expansion is that we cannot analyze and
5699 -- expand the code for the boolean expression directly, or it may
5700 -- cause insertion of actions that would escape the attempt to
5701 -- suppress the check code.
5703 -- Note that the Sloc for the if statement corresponds to the
5704 -- argument condition, not the pragma itself. The reason for this
5705 -- is that we may generate a warning if the condition is False at
5706 -- compile time, and we do not want to delete this warning when we
5707 -- delete the if statement.
5709 Expr := Expression (Arg2);
5711 if Expander_Active and then not Check_On then
5712 Eloc := Sloc (Expr);
5715 Make_If_Statement (Eloc,
5717 Make_And_Then (Eloc,
5718 Left_Opnd => New_Occurrence_Of (Standard_False, Eloc),
5719 Right_Opnd => Expr),
5720 Then_Statements => New_List (
5721 Make_Null_Statement (Eloc))));
5728 Analyze_And_Resolve (Expr, Any_Boolean);
5731 -- If assertion is of the form (X'First = literal), where X is
5732 -- a formal, then set Low_Bound_Known flag on this formal.
5734 if Nkind (Expr) = N_Op_Eq then
5736 Right : constant Node_Id := Right_Opnd (Expr);
5737 Left : constant Node_Id := Left_Opnd (Expr);
5739 if Nkind (Left) = N_Attribute_Reference
5740 and then Attribute_Name (Left) = Name_First
5741 and then Is_Entity_Name (Prefix (Left))
5742 and then Is_Formal (Entity (Prefix (Left)))
5743 and then Nkind (Right) = N_Integer_Literal
5745 Set_Low_Bound_Known (Entity (Prefix (Left)));
5755 -- pragma Check_Name (check_IDENTIFIER);
5757 when Pragma_Check_Name =>
5758 Check_No_Identifiers;
5760 Check_Valid_Configuration_Pragma;
5761 Check_Arg_Count (1);
5762 Check_Arg_Is_Identifier (Arg1);
5765 Nam : constant Name_Id := Chars (Expression (Arg1));
5768 for J in Check_Names.First .. Check_Names.Last loop
5769 if Check_Names.Table (J) = Nam then
5774 Check_Names.Append (Nam);
5781 -- pragma Check_Policy ([Name =>] IDENTIFIER,
5782 -- POLICY_IDENTIFIER;
5784 -- POLICY_IDENTIFIER ::= ON | OFF | CHECK | IGNORE
5786 -- Note: this is a configuration pragma, but it is allowed to
5787 -- appear anywhere else.
5789 when Pragma_Check_Policy =>
5791 Check_Arg_Count (2);
5792 Check_No_Identifier (Arg2);
5793 Check_Optional_Identifier (Arg1, Name_Name);
5795 (Arg2, Name_On, Name_Off, Name_Check, Name_Ignore);
5797 -- A Check_Policy pragma can appear either as a configuration
5798 -- pragma, or in a declarative part or a package spec (see RM
5799 -- 11.5(5) for rules for Suppress/Unsuppress which are also
5800 -- followed for Check_Policy).
5802 if not Is_Configuration_Pragma then
5803 Check_Is_In_Decl_Part_Or_Package_Spec;
5806 Set_Next_Pragma (N, Opt.Check_Policy_List);
5807 Opt.Check_Policy_List := N;
5809 ---------------------
5810 -- CIL_Constructor --
5811 ---------------------
5813 -- pragma CIL_Constructor ([Entity =>] LOCAL_NAME);
5815 -- Processing for this pragma is shared with Java_Constructor
5821 -- pragma Comment (static_string_EXPRESSION)
5823 -- Processing for pragma Comment shares the circuitry for pragma
5824 -- Ident. The only differences are that Ident enforces a limit of 31
5825 -- characters on its argument, and also enforces limitations on
5826 -- placement for DEC compatibility. Pragma Comment shares neither of
5827 -- these restrictions.
5833 -- pragma Common_Object (
5834 -- [Internal =>] LOCAL_NAME
5835 -- [, [External =>] EXTERNAL_SYMBOL]
5836 -- [, [Size =>] EXTERNAL_SYMBOL]);
5838 -- Processing for this pragma is shared with Psect_Object
5840 ------------------------
5841 -- Compile_Time_Error --
5842 ------------------------
5844 -- pragma Compile_Time_Error
5845 -- (boolean_EXPRESSION, static_string_EXPRESSION);
5847 when Pragma_Compile_Time_Error =>
5849 Process_Compile_Time_Warning_Or_Error;
5851 --------------------------
5852 -- Compile_Time_Warning --
5853 --------------------------
5855 -- pragma Compile_Time_Warning
5856 -- (boolean_EXPRESSION, static_string_EXPRESSION);
5858 when Pragma_Compile_Time_Warning =>
5860 Process_Compile_Time_Warning_Or_Error;
5866 when Pragma_Compiler_Unit =>
5868 Check_Arg_Count (0);
5869 Set_Is_Compiler_Unit (Get_Source_Unit (N));
5871 -----------------------------
5872 -- Complete_Representation --
5873 -----------------------------
5875 -- pragma Complete_Representation;
5877 when Pragma_Complete_Representation =>
5879 Check_Arg_Count (0);
5881 if Nkind (Parent (N)) /= N_Record_Representation_Clause then
5883 ("pragma & must appear within record representation clause");
5886 ----------------------------
5887 -- Complex_Representation --
5888 ----------------------------
5890 -- pragma Complex_Representation ([Entity =>] LOCAL_NAME);
5892 when Pragma_Complex_Representation => Complex_Representation : declare
5899 Check_Arg_Count (1);
5900 Check_Optional_Identifier (Arg1, Name_Entity);
5901 Check_Arg_Is_Local_Name (Arg1);
5902 E_Id := Expression (Arg1);
5904 if Etype (E_Id) = Any_Type then
5910 if not Is_Record_Type (E) then
5912 ("argument for pragma% must be record type", Arg1);
5915 Ent := First_Entity (E);
5918 or else No (Next_Entity (Ent))
5919 or else Present (Next_Entity (Next_Entity (Ent)))
5920 or else not Is_Floating_Point_Type (Etype (Ent))
5921 or else Etype (Ent) /= Etype (Next_Entity (Ent))
5924 ("record for pragma% must have two fields of the same "
5925 & "floating-point type", Arg1);
5928 Set_Has_Complex_Representation (Base_Type (E));
5930 -- We need to treat the type has having a non-standard
5931 -- representation, for back-end purposes, even though in
5932 -- general a complex will have the default representation
5933 -- of a record with two real components.
5935 Set_Has_Non_Standard_Rep (Base_Type (E));
5937 end Complex_Representation;
5939 -------------------------
5940 -- Component_Alignment --
5941 -------------------------
5943 -- pragma Component_Alignment (
5944 -- [Form =>] ALIGNMENT_CHOICE
5945 -- [, [Name =>] type_LOCAL_NAME]);
5947 -- ALIGNMENT_CHOICE ::=
5949 -- | Component_Size_4
5953 when Pragma_Component_Alignment => Component_AlignmentP : declare
5954 Args : Args_List (1 .. 2);
5955 Names : constant Name_List (1 .. 2) := (
5959 Form : Node_Id renames Args (1);
5960 Name : Node_Id renames Args (2);
5962 Atype : Component_Alignment_Kind;
5967 Gather_Associations (Names, Args);
5970 Error_Pragma ("missing Form argument for pragma%");
5973 Check_Arg_Is_Identifier (Form);
5975 -- Get proper alignment, note that Default = Component_Size
5976 -- on all machines we have so far, and we want to set this
5977 -- value rather than the default value to indicate that it
5978 -- has been explicitly set (and thus will not get overridden
5979 -- by the default component alignment for the current scope)
5981 if Chars (Form) = Name_Component_Size then
5982 Atype := Calign_Component_Size;
5984 elsif Chars (Form) = Name_Component_Size_4 then
5985 Atype := Calign_Component_Size_4;
5987 elsif Chars (Form) = Name_Default then
5988 Atype := Calign_Component_Size;
5990 elsif Chars (Form) = Name_Storage_Unit then
5991 Atype := Calign_Storage_Unit;
5995 ("invalid Form parameter for pragma%", Form);
5998 -- Case with no name, supplied, affects scope table entry
6002 (Scope_Stack.Last).Component_Alignment_Default := Atype;
6004 -- Case of name supplied
6007 Check_Arg_Is_Local_Name (Name);
6009 Typ := Entity (Name);
6012 or else Rep_Item_Too_Early (Typ, N)
6016 Typ := Underlying_Type (Typ);
6019 if not Is_Record_Type (Typ)
6020 and then not Is_Array_Type (Typ)
6023 ("Name parameter of pragma% must identify record or " &
6024 "array type", Name);
6027 -- An explicit Component_Alignment pragma overrides an
6028 -- implicit pragma Pack, but not an explicit one.
6030 if not Has_Pragma_Pack (Base_Type (Typ)) then
6031 Set_Is_Packed (Base_Type (Typ), False);
6032 Set_Component_Alignment (Base_Type (Typ), Atype);
6035 end Component_AlignmentP;
6041 -- pragma Controlled (first_subtype_LOCAL_NAME);
6043 when Pragma_Controlled => Controlled : declare
6047 Check_No_Identifiers;
6048 Check_Arg_Count (1);
6049 Check_Arg_Is_Local_Name (Arg1);
6050 Arg := Expression (Arg1);
6052 if not Is_Entity_Name (Arg)
6053 or else not Is_Access_Type (Entity (Arg))
6055 Error_Pragma_Arg ("pragma% requires access type", Arg1);
6057 Set_Has_Pragma_Controlled (Base_Type (Entity (Arg)));
6065 -- pragma Convention ([Convention =>] convention_IDENTIFIER,
6066 -- [Entity =>] LOCAL_NAME);
6068 when Pragma_Convention => Convention : declare
6071 pragma Warnings (Off, C);
6072 pragma Warnings (Off, E);
6074 Check_Arg_Order ((Name_Convention, Name_Entity));
6075 Check_Ada_83_Warning;
6076 Check_Arg_Count (2);
6077 Process_Convention (C, E);
6080 ---------------------------
6081 -- Convention_Identifier --
6082 ---------------------------
6084 -- pragma Convention_Identifier ([Name =>] IDENTIFIER,
6085 -- [Convention =>] convention_IDENTIFIER);
6087 when Pragma_Convention_Identifier => Convention_Identifier : declare
6093 Check_Arg_Order ((Name_Name, Name_Convention));
6094 Check_Arg_Count (2);
6095 Check_Optional_Identifier (Arg1, Name_Name);
6096 Check_Optional_Identifier (Arg2, Name_Convention);
6097 Check_Arg_Is_Identifier (Arg1);
6098 Check_Arg_Is_Identifier (Arg2);
6099 Idnam := Chars (Expression (Arg1));
6100 Cname := Chars (Expression (Arg2));
6102 if Is_Convention_Name (Cname) then
6103 Record_Convention_Identifier
6104 (Idnam, Get_Convention_Id (Cname));
6107 ("second arg for % pragma must be convention", Arg2);
6109 end Convention_Identifier;
6115 -- pragma CPP_Class ([Entity =>] local_NAME)
6117 when Pragma_CPP_Class => CPP_Class : declare
6122 if Warn_On_Obsolescent_Feature then
6124 ("'G'N'A'T pragma cpp'_class is now obsolete; replace it" &
6125 " by pragma import?", N);
6129 Check_Arg_Count (1);
6130 Check_Optional_Identifier (Arg1, Name_Entity);
6131 Check_Arg_Is_Local_Name (Arg1);
6133 Arg := Expression (Arg1);
6136 if Etype (Arg) = Any_Type then
6140 if not Is_Entity_Name (Arg)
6141 or else not Is_Type (Entity (Arg))
6143 Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
6146 Typ := Entity (Arg);
6148 if not Is_Tagged_Type (Typ) then
6149 Error_Pragma_Arg ("pragma% applicable to tagged types ", Arg1);
6152 -- Types treated as CPP classes are treated as limited, but we
6153 -- don't require them to be declared this way. A warning is issued
6154 -- to encourage the user to declare them as limited. This is not
6155 -- an error, for compatibility reasons, because these types have
6156 -- been supported this way for some time.
6158 if not Is_Limited_Type (Typ) then
6160 ("imported 'C'P'P type should be " &
6161 "explicitly declared limited?",
6162 Get_Pragma_Arg (Arg1));
6164 ("\type will be considered limited",
6165 Get_Pragma_Arg (Arg1));
6168 Set_Is_CPP_Class (Typ);
6169 Set_Is_Limited_Record (Typ);
6170 Set_Convention (Typ, Convention_CPP);
6173 ---------------------
6174 -- CPP_Constructor --
6175 ---------------------
6177 -- pragma CPP_Constructor ([Entity =>] LOCAL_NAME
6178 -- [, [External_Name =>] static_string_EXPRESSION ]
6179 -- [, [Link_Name =>] static_string_EXPRESSION ]);
6181 when Pragma_CPP_Constructor => CPP_Constructor : declare
6187 Check_At_Least_N_Arguments (1);
6188 Check_At_Most_N_Arguments (3);
6189 Check_Optional_Identifier (Arg1, Name_Entity);
6190 Check_Arg_Is_Local_Name (Arg1);
6192 Id := Expression (Arg1);
6193 Find_Program_Unit_Name (Id);
6195 -- If we did not find the name, we are done
6197 if Etype (Id) = Any_Type then
6201 Def_Id := Entity (Id);
6203 if Ekind (Def_Id) = E_Function
6204 and then Is_Class_Wide_Type (Etype (Def_Id))
6205 and then Is_CPP_Class (Etype (Etype (Def_Id)))
6207 if Arg_Count >= 2 then
6208 Set_Imported (Def_Id);
6209 Set_Is_Public (Def_Id);
6210 Process_Interface_Name (Def_Id, Arg2, Arg3);
6213 if No (Parameter_Specifications (Parent (Def_Id))) then
6214 Set_Has_Completion (Def_Id);
6215 Set_Is_Constructor (Def_Id);
6218 ("non-default constructors not implemented", Arg1);
6223 ("pragma% requires function returning a 'C'P'P_Class type",
6226 end CPP_Constructor;
6232 when Pragma_CPP_Virtual => CPP_Virtual : declare
6236 if Warn_On_Obsolescent_Feature then
6238 ("'G'N'A'T pragma cpp'_virtual is now obsolete and has " &
6247 when Pragma_CPP_Vtable => CPP_Vtable : declare
6251 if Warn_On_Obsolescent_Feature then
6253 ("'G'N'A'T pragma cpp'_vtable is now obsolete and has " &
6262 -- pragma Debug ([boolean_EXPRESSION,] PROCEDURE_CALL_STATEMENT);
6264 when Pragma_Debug => Debug : declare
6272 (Boolean_Literals (Debug_Pragmas_Enabled and Expander_Active),
6275 if Arg_Count = 2 then
6278 Left_Opnd => Relocate_Node (Cond),
6279 Right_Opnd => Expression (Arg1));
6282 -- Rewrite into a conditional with an appropriate condition. We
6283 -- wrap the procedure call in a block so that overhead from e.g.
6284 -- use of the secondary stack does not generate execution overhead
6285 -- for suppressed conditions.
6287 Rewrite (N, Make_Implicit_If_Statement (N,
6289 Then_Statements => New_List (
6290 Make_Block_Statement (Loc,
6291 Handled_Statement_Sequence =>
6292 Make_Handled_Sequence_Of_Statements (Loc,
6293 Statements => New_List (
6294 Relocate_Node (Debug_Statement (N))))))));
6302 -- pragma Debug_Policy (Check | Ignore)
6304 when Pragma_Debug_Policy =>
6306 Check_Arg_Count (1);
6307 Check_Arg_Is_One_Of (Arg1, Name_Check, Name_Ignore);
6308 Debug_Pragmas_Enabled := Chars (Expression (Arg1)) = Name_Check;
6310 ---------------------
6311 -- Detect_Blocking --
6312 ---------------------
6314 -- pragma Detect_Blocking;
6316 when Pragma_Detect_Blocking =>
6318 Check_Arg_Count (0);
6319 Check_Valid_Configuration_Pragma;
6320 Detect_Blocking := True;
6326 -- pragma Discard_Names [([On =>] LOCAL_NAME)];
6328 when Pragma_Discard_Names => Discard_Names : declare
6333 Check_Ada_83_Warning;
6335 -- Deal with configuration pragma case
6337 if Arg_Count = 0 and then Is_Configuration_Pragma then
6338 Global_Discard_Names := True;
6341 -- Otherwise, check correct appropriate context
6344 Check_Is_In_Decl_Part_Or_Package_Spec;
6346 if Arg_Count = 0 then
6348 -- If there is no parameter, then from now on this pragma
6349 -- applies to any enumeration, exception or tagged type
6350 -- defined in the current declarative part, and recursively
6351 -- to any nested scope.
6353 Set_Discard_Names (Current_Scope);
6357 Check_Arg_Count (1);
6358 Check_Optional_Identifier (Arg1, Name_On);
6359 Check_Arg_Is_Local_Name (Arg1);
6360 E_Id := Expression (Arg1);
6362 if Etype (E_Id) = Any_Type then
6368 if (Is_First_Subtype (E)
6369 and then (Is_Enumeration_Type (E)
6370 or else Is_Tagged_Type (E)))
6371 or else Ekind (E) = E_Exception
6373 Set_Discard_Names (E);
6376 ("inappropriate entity for pragma%", Arg1);
6386 -- pragma Elaborate (library_unit_NAME {, library_unit_NAME});
6388 when Pragma_Elaborate => Elaborate : declare
6393 -- Pragma must be in context items list of a compilation unit
6395 if not Is_In_Context_Clause then
6399 -- Must be at least one argument
6401 if Arg_Count = 0 then
6402 Error_Pragma ("pragma% requires at least one argument");
6405 -- In Ada 83 mode, there can be no items following it in the
6406 -- context list except other pragmas and implicit with clauses
6407 -- (e.g. those added by use of Rtsfind). In Ada 95 mode, this
6408 -- placement rule does not apply.
6410 if Ada_Version = Ada_83 and then Comes_From_Source (N) then
6412 while Present (Citem) loop
6413 if Nkind (Citem) = N_Pragma
6414 or else (Nkind (Citem) = N_With_Clause
6415 and then Implicit_With (Citem))
6420 ("(Ada 83) pragma% must be at end of context clause");
6427 -- Finally, the arguments must all be units mentioned in a with
6428 -- clause in the same context clause. Note we already checked (in
6429 -- Par.Prag) that the arguments are all identifiers or selected
6433 Outer : while Present (Arg) loop
6434 Citem := First (List_Containing (N));
6435 Inner : while Citem /= N loop
6436 if Nkind (Citem) = N_With_Clause
6437 and then Same_Name (Name (Citem), Expression (Arg))
6439 Set_Elaborate_Present (Citem, True);
6440 Set_Unit_Name (Expression (Arg), Name (Citem));
6442 -- With the pragma present, elaboration calls on
6443 -- subprograms from the named unit need no further
6444 -- checks, as long as the pragma appears in the current
6445 -- compilation unit. If the pragma appears in some unit
6446 -- in the context, there might still be a need for an
6447 -- Elaborate_All_Desirable from the current compilation
6448 -- to the named unit, so we keep the check enabled.
6450 if In_Extended_Main_Source_Unit (N) then
6451 Set_Suppress_Elaboration_Warnings
6452 (Entity (Name (Citem)));
6463 ("argument of pragma% is not with'ed unit", Arg);
6469 -- Give a warning if operating in static mode with -gnatwl
6470 -- (elaboration warnings enabled) switch set.
6472 if Elab_Warnings and not Dynamic_Elaboration_Checks then
6474 ("?use of pragma Elaborate may not be safe", N);
6476 ("?use pragma Elaborate_All instead if possible", N);
6484 -- pragma Elaborate_All (library_unit_NAME {, library_unit_NAME});
6486 when Pragma_Elaborate_All => Elaborate_All : declare
6491 Check_Ada_83_Warning;
6493 -- Pragma must be in context items list of a compilation unit
6495 if not Is_In_Context_Clause then
6499 -- Must be at least one argument
6501 if Arg_Count = 0 then
6502 Error_Pragma ("pragma% requires at least one argument");
6505 -- Note: unlike pragma Elaborate, pragma Elaborate_All does not
6506 -- have to appear at the end of the context clause, but may
6507 -- appear mixed in with other items, even in Ada 83 mode.
6509 -- Final check: the arguments must all be units mentioned in
6510 -- a with clause in the same context clause. Note that we
6511 -- already checked (in Par.Prag) that all the arguments are
6512 -- either identifiers or selected components.
6515 Outr : while Present (Arg) loop
6516 Citem := First (List_Containing (N));
6517 Innr : while Citem /= N loop
6518 if Nkind (Citem) = N_With_Clause
6519 and then Same_Name (Name (Citem), Expression (Arg))
6521 Set_Elaborate_All_Present (Citem, True);
6522 Set_Unit_Name (Expression (Arg), Name (Citem));
6524 -- Suppress warnings and elaboration checks on the named
6525 -- unit if the pragma is in the current compilation, as
6526 -- for pragma Elaborate.
6528 if In_Extended_Main_Source_Unit (N) then
6529 Set_Suppress_Elaboration_Warnings
6530 (Entity (Name (Citem)));
6539 Set_Error_Posted (N);
6541 ("argument of pragma% is not with'ed unit", Arg);
6548 --------------------
6549 -- Elaborate_Body --
6550 --------------------
6552 -- pragma Elaborate_Body [( library_unit_NAME )];
6554 when Pragma_Elaborate_Body => Elaborate_Body : declare
6555 Cunit_Node : Node_Id;
6556 Cunit_Ent : Entity_Id;
6559 Check_Ada_83_Warning;
6560 Check_Valid_Library_Unit_Pragma;
6562 if Nkind (N) = N_Null_Statement then
6566 Cunit_Node := Cunit (Current_Sem_Unit);
6567 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
6569 if Nkind (Unit (Cunit_Node)) = N_Package_Body
6571 Nkind (Unit (Cunit_Node)) = N_Subprogram_Body
6573 Error_Pragma ("pragma% must refer to a spec, not a body");
6575 Set_Body_Required (Cunit_Node, True);
6576 Set_Has_Pragma_Elaborate_Body (Cunit_Ent);
6578 -- If we are in dynamic elaboration mode, then we suppress
6579 -- elaboration warnings for the unit, since it is definitely
6580 -- fine NOT to do dynamic checks at the first level (and such
6581 -- checks will be suppressed because no elaboration boolean
6582 -- is created for Elaborate_Body packages).
6584 -- But in the static model of elaboration, Elaborate_Body is
6585 -- definitely NOT good enough to ensure elaboration safety on
6586 -- its own, since the body may WITH other units that are not
6587 -- safe from an elaboration point of view, so a client must
6588 -- still do an Elaborate_All on such units.
6590 -- Debug flag -gnatdD restores the old behavior of 3.13,
6591 -- where Elaborate_Body always suppressed elab warnings.
6593 if Dynamic_Elaboration_Checks or Debug_Flag_DD then
6594 Set_Suppress_Elaboration_Warnings (Cunit_Ent);
6599 ------------------------
6600 -- Elaboration_Checks --
6601 ------------------------
6603 -- pragma Elaboration_Checks (Static | Dynamic);
6605 when Pragma_Elaboration_Checks =>
6607 Check_Arg_Count (1);
6608 Check_Arg_Is_One_Of (Arg1, Name_Static, Name_Dynamic);
6609 Dynamic_Elaboration_Checks :=
6610 (Chars (Get_Pragma_Arg (Arg1)) = Name_Dynamic);
6616 -- pragma Eliminate (
6617 -- [Unit_Name =>] IDENTIFIER |
6618 -- SELECTED_COMPONENT
6619 -- [,[Entity =>] IDENTIFIER |
6620 -- SELECTED_COMPONENT |
6622 -- [,]OVERLOADING_RESOLUTION);
6624 -- OVERLOADING_RESOLUTION ::= PARAMETER_AND_RESULT_TYPE_PROFILE |
6627 -- PARAMETER_AND_RESULT_TYPE_PROFILE ::= PROCEDURE_PROFILE |
6630 -- PROCEDURE_PROFILE ::= Parameter_Types => PARAMETER_TYPES
6632 -- FUNCTION_PROFILE ::= [Parameter_Types => PARAMETER_TYPES,]
6633 -- Result_Type => result_SUBTYPE_NAME]
6635 -- PARAMETER_TYPES ::= (SUBTYPE_NAME {, SUBTYPE_NAME})
6636 -- SUBTYPE_NAME ::= STRING_LITERAL
6638 -- SOURCE_LOCATION ::= Source_Location => SOURCE_TRACE
6639 -- SOURCE_TRACE ::= STRING_LITERAL
6641 when Pragma_Eliminate => Eliminate : declare
6642 Args : Args_List (1 .. 5);
6643 Names : constant Name_List (1 .. 5) := (
6646 Name_Parameter_Types,
6648 Name_Source_Location);
6650 Unit_Name : Node_Id renames Args (1);
6651 Entity : Node_Id renames Args (2);
6652 Parameter_Types : Node_Id renames Args (3);
6653 Result_Type : Node_Id renames Args (4);
6654 Source_Location : Node_Id renames Args (5);
6658 Check_Valid_Configuration_Pragma;
6659 Gather_Associations (Names, Args);
6661 if No (Unit_Name) then
6662 Error_Pragma ("missing Unit_Name argument for pragma%");
6666 and then (Present (Parameter_Types)
6668 Present (Result_Type)
6670 Present (Source_Location))
6672 Error_Pragma ("missing Entity argument for pragma%");
6675 if (Present (Parameter_Types)
6677 Present (Result_Type))
6679 Present (Source_Location)
6682 ("parameter profile and source location cannot " &
6683 "be used together in pragma%");
6686 Process_Eliminate_Pragma
6700 -- [ Convention =>] convention_IDENTIFIER,
6701 -- [ Entity =>] local_NAME
6702 -- [, [External_Name =>] static_string_EXPRESSION ]
6703 -- [, [Link_Name =>] static_string_EXPRESSION ]);
6705 when Pragma_Export => Export : declare
6709 pragma Warnings (Off, C);
6712 Check_Ada_83_Warning;
6718 Check_At_Least_N_Arguments (2);
6719 Check_At_Most_N_Arguments (4);
6720 Process_Convention (C, Def_Id);
6722 if Ekind (Def_Id) /= E_Constant then
6723 Note_Possible_Modification (Expression (Arg2), Sure => False);
6726 Process_Interface_Name (Def_Id, Arg3, Arg4);
6727 Set_Exported (Def_Id, Arg2);
6729 -- If the entity is a deferred constant, propagate the
6730 -- information to the full view, because gigi elaborates
6731 -- the full view only.
6733 if Ekind (Def_Id) = E_Constant
6734 and then Present (Full_View (Def_Id))
6737 Id2 : constant Entity_Id := Full_View (Def_Id);
6739 Set_Is_Exported (Id2, Is_Exported (Def_Id));
6740 Set_First_Rep_Item (Id2, First_Rep_Item (Def_Id));
6741 Set_Interface_Name (Id2, Einfo.Interface_Name (Def_Id));
6746 ----------------------
6747 -- Export_Exception --
6748 ----------------------
6750 -- pragma Export_Exception (
6751 -- [Internal =>] LOCAL_NAME
6752 -- [, [External =>] EXTERNAL_SYMBOL]
6753 -- [, [Form =>] Ada | VMS]
6754 -- [, [Code =>] static_integer_EXPRESSION]);
6756 when Pragma_Export_Exception => Export_Exception : declare
6757 Args : Args_List (1 .. 4);
6758 Names : constant Name_List (1 .. 4) := (
6764 Internal : Node_Id renames Args (1);
6765 External : Node_Id renames Args (2);
6766 Form : Node_Id renames Args (3);
6767 Code : Node_Id renames Args (4);
6772 if Inside_A_Generic then
6773 Error_Pragma ("pragma% cannot be used for generic entities");
6776 Gather_Associations (Names, Args);
6777 Process_Extended_Import_Export_Exception_Pragma (
6778 Arg_Internal => Internal,
6779 Arg_External => External,
6783 if not Is_VMS_Exception (Entity (Internal)) then
6784 Set_Exported (Entity (Internal), Internal);
6786 end Export_Exception;
6788 ---------------------
6789 -- Export_Function --
6790 ---------------------
6792 -- pragma Export_Function (
6793 -- [Internal =>] LOCAL_NAME
6794 -- [, [External =>] EXTERNAL_SYMBOL]
6795 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6796 -- [, [Result_Type =>] TYPE_DESIGNATOR]
6797 -- [, [Mechanism =>] MECHANISM]
6798 -- [, [Result_Mechanism =>] MECHANISM_NAME]);
6800 -- EXTERNAL_SYMBOL ::=
6802 -- | static_string_EXPRESSION
6804 -- PARAMETER_TYPES ::=
6806 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6808 -- TYPE_DESIGNATOR ::=
6810 -- | subtype_Name ' Access
6814 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6816 -- MECHANISM_ASSOCIATION ::=
6817 -- [formal_parameter_NAME =>] MECHANISM_NAME
6819 -- MECHANISM_NAME ::=
6822 -- | Descriptor [([Class =>] CLASS_NAME)]
6824 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6826 when Pragma_Export_Function => Export_Function : declare
6827 Args : Args_List (1 .. 6);
6828 Names : constant Name_List (1 .. 6) := (
6831 Name_Parameter_Types,
6834 Name_Result_Mechanism);
6836 Internal : Node_Id renames Args (1);
6837 External : Node_Id renames Args (2);
6838 Parameter_Types : Node_Id renames Args (3);
6839 Result_Type : Node_Id renames Args (4);
6840 Mechanism : Node_Id renames Args (5);
6841 Result_Mechanism : Node_Id renames Args (6);
6845 Gather_Associations (Names, Args);
6846 Process_Extended_Import_Export_Subprogram_Pragma (
6847 Arg_Internal => Internal,
6848 Arg_External => External,
6849 Arg_Parameter_Types => Parameter_Types,
6850 Arg_Result_Type => Result_Type,
6851 Arg_Mechanism => Mechanism,
6852 Arg_Result_Mechanism => Result_Mechanism);
6853 end Export_Function;
6859 -- pragma Export_Object (
6860 -- [Internal =>] LOCAL_NAME
6861 -- [, [External =>] EXTERNAL_SYMBOL]
6862 -- [, [Size =>] EXTERNAL_SYMBOL]);
6864 -- EXTERNAL_SYMBOL ::=
6866 -- | static_string_EXPRESSION
6868 -- PARAMETER_TYPES ::=
6870 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6872 -- TYPE_DESIGNATOR ::=
6874 -- | subtype_Name ' Access
6878 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6880 -- MECHANISM_ASSOCIATION ::=
6881 -- [formal_parameter_NAME =>] MECHANISM_NAME
6883 -- MECHANISM_NAME ::=
6886 -- | Descriptor [([Class =>] CLASS_NAME)]
6888 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6890 when Pragma_Export_Object => Export_Object : declare
6891 Args : Args_List (1 .. 3);
6892 Names : constant Name_List (1 .. 3) := (
6897 Internal : Node_Id renames Args (1);
6898 External : Node_Id renames Args (2);
6899 Size : Node_Id renames Args (3);
6903 Gather_Associations (Names, Args);
6904 Process_Extended_Import_Export_Object_Pragma (
6905 Arg_Internal => Internal,
6906 Arg_External => External,
6910 ----------------------
6911 -- Export_Procedure --
6912 ----------------------
6914 -- pragma Export_Procedure (
6915 -- [Internal =>] LOCAL_NAME
6916 -- [, [External =>] EXTERNAL_SYMBOL]
6917 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6918 -- [, [Mechanism =>] MECHANISM]);
6920 -- EXTERNAL_SYMBOL ::=
6922 -- | static_string_EXPRESSION
6924 -- PARAMETER_TYPES ::=
6926 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
6928 -- TYPE_DESIGNATOR ::=
6930 -- | subtype_Name ' Access
6934 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
6936 -- MECHANISM_ASSOCIATION ::=
6937 -- [formal_parameter_NAME =>] MECHANISM_NAME
6939 -- MECHANISM_NAME ::=
6942 -- | Descriptor [([Class =>] CLASS_NAME)]
6944 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
6946 when Pragma_Export_Procedure => Export_Procedure : declare
6947 Args : Args_List (1 .. 4);
6948 Names : constant Name_List (1 .. 4) := (
6951 Name_Parameter_Types,
6954 Internal : Node_Id renames Args (1);
6955 External : Node_Id renames Args (2);
6956 Parameter_Types : Node_Id renames Args (3);
6957 Mechanism : Node_Id renames Args (4);
6961 Gather_Associations (Names, Args);
6962 Process_Extended_Import_Export_Subprogram_Pragma (
6963 Arg_Internal => Internal,
6964 Arg_External => External,
6965 Arg_Parameter_Types => Parameter_Types,
6966 Arg_Mechanism => Mechanism);
6967 end Export_Procedure;
6973 -- pragma Export_Value (
6974 -- [Value =>] static_integer_EXPRESSION,
6975 -- [Link_Name =>] static_string_EXPRESSION);
6977 when Pragma_Export_Value =>
6979 Check_Arg_Order ((Name_Value, Name_Link_Name));
6980 Check_Arg_Count (2);
6982 Check_Optional_Identifier (Arg1, Name_Value);
6983 Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
6985 Check_Optional_Identifier (Arg2, Name_Link_Name);
6986 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
6988 -----------------------------
6989 -- Export_Valued_Procedure --
6990 -----------------------------
6992 -- pragma Export_Valued_Procedure (
6993 -- [Internal =>] LOCAL_NAME
6994 -- [, [External =>] EXTERNAL_SYMBOL,]
6995 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
6996 -- [, [Mechanism =>] MECHANISM]);
6998 -- EXTERNAL_SYMBOL ::=
7000 -- | static_string_EXPRESSION
7002 -- PARAMETER_TYPES ::=
7004 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7006 -- TYPE_DESIGNATOR ::=
7008 -- | subtype_Name ' Access
7012 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7014 -- MECHANISM_ASSOCIATION ::=
7015 -- [formal_parameter_NAME =>] MECHANISM_NAME
7017 -- MECHANISM_NAME ::=
7020 -- | Descriptor [([Class =>] CLASS_NAME)]
7022 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7024 when Pragma_Export_Valued_Procedure =>
7025 Export_Valued_Procedure : declare
7026 Args : Args_List (1 .. 4);
7027 Names : constant Name_List (1 .. 4) := (
7030 Name_Parameter_Types,
7033 Internal : Node_Id renames Args (1);
7034 External : Node_Id renames Args (2);
7035 Parameter_Types : Node_Id renames Args (3);
7036 Mechanism : Node_Id renames Args (4);
7040 Gather_Associations (Names, Args);
7041 Process_Extended_Import_Export_Subprogram_Pragma (
7042 Arg_Internal => Internal,
7043 Arg_External => External,
7044 Arg_Parameter_Types => Parameter_Types,
7045 Arg_Mechanism => Mechanism);
7046 end Export_Valued_Procedure;
7052 -- pragma Extend_System ([Name =>] Identifier);
7054 when Pragma_Extend_System => Extend_System : declare
7057 Check_Valid_Configuration_Pragma;
7058 Check_Arg_Count (1);
7059 Check_Optional_Identifier (Arg1, Name_Name);
7060 Check_Arg_Is_Identifier (Arg1);
7062 Get_Name_String (Chars (Expression (Arg1)));
7065 and then Name_Buffer (1 .. 4) = "aux_"
7067 if Present (System_Extend_Pragma_Arg) then
7068 if Chars (Expression (Arg1)) =
7069 Chars (Expression (System_Extend_Pragma_Arg))
7073 Error_Msg_Sloc := Sloc (System_Extend_Pragma_Arg);
7074 Error_Pragma ("pragma% conflicts with that #");
7078 System_Extend_Pragma_Arg := Arg1;
7080 if not GNAT_Mode then
7081 System_Extend_Unit := Arg1;
7085 Error_Pragma ("incorrect name for pragma%, must be Aux_xxx");
7089 ------------------------
7090 -- Extensions_Allowed --
7091 ------------------------
7093 -- pragma Extensions_Allowed (ON | OFF);
7095 when Pragma_Extensions_Allowed =>
7097 Check_Arg_Count (1);
7098 Check_No_Identifiers;
7099 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
7101 if Chars (Expression (Arg1)) = Name_On then
7102 Extensions_Allowed := True;
7104 Extensions_Allowed := False;
7111 -- pragma External (
7112 -- [ Convention =>] convention_IDENTIFIER,
7113 -- [ Entity =>] local_NAME
7114 -- [, [External_Name =>] static_string_EXPRESSION ]
7115 -- [, [Link_Name =>] static_string_EXPRESSION ]);
7117 when Pragma_External => External : declare
7121 pragma Warnings (Off, C);
7130 Check_At_Least_N_Arguments (2);
7131 Check_At_Most_N_Arguments (4);
7132 Process_Convention (C, Def_Id);
7133 Note_Possible_Modification (Expression (Arg2), Sure => False);
7134 Process_Interface_Name (Def_Id, Arg3, Arg4);
7135 Set_Exported (Def_Id, Arg2);
7138 --------------------------
7139 -- External_Name_Casing --
7140 --------------------------
7142 -- pragma External_Name_Casing (
7143 -- UPPERCASE | LOWERCASE
7144 -- [, AS_IS | UPPERCASE | LOWERCASE]);
7146 when Pragma_External_Name_Casing => External_Name_Casing : declare
7149 Check_No_Identifiers;
7151 if Arg_Count = 2 then
7153 (Arg2, Name_As_Is, Name_Uppercase, Name_Lowercase);
7155 case Chars (Get_Pragma_Arg (Arg2)) is
7157 Opt.External_Name_Exp_Casing := As_Is;
7159 when Name_Uppercase =>
7160 Opt.External_Name_Exp_Casing := Uppercase;
7162 when Name_Lowercase =>
7163 Opt.External_Name_Exp_Casing := Lowercase;
7170 Check_Arg_Count (1);
7173 Check_Arg_Is_One_Of (Arg1, Name_Uppercase, Name_Lowercase);
7175 case Chars (Get_Pragma_Arg (Arg1)) is
7176 when Name_Uppercase =>
7177 Opt.External_Name_Imp_Casing := Uppercase;
7179 when Name_Lowercase =>
7180 Opt.External_Name_Imp_Casing := Lowercase;
7185 end External_Name_Casing;
7187 --------------------------
7188 -- Favor_Top_Level --
7189 --------------------------
7191 -- pragma Favor_Top_Level (type_NAME);
7193 when Pragma_Favor_Top_Level => Favor_Top_Level : declare
7194 Named_Entity : Entity_Id;
7198 Check_No_Identifiers;
7199 Check_Arg_Count (1);
7200 Check_Arg_Is_Local_Name (Arg1);
7201 Named_Entity := Entity (Expression (Arg1));
7203 -- If it's an access-to-subprogram type (in particular, not a
7204 -- subtype), set the flag on that type.
7206 if Is_Access_Subprogram_Type (Named_Entity) then
7207 Set_Can_Use_Internal_Rep (Named_Entity, False);
7209 -- Otherwise it's an error (name denotes the wrong sort of entity)
7213 ("access-to-subprogram type expected", Expression (Arg1));
7215 end Favor_Top_Level;
7221 -- pragma Fast_Math;
7223 when Pragma_Fast_Math =>
7225 Check_No_Identifiers;
7226 Check_Valid_Configuration_Pragma;
7229 ---------------------------
7230 -- Finalize_Storage_Only --
7231 ---------------------------
7233 -- pragma Finalize_Storage_Only (first_subtype_LOCAL_NAME);
7235 when Pragma_Finalize_Storage_Only => Finalize_Storage : declare
7236 Assoc : constant Node_Id := Arg1;
7237 Type_Id : constant Node_Id := Expression (Assoc);
7242 Check_No_Identifiers;
7243 Check_Arg_Count (1);
7244 Check_Arg_Is_Local_Name (Arg1);
7246 Find_Type (Type_Id);
7247 Typ := Entity (Type_Id);
7250 or else Rep_Item_Too_Early (Typ, N)
7254 Typ := Underlying_Type (Typ);
7257 if not Is_Controlled (Typ) then
7258 Error_Pragma ("pragma% must specify controlled type");
7261 Check_First_Subtype (Arg1);
7263 if Finalize_Storage_Only (Typ) then
7264 Error_Pragma ("duplicate pragma%, only one allowed");
7266 elsif not Rep_Item_Too_Late (Typ, N) then
7267 Set_Finalize_Storage_Only (Base_Type (Typ), True);
7269 end Finalize_Storage;
7271 --------------------------
7272 -- Float_Representation --
7273 --------------------------
7275 -- pragma Float_Representation (FLOAT_REP[, float_type_LOCAL_NAME]);
7277 -- FLOAT_REP ::= VAX_Float | IEEE_Float
7279 when Pragma_Float_Representation => Float_Representation : declare
7287 if Arg_Count = 1 then
7288 Check_Valid_Configuration_Pragma;
7290 Check_Arg_Count (2);
7291 Check_Optional_Identifier (Arg2, Name_Entity);
7292 Check_Arg_Is_Local_Name (Arg2);
7295 Check_No_Identifier (Arg1);
7296 Check_Arg_Is_One_Of (Arg1, Name_VAX_Float, Name_IEEE_Float);
7298 if not OpenVMS_On_Target then
7299 if Chars (Expression (Arg1)) = Name_VAX_Float then
7301 ("?pragma% ignored (applies only to Open'V'M'S)");
7307 -- One argument case
7309 if Arg_Count = 1 then
7310 if Chars (Expression (Arg1)) = Name_VAX_Float then
7311 if Opt.Float_Format = 'I' then
7312 Error_Pragma ("'I'E'E'E format previously specified");
7315 Opt.Float_Format := 'V';
7318 if Opt.Float_Format = 'V' then
7319 Error_Pragma ("'V'A'X format previously specified");
7322 Opt.Float_Format := 'I';
7325 Set_Standard_Fpt_Formats;
7327 -- Two argument case
7330 Argx := Get_Pragma_Arg (Arg2);
7332 if not Is_Entity_Name (Argx)
7333 or else not Is_Floating_Point_Type (Entity (Argx))
7336 ("second argument of% pragma must be floating-point type",
7340 Ent := Entity (Argx);
7341 Digs := UI_To_Int (Digits_Value (Ent));
7343 -- Two arguments, VAX_Float case
7345 if Chars (Expression (Arg1)) = Name_VAX_Float then
7347 when 6 => Set_F_Float (Ent);
7348 when 9 => Set_D_Float (Ent);
7349 when 15 => Set_G_Float (Ent);
7353 ("wrong digits value, must be 6,9 or 15", Arg2);
7356 -- Two arguments, IEEE_Float case
7360 when 6 => Set_IEEE_Short (Ent);
7361 when 15 => Set_IEEE_Long (Ent);
7365 ("wrong digits value, must be 6 or 15", Arg2);
7369 end Float_Representation;
7375 -- pragma Ident (static_string_EXPRESSION)
7377 -- Note: pragma Comment shares this processing. Pragma Comment
7378 -- is identical to Ident, except that the restriction of the
7379 -- argument to 31 characters and the placement restrictions
7380 -- are not enforced for pragma Comment.
7382 when Pragma_Ident | Pragma_Comment => Ident : declare
7387 Check_Arg_Count (1);
7388 Check_No_Identifiers;
7389 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
7391 -- For pragma Ident, preserve DEC compatibility by requiring
7392 -- the pragma to appear in a declarative part or package spec.
7394 if Prag_Id = Pragma_Ident then
7395 Check_Is_In_Decl_Part_Or_Package_Spec;
7398 Str := Expr_Value_S (Expression (Arg1));
7405 GP := Parent (Parent (N));
7407 if Nkind (GP) = N_Package_Declaration
7409 Nkind (GP) = N_Generic_Package_Declaration
7414 -- If we have a compilation unit, then record the ident
7415 -- value, checking for improper duplication.
7417 if Nkind (GP) = N_Compilation_Unit then
7418 CS := Ident_String (Current_Sem_Unit);
7420 if Present (CS) then
7422 -- For Ident, we do not permit multiple instances
7424 if Prag_Id = Pragma_Ident then
7425 Error_Pragma ("duplicate% pragma not permitted");
7427 -- For Comment, we concatenate the string, unless we
7428 -- want to preserve the tree structure for ASIS.
7430 elsif not ASIS_Mode then
7431 Start_String (Strval (CS));
7432 Store_String_Char (' ');
7433 Store_String_Chars (Strval (Str));
7434 Set_Strval (CS, End_String);
7438 -- In VMS, the effect of IDENT is achieved by passing
7439 -- IDENTIFICATION=name as a --for-linker switch.
7441 if OpenVMS_On_Target then
7444 ("--for-linker=IDENTIFICATION=");
7445 String_To_Name_Buffer (Strval (Str));
7446 Store_String_Chars (Name_Buffer (1 .. Name_Len));
7448 -- Only the last processed IDENT is saved. The main
7449 -- purpose is so an IDENT associated with a main
7450 -- procedure will be used in preference to an IDENT
7451 -- associated with a with'd package.
7453 Replace_Linker_Option_String
7454 (End_String, "--for-linker=IDENTIFICATION=");
7457 Set_Ident_String (Current_Sem_Unit, Str);
7460 -- For subunits, we just ignore the Ident, since in GNAT
7461 -- these are not separate object files, and hence not
7462 -- separate units in the unit table.
7464 elsif Nkind (GP) = N_Subunit then
7467 -- Otherwise we have a misplaced pragma Ident, but we ignore
7468 -- this if we are in an instantiation, since it comes from
7469 -- a generic, and has no relevance to the instantiation.
7471 elsif Prag_Id = Pragma_Ident then
7472 if Instantiation_Location (Loc) = No_Location then
7473 Error_Pragma ("pragma% only allowed at outer level");
7479 --------------------------
7480 -- Implemented_By_Entry --
7481 --------------------------
7483 -- pragma Implemented_By_Entry (DIRECT_NAME);
7485 when Pragma_Implemented_By_Entry => Implemented_By_Entry : declare
7490 Check_Arg_Count (1);
7491 Check_No_Identifiers;
7492 Check_Arg_Is_Identifier (Arg1);
7493 Check_Arg_Is_Local_Name (Arg1);
7494 Ent := Entity (Expression (Arg1));
7496 -- Pragma Implemented_By_Entry must be applied only to protected
7497 -- synchronized or task interface primitives.
7499 if (Ekind (Ent) /= E_Function
7500 and then Ekind (Ent) /= E_Procedure)
7501 or else not Present (First_Formal (Ent))
7502 or else not Is_Concurrent_Interface (Etype (First_Formal (Ent)))
7505 ("pragma % must be applied to a concurrent interface " &
7509 if Einfo.Implemented_By_Entry (Ent)
7510 and then Warn_On_Redundant_Constructs
7512 Error_Pragma ("?duplicate pragma%!");
7514 Set_Implemented_By_Entry (Ent);
7517 end Implemented_By_Entry;
7519 -----------------------
7520 -- Implicit_Packing --
7521 -----------------------
7523 -- pragma Implicit_Packing;
7525 when Pragma_Implicit_Packing =>
7527 Check_Arg_Count (0);
7528 Implicit_Packing := True;
7535 -- [Convention =>] convention_IDENTIFIER,
7536 -- [Entity =>] local_NAME
7537 -- [, [External_Name =>] static_string_EXPRESSION ]
7538 -- [, [Link_Name =>] static_string_EXPRESSION ]);
7540 when Pragma_Import =>
7541 Check_Ada_83_Warning;
7547 Check_At_Least_N_Arguments (2);
7548 Check_At_Most_N_Arguments (4);
7549 Process_Import_Or_Interface;
7551 ----------------------
7552 -- Import_Exception --
7553 ----------------------
7555 -- pragma Import_Exception (
7556 -- [Internal =>] LOCAL_NAME
7557 -- [, [External =>] EXTERNAL_SYMBOL]
7558 -- [, [Form =>] Ada | VMS]
7559 -- [, [Code =>] static_integer_EXPRESSION]);
7561 when Pragma_Import_Exception => Import_Exception : declare
7562 Args : Args_List (1 .. 4);
7563 Names : constant Name_List (1 .. 4) := (
7569 Internal : Node_Id renames Args (1);
7570 External : Node_Id renames Args (2);
7571 Form : Node_Id renames Args (3);
7572 Code : Node_Id renames Args (4);
7576 Gather_Associations (Names, Args);
7578 if Present (External) and then Present (Code) then
7580 ("cannot give both External and Code options for pragma%");
7583 Process_Extended_Import_Export_Exception_Pragma (
7584 Arg_Internal => Internal,
7585 Arg_External => External,
7589 if not Is_VMS_Exception (Entity (Internal)) then
7590 Set_Imported (Entity (Internal));
7592 end Import_Exception;
7594 ---------------------
7595 -- Import_Function --
7596 ---------------------
7598 -- pragma Import_Function (
7599 -- [Internal =>] LOCAL_NAME,
7600 -- [, [External =>] EXTERNAL_SYMBOL]
7601 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
7602 -- [, [Result_Type =>] SUBTYPE_MARK]
7603 -- [, [Mechanism =>] MECHANISM]
7604 -- [, [Result_Mechanism =>] MECHANISM_NAME]
7605 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
7607 -- EXTERNAL_SYMBOL ::=
7609 -- | static_string_EXPRESSION
7611 -- PARAMETER_TYPES ::=
7613 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7615 -- TYPE_DESIGNATOR ::=
7617 -- | subtype_Name ' Access
7621 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7623 -- MECHANISM_ASSOCIATION ::=
7624 -- [formal_parameter_NAME =>] MECHANISM_NAME
7626 -- MECHANISM_NAME ::=
7629 -- | Descriptor [([Class =>] CLASS_NAME)]
7631 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7633 when Pragma_Import_Function => Import_Function : declare
7634 Args : Args_List (1 .. 7);
7635 Names : constant Name_List (1 .. 7) := (
7638 Name_Parameter_Types,
7641 Name_Result_Mechanism,
7642 Name_First_Optional_Parameter);
7644 Internal : Node_Id renames Args (1);
7645 External : Node_Id renames Args (2);
7646 Parameter_Types : Node_Id renames Args (3);
7647 Result_Type : Node_Id renames Args (4);
7648 Mechanism : Node_Id renames Args (5);
7649 Result_Mechanism : Node_Id renames Args (6);
7650 First_Optional_Parameter : Node_Id renames Args (7);
7654 Gather_Associations (Names, Args);
7655 Process_Extended_Import_Export_Subprogram_Pragma (
7656 Arg_Internal => Internal,
7657 Arg_External => External,
7658 Arg_Parameter_Types => Parameter_Types,
7659 Arg_Result_Type => Result_Type,
7660 Arg_Mechanism => Mechanism,
7661 Arg_Result_Mechanism => Result_Mechanism,
7662 Arg_First_Optional_Parameter => First_Optional_Parameter);
7663 end Import_Function;
7669 -- pragma Import_Object (
7670 -- [Internal =>] LOCAL_NAME
7671 -- [, [External =>] EXTERNAL_SYMBOL]
7672 -- [, [Size =>] EXTERNAL_SYMBOL]);
7674 -- EXTERNAL_SYMBOL ::=
7676 -- | static_string_EXPRESSION
7678 when Pragma_Import_Object => Import_Object : declare
7679 Args : Args_List (1 .. 3);
7680 Names : constant Name_List (1 .. 3) := (
7685 Internal : Node_Id renames Args (1);
7686 External : Node_Id renames Args (2);
7687 Size : Node_Id renames Args (3);
7691 Gather_Associations (Names, Args);
7692 Process_Extended_Import_Export_Object_Pragma (
7693 Arg_Internal => Internal,
7694 Arg_External => External,
7698 ----------------------
7699 -- Import_Procedure --
7700 ----------------------
7702 -- pragma Import_Procedure (
7703 -- [Internal =>] LOCAL_NAME
7704 -- [, [External =>] EXTERNAL_SYMBOL]
7705 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
7706 -- [, [Mechanism =>] MECHANISM]
7707 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
7709 -- EXTERNAL_SYMBOL ::=
7711 -- | static_string_EXPRESSION
7713 -- PARAMETER_TYPES ::=
7715 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7717 -- TYPE_DESIGNATOR ::=
7719 -- | subtype_Name ' Access
7723 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7725 -- MECHANISM_ASSOCIATION ::=
7726 -- [formal_parameter_NAME =>] MECHANISM_NAME
7728 -- MECHANISM_NAME ::=
7731 -- | Descriptor [([Class =>] CLASS_NAME)]
7733 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7735 when Pragma_Import_Procedure => Import_Procedure : declare
7736 Args : Args_List (1 .. 5);
7737 Names : constant Name_List (1 .. 5) := (
7740 Name_Parameter_Types,
7742 Name_First_Optional_Parameter);
7744 Internal : Node_Id renames Args (1);
7745 External : Node_Id renames Args (2);
7746 Parameter_Types : Node_Id renames Args (3);
7747 Mechanism : Node_Id renames Args (4);
7748 First_Optional_Parameter : Node_Id renames Args (5);
7752 Gather_Associations (Names, Args);
7753 Process_Extended_Import_Export_Subprogram_Pragma (
7754 Arg_Internal => Internal,
7755 Arg_External => External,
7756 Arg_Parameter_Types => Parameter_Types,
7757 Arg_Mechanism => Mechanism,
7758 Arg_First_Optional_Parameter => First_Optional_Parameter);
7759 end Import_Procedure;
7761 -----------------------------
7762 -- Import_Valued_Procedure --
7763 -----------------------------
7765 -- pragma Import_Valued_Procedure (
7766 -- [Internal =>] LOCAL_NAME
7767 -- [, [External =>] EXTERNAL_SYMBOL]
7768 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
7769 -- [, [Mechanism =>] MECHANISM]
7770 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
7772 -- EXTERNAL_SYMBOL ::=
7774 -- | static_string_EXPRESSION
7776 -- PARAMETER_TYPES ::=
7778 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7780 -- TYPE_DESIGNATOR ::=
7782 -- | subtype_Name ' Access
7786 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7788 -- MECHANISM_ASSOCIATION ::=
7789 -- [formal_parameter_NAME =>] MECHANISM_NAME
7791 -- MECHANISM_NAME ::=
7794 -- | Descriptor [([Class =>] CLASS_NAME)]
7796 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7798 when Pragma_Import_Valued_Procedure =>
7799 Import_Valued_Procedure : declare
7800 Args : Args_List (1 .. 5);
7801 Names : constant Name_List (1 .. 5) := (
7804 Name_Parameter_Types,
7806 Name_First_Optional_Parameter);
7808 Internal : Node_Id renames Args (1);
7809 External : Node_Id renames Args (2);
7810 Parameter_Types : Node_Id renames Args (3);
7811 Mechanism : Node_Id renames Args (4);
7812 First_Optional_Parameter : Node_Id renames Args (5);
7816 Gather_Associations (Names, Args);
7817 Process_Extended_Import_Export_Subprogram_Pragma (
7818 Arg_Internal => Internal,
7819 Arg_External => External,
7820 Arg_Parameter_Types => Parameter_Types,
7821 Arg_Mechanism => Mechanism,
7822 Arg_First_Optional_Parameter => First_Optional_Parameter);
7823 end Import_Valued_Procedure;
7825 ------------------------
7826 -- Initialize_Scalars --
7827 ------------------------
7829 -- pragma Initialize_Scalars;
7831 when Pragma_Initialize_Scalars =>
7833 Check_Arg_Count (0);
7834 Check_Valid_Configuration_Pragma;
7835 Check_Restriction (No_Initialize_Scalars, N);
7837 if not Restriction_Active (No_Initialize_Scalars) then
7838 Init_Or_Norm_Scalars := True;
7839 Initialize_Scalars := True;
7846 -- pragma Inline ( NAME {, NAME} );
7848 when Pragma_Inline =>
7850 -- Pragma is active if inlining option is active
7852 Process_Inline (Inline_Active);
7858 -- pragma Inline_Always ( NAME {, NAME} );
7860 when Pragma_Inline_Always =>
7862 Process_Inline (True);
7864 --------------------
7865 -- Inline_Generic --
7866 --------------------
7868 -- pragma Inline_Generic (NAME {, NAME});
7870 when Pragma_Inline_Generic =>
7872 Process_Generic_List;
7874 ----------------------
7875 -- Inspection_Point --
7876 ----------------------
7878 -- pragma Inspection_Point [(object_NAME {, object_NAME})];
7880 when Pragma_Inspection_Point => Inspection_Point : declare
7885 if Arg_Count > 0 then
7888 Exp := Expression (Arg);
7891 if not Is_Entity_Name (Exp)
7892 or else not Is_Object (Entity (Exp))
7894 Error_Pragma_Arg ("object name required", Arg);
7901 end Inspection_Point;
7907 -- pragma Interface (
7908 -- [ Convention =>] convention_IDENTIFIER,
7909 -- [ Entity =>] local_NAME
7910 -- [, [External_Name =>] static_string_EXPRESSION ]
7911 -- [, [Link_Name =>] static_string_EXPRESSION ]);
7913 when Pragma_Interface =>
7920 Check_At_Least_N_Arguments (2);
7921 Check_At_Most_N_Arguments (4);
7922 Process_Import_Or_Interface;
7924 --------------------
7925 -- Interface_Name --
7926 --------------------
7928 -- pragma Interface_Name (
7929 -- [ Entity =>] local_NAME
7930 -- [,[External_Name =>] static_string_EXPRESSION ]
7931 -- [,[Link_Name =>] static_string_EXPRESSION ]);
7933 when Pragma_Interface_Name => Interface_Name : declare
7942 ((Name_Entity, Name_External_Name, Name_Link_Name));
7943 Check_At_Least_N_Arguments (2);
7944 Check_At_Most_N_Arguments (3);
7945 Id := Expression (Arg1);
7948 if not Is_Entity_Name (Id) then
7950 ("first argument for pragma% must be entity name", Arg1);
7951 elsif Etype (Id) = Any_Type then
7954 Def_Id := Entity (Id);
7957 -- Special DEC-compatible processing for the object case, forces
7958 -- object to be imported.
7960 if Ekind (Def_Id) = E_Variable then
7961 Kill_Size_Check_Code (Def_Id);
7962 Note_Possible_Modification (Id, Sure => False);
7964 -- Initialization is not allowed for imported variable
7966 if Present (Expression (Parent (Def_Id)))
7967 and then Comes_From_Source (Expression (Parent (Def_Id)))
7969 Error_Msg_Sloc := Sloc (Def_Id);
7971 ("no initialization allowed for declaration of& #",
7975 -- For compatibility, support VADS usage of providing both
7976 -- pragmas Interface and Interface_Name to obtain the effect
7977 -- of a single Import pragma.
7979 if Is_Imported (Def_Id)
7980 and then Present (First_Rep_Item (Def_Id))
7981 and then Nkind (First_Rep_Item (Def_Id)) = N_Pragma
7983 Pragma_Name (First_Rep_Item (Def_Id)) = Name_Interface
7987 Set_Imported (Def_Id);
7990 Set_Is_Public (Def_Id);
7991 Process_Interface_Name (Def_Id, Arg2, Arg3);
7994 -- Otherwise must be subprogram
7996 elsif not Is_Subprogram (Def_Id) then
7998 ("argument of pragma% is not subprogram", Arg1);
8001 Check_At_Most_N_Arguments (3);
8005 -- Loop through homonyms
8008 Def_Id := Get_Base_Subprogram (Hom_Id);
8010 if Is_Imported (Def_Id) then
8011 Process_Interface_Name (Def_Id, Arg2, Arg3);
8015 Hom_Id := Homonym (Hom_Id);
8017 exit when No (Hom_Id)
8018 or else Scope (Hom_Id) /= Current_Scope;
8023 ("argument of pragma% is not imported subprogram",
8029 -----------------------
8030 -- Interrupt_Handler --
8031 -----------------------
8033 -- pragma Interrupt_Handler (handler_NAME);
8035 when Pragma_Interrupt_Handler =>
8036 Check_Ada_83_Warning;
8037 Check_Arg_Count (1);
8038 Check_No_Identifiers;
8040 if No_Run_Time_Mode then
8041 Error_Msg_CRT ("Interrupt_Handler pragma", N);
8043 Check_Interrupt_Or_Attach_Handler;
8044 Process_Interrupt_Or_Attach_Handler;
8047 ------------------------
8048 -- Interrupt_Priority --
8049 ------------------------
8051 -- pragma Interrupt_Priority [(EXPRESSION)];
8053 when Pragma_Interrupt_Priority => Interrupt_Priority : declare
8054 P : constant Node_Id := Parent (N);
8058 Check_Ada_83_Warning;
8060 if Arg_Count /= 0 then
8061 Arg := Expression (Arg1);
8062 Check_Arg_Count (1);
8063 Check_No_Identifiers;
8065 -- The expression must be analyzed in the special manner
8066 -- described in "Handling of Default and Per-Object
8067 -- Expressions" in sem.ads.
8069 Preanalyze_Spec_Expression (Arg, RTE (RE_Interrupt_Priority));
8072 if Nkind (P) /= N_Task_Definition
8073 and then Nkind (P) /= N_Protected_Definition
8078 elsif Has_Priority_Pragma (P) then
8079 Error_Pragma ("duplicate pragma% not allowed");
8082 Set_Has_Priority_Pragma (P, True);
8083 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
8085 end Interrupt_Priority;
8087 ---------------------
8088 -- Interrupt_State --
8089 ---------------------
8091 -- pragma Interrupt_State (
8092 -- [Name =>] INTERRUPT_ID,
8093 -- [State =>] INTERRUPT_STATE);
8095 -- INTERRUPT_ID => IDENTIFIER | static_integer_EXPRESSION
8096 -- INTERRUPT_STATE => System | Runtime | User
8098 -- Note: if the interrupt id is given as an identifier, then
8099 -- it must be one of the identifiers in Ada.Interrupts.Names.
8100 -- Otherwise it is given as a static integer expression which
8101 -- must be in the range of Ada.Interrupts.Interrupt_ID.
8103 when Pragma_Interrupt_State => Interrupt_State : declare
8105 Int_Id : constant Entity_Id := RTE (RE_Interrupt_ID);
8106 -- This is the entity Ada.Interrupts.Interrupt_ID;
8108 State_Type : Character;
8109 -- Set to 's'/'r'/'u' for System/Runtime/User
8112 -- Index to entry in Interrupt_States table
8115 -- Value of interrupt
8117 Arg1X : constant Node_Id := Get_Pragma_Arg (Arg1);
8118 -- The first argument to the pragma
8120 Int_Ent : Entity_Id;
8121 -- Interrupt entity in Ada.Interrupts.Names
8125 Check_Arg_Order ((Name_Name, Name_State));
8126 Check_Arg_Count (2);
8128 Check_Optional_Identifier (Arg1, Name_Name);
8129 Check_Optional_Identifier (Arg2, Name_State);
8130 Check_Arg_Is_Identifier (Arg2);
8132 -- First argument is identifier
8134 if Nkind (Arg1X) = N_Identifier then
8136 -- Search list of names in Ada.Interrupts.Names
8138 Int_Ent := First_Entity (RTE (RE_Names));
8140 if No (Int_Ent) then
8141 Error_Pragma_Arg ("invalid interrupt name", Arg1);
8143 elsif Chars (Int_Ent) = Chars (Arg1X) then
8144 Int_Val := Expr_Value (Constant_Value (Int_Ent));
8148 Next_Entity (Int_Ent);
8151 -- First argument is not an identifier, so it must be a
8152 -- static expression of type Ada.Interrupts.Interrupt_ID.
8155 Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
8156 Int_Val := Expr_Value (Arg1X);
8158 if Int_Val < Expr_Value (Type_Low_Bound (Int_Id))
8160 Int_Val > Expr_Value (Type_High_Bound (Int_Id))
8163 ("value not in range of type " &
8164 """Ada.Interrupts.Interrupt_'I'D""", Arg1);
8170 case Chars (Get_Pragma_Arg (Arg2)) is
8171 when Name_Runtime => State_Type := 'r';
8172 when Name_System => State_Type := 's';
8173 when Name_User => State_Type := 'u';
8176 Error_Pragma_Arg ("invalid interrupt state", Arg2);
8179 -- Check if entry is already stored
8181 IST_Num := Interrupt_States.First;
8183 -- If entry not found, add it
8185 if IST_Num > Interrupt_States.Last then
8186 Interrupt_States.Append
8187 ((Interrupt_Number => UI_To_Int (Int_Val),
8188 Interrupt_State => State_Type,
8189 Pragma_Loc => Loc));
8192 -- Case of entry for the same entry
8194 elsif Int_Val = Interrupt_States.Table (IST_Num).
8197 -- If state matches, done, no need to make redundant entry
8200 State_Type = Interrupt_States.Table (IST_Num).
8203 -- Otherwise if state does not match, error
8206 Interrupt_States.Table (IST_Num).Pragma_Loc;
8208 ("state conflicts with that given #", Arg2);
8212 IST_Num := IST_Num + 1;
8214 end Interrupt_State;
8216 ----------------------
8217 -- Java_Constructor --
8218 ----------------------
8220 -- pragma Java_Constructor ([Entity =>] LOCAL_NAME);
8222 -- Also handles pragma CIL_Constructor
8224 when Pragma_CIL_Constructor | Pragma_Java_Constructor =>
8225 Java_Constructor : declare
8229 Convention : Convention_Id;
8233 Check_Arg_Count (1);
8234 Check_Optional_Identifier (Arg1, Name_Entity);
8235 Check_Arg_Is_Local_Name (Arg1);
8237 Id := Expression (Arg1);
8238 Find_Program_Unit_Name (Id);
8240 -- If we did not find the name, we are done
8242 if Etype (Id) = Any_Type then
8247 when Pragma_CIL_Constructor => Convention := Convention_CIL;
8248 when Pragma_Java_Constructor => Convention := Convention_Java;
8249 when others => null;
8252 Hom_Id := Entity (Id);
8254 -- Loop through homonyms
8257 Def_Id := Get_Base_Subprogram (Hom_Id);
8259 -- The constructor is required to be a function returning an
8260 -- access type whose designated type has convention Java/CIL.
8262 if Ekind (Def_Id) = E_Function
8264 (Is_Value_Type (Etype (Def_Id))
8266 (Ekind (Etype (Def_Id)) in Access_Kind
8269 (Designated_Type (Etype (Def_Id))) = Convention
8272 (Root_Type (Designated_Type (Etype (Def_Id)))) =
8275 Set_Is_Constructor (Def_Id);
8276 Set_Convention (Def_Id, Convention);
8277 Set_Is_Imported (Def_Id);
8280 if Convention = Convention_Java then
8282 ("pragma% requires function returning a " &
8283 "'Java access type", Arg1);
8285 pragma Assert (Convention = Convention_CIL);
8287 ("pragma% requires function returning a " &
8288 "'CIL access type", Arg1);
8292 Hom_Id := Homonym (Hom_Id);
8294 exit when No (Hom_Id) or else Scope (Hom_Id) /= Current_Scope;
8296 end Java_Constructor;
8298 ----------------------
8299 -- Java_Interface --
8300 ----------------------
8302 -- pragma Java_Interface ([Entity =>] LOCAL_NAME);
8304 when Pragma_Java_Interface => Java_Interface : declare
8310 Check_Arg_Count (1);
8311 Check_Optional_Identifier (Arg1, Name_Entity);
8312 Check_Arg_Is_Local_Name (Arg1);
8314 Arg := Expression (Arg1);
8317 if Etype (Arg) = Any_Type then
8321 if not Is_Entity_Name (Arg)
8322 or else not Is_Type (Entity (Arg))
8324 Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
8327 Typ := Underlying_Type (Entity (Arg));
8329 -- For now we simply check some of the semantic constraints
8330 -- on the type. This currently leaves out some restrictions
8331 -- on interface types, namely that the parent type must be
8332 -- java.lang.Object.Typ and that all primitives of the type
8333 -- should be declared abstract. ???
8335 if not Is_Tagged_Type (Typ) or else not Is_Abstract_Type (Typ) then
8336 Error_Pragma_Arg ("pragma% requires an abstract "
8337 & "tagged type", Arg1);
8339 elsif not Has_Discriminants (Typ)
8340 or else Ekind (Etype (First_Discriminant (Typ)))
8341 /= E_Anonymous_Access_Type
8343 not Is_Class_Wide_Type
8344 (Designated_Type (Etype (First_Discriminant (Typ))))
8347 ("type must have a class-wide access discriminant", Arg1);
8355 -- pragma Keep_Names ([On => ] local_NAME);
8357 when Pragma_Keep_Names => Keep_Names : declare
8362 Check_Arg_Count (1);
8363 Check_Optional_Identifier (Arg1, Name_On);
8364 Check_Arg_Is_Local_Name (Arg1);
8366 Arg := Expression (Arg1);
8369 if Etype (Arg) = Any_Type then
8373 if not Is_Entity_Name (Arg)
8374 or else Ekind (Entity (Arg)) /= E_Enumeration_Type
8377 ("pragma% requires a local enumeration type", Arg1);
8380 Set_Discard_Names (Entity (Arg), False);
8387 -- pragma License (RESTRICTED | UNRESTRICTED | GPL | MODIFIED_GPL);
8389 when Pragma_License =>
8391 Check_Arg_Count (1);
8392 Check_No_Identifiers;
8393 Check_Valid_Configuration_Pragma;
8394 Check_Arg_Is_Identifier (Arg1);
8397 Sind : constant Source_File_Index :=
8398 Source_Index (Current_Sem_Unit);
8401 case Chars (Get_Pragma_Arg (Arg1)) is
8403 Set_License (Sind, GPL);
8405 when Name_Modified_GPL =>
8406 Set_License (Sind, Modified_GPL);
8408 when Name_Restricted =>
8409 Set_License (Sind, Restricted);
8411 when Name_Unrestricted =>
8412 Set_License (Sind, Unrestricted);
8415 Error_Pragma_Arg ("invalid license name", Arg1);
8423 -- pragma Link_With (string_EXPRESSION {, string_EXPRESSION});
8425 when Pragma_Link_With => Link_With : declare
8431 if Operating_Mode = Generate_Code
8432 and then In_Extended_Main_Source_Unit (N)
8434 Check_At_Least_N_Arguments (1);
8435 Check_No_Identifiers;
8436 Check_Is_In_Decl_Part_Or_Package_Spec;
8437 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
8441 while Present (Arg) loop
8442 Check_Arg_Is_Static_Expression (Arg, Standard_String);
8444 -- Store argument, converting sequences of spaces
8445 -- to a single null character (this is one of the
8446 -- differences in processing between Link_With
8447 -- and Linker_Options).
8450 C : constant Char_Code := Get_Char_Code (' ');
8451 S : constant String_Id :=
8452 Strval (Expr_Value_S (Expression (Arg)));
8453 L : constant Nat := String_Length (S);
8456 procedure Skip_Spaces;
8457 -- Advance F past any spaces
8463 procedure Skip_Spaces is
8465 while F <= L and then Get_String_Char (S, F) = C loop
8470 -- Start of processing for Arg_Store
8473 Skip_Spaces; -- skip leading spaces
8475 -- Loop through characters, changing any embedded
8476 -- sequence of spaces to a single null character
8477 -- (this is how Link_With/Linker_Options differ)
8480 if Get_String_Char (S, F) = C then
8483 Store_String_Char (ASCII.NUL);
8486 Store_String_Char (Get_String_Char (S, F));
8494 if Present (Arg) then
8495 Store_String_Char (ASCII.NUL);
8499 Store_Linker_Option_String (End_String);
8507 -- pragma Linker_Alias (
8508 -- [Entity =>] LOCAL_NAME
8509 -- [Target =>] static_string_EXPRESSION);
8511 when Pragma_Linker_Alias =>
8513 Check_Arg_Order ((Name_Entity, Name_Target));
8514 Check_Arg_Count (2);
8515 Check_Optional_Identifier (Arg1, Name_Entity);
8516 Check_Optional_Identifier (Arg2, Name_Target);
8517 Check_Arg_Is_Library_Level_Local_Name (Arg1);
8518 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
8520 -- The only processing required is to link this item on to the
8521 -- list of rep items for the given entity. This is accomplished
8522 -- by the call to Rep_Item_Too_Late (when no error is detected
8523 -- and False is returned).
8525 if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
8528 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
8531 ------------------------
8532 -- Linker_Constructor --
8533 ------------------------
8535 -- pragma Linker_Constructor (procedure_LOCAL_NAME);
8537 -- Code is shared with Linker_Destructor
8539 -----------------------
8540 -- Linker_Destructor --
8541 -----------------------
8543 -- pragma Linker_Destructor (procedure_LOCAL_NAME);
8545 when Pragma_Linker_Constructor |
8546 Pragma_Linker_Destructor =>
8547 Linker_Constructor : declare
8553 Check_Arg_Count (1);
8554 Check_No_Identifiers;
8555 Check_Arg_Is_Local_Name (Arg1);
8556 Arg1_X := Expression (Arg1);
8558 Proc := Find_Unique_Parameterless_Procedure (Arg1_X, Arg1);
8560 if not Is_Library_Level_Entity (Proc) then
8562 ("argument for pragma% must be library level entity", Arg1);
8565 -- The only processing required is to link this item on to the
8566 -- list of rep items for the given entity. This is accomplished
8567 -- by the call to Rep_Item_Too_Late (when no error is detected
8568 -- and False is returned).
8570 if Rep_Item_Too_Late (Proc, N) then
8573 Set_Has_Gigi_Rep_Item (Proc);
8575 end Linker_Constructor;
8577 --------------------
8578 -- Linker_Options --
8579 --------------------
8581 -- pragma Linker_Options (string_EXPRESSION {, string_EXPRESSION});
8583 when Pragma_Linker_Options => Linker_Options : declare
8587 Check_Ada_83_Warning;
8588 Check_No_Identifiers;
8589 Check_Arg_Count (1);
8590 Check_Is_In_Decl_Part_Or_Package_Spec;
8591 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
8592 Start_String (Strval (Expr_Value_S (Expression (Arg1))));
8595 while Present (Arg) loop
8596 Check_Arg_Is_Static_Expression (Arg, Standard_String);
8597 Store_String_Char (ASCII.NUL);
8598 Store_String_Chars (Strval (Expr_Value_S (Expression (Arg))));
8602 if Operating_Mode = Generate_Code
8603 and then In_Extended_Main_Source_Unit (N)
8605 Store_Linker_Option_String (End_String);
8609 --------------------
8610 -- Linker_Section --
8611 --------------------
8613 -- pragma Linker_Section (
8614 -- [Entity =>] LOCAL_NAME
8615 -- [Section =>] static_string_EXPRESSION);
8617 when Pragma_Linker_Section =>
8619 Check_Arg_Order ((Name_Entity, Name_Section));
8620 Check_Arg_Count (2);
8621 Check_Optional_Identifier (Arg1, Name_Entity);
8622 Check_Optional_Identifier (Arg2, Name_Section);
8623 Check_Arg_Is_Library_Level_Local_Name (Arg1);
8624 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
8626 -- This pragma applies only to objects
8628 if not Is_Object (Entity (Expression (Arg1))) then
8629 Error_Pragma_Arg ("pragma% applies only to objects", Arg1);
8632 -- The only processing required is to link this item on to the
8633 -- list of rep items for the given entity. This is accomplished
8634 -- by the call to Rep_Item_Too_Late (when no error is detected
8635 -- and False is returned).
8637 if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
8640 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
8647 -- pragma List (On | Off)
8649 -- There is nothing to do here, since we did all the processing
8650 -- for this pragma in Par.Prag (so that it works properly even in
8651 -- syntax only mode)
8656 --------------------
8657 -- Locking_Policy --
8658 --------------------
8660 -- pragma Locking_Policy (policy_IDENTIFIER);
8662 when Pragma_Locking_Policy => declare
8666 Check_Ada_83_Warning;
8667 Check_Arg_Count (1);
8668 Check_No_Identifiers;
8669 Check_Arg_Is_Locking_Policy (Arg1);
8670 Check_Valid_Configuration_Pragma;
8671 Get_Name_String (Chars (Expression (Arg1)));
8672 LP := Fold_Upper (Name_Buffer (1));
8674 if Locking_Policy /= ' '
8675 and then Locking_Policy /= LP
8677 Error_Msg_Sloc := Locking_Policy_Sloc;
8678 Error_Pragma ("locking policy incompatible with policy#");
8680 -- Set new policy, but always preserve System_Location since
8681 -- we like the error message with the run time name.
8684 Locking_Policy := LP;
8686 if Locking_Policy_Sloc /= System_Location then
8687 Locking_Policy_Sloc := Loc;
8696 -- pragma Long_Float (D_Float | G_Float);
8698 when Pragma_Long_Float =>
8700 Check_Valid_Configuration_Pragma;
8701 Check_Arg_Count (1);
8702 Check_No_Identifier (Arg1);
8703 Check_Arg_Is_One_Of (Arg1, Name_D_Float, Name_G_Float);
8705 if not OpenVMS_On_Target then
8706 Error_Pragma ("?pragma% ignored (applies only to Open'V'M'S)");
8711 if Chars (Expression (Arg1)) = Name_D_Float then
8712 if Opt.Float_Format_Long = 'G' then
8713 Error_Pragma ("G_Float previously specified");
8716 Opt.Float_Format_Long := 'D';
8718 -- G_Float case (this is the default, does not need overriding)
8721 if Opt.Float_Format_Long = 'D' then
8722 Error_Pragma ("D_Float previously specified");
8725 Opt.Float_Format_Long := 'G';
8728 Set_Standard_Fpt_Formats;
8730 -----------------------
8731 -- Machine_Attribute --
8732 -----------------------
8734 -- pragma Machine_Attribute (
8735 -- [Entity =>] LOCAL_NAME,
8736 -- [Attribute_Name =>] static_string_EXPRESSION
8737 -- [, [Info =>] static_string_EXPRESSION] );
8739 when Pragma_Machine_Attribute => Machine_Attribute : declare
8744 Check_Arg_Order ((Name_Entity, Name_Attribute_Name, Name_Info));
8746 if Arg_Count = 3 then
8747 Check_Optional_Identifier (Arg3, Name_Info);
8748 Check_Arg_Is_Static_Expression (Arg3, Standard_String);
8750 Check_Arg_Count (2);
8753 Check_Optional_Identifier (Arg1, Name_Entity);
8754 Check_Optional_Identifier (Arg2, Name_Attribute_Name);
8755 Check_Arg_Is_Local_Name (Arg1);
8756 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
8757 Def_Id := Entity (Expression (Arg1));
8759 if Is_Access_Type (Def_Id) then
8760 Def_Id := Designated_Type (Def_Id);
8763 if Rep_Item_Too_Early (Def_Id, N) then
8767 Def_Id := Underlying_Type (Def_Id);
8769 -- The only processing required is to link this item on to the
8770 -- list of rep items for the given entity. This is accomplished
8771 -- by the call to Rep_Item_Too_Late (when no error is detected
8772 -- and False is returned).
8774 if Rep_Item_Too_Late (Def_Id, N) then
8777 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
8779 end Machine_Attribute;
8786 -- (MAIN_OPTION [, MAIN_OPTION]);
8789 -- [STACK_SIZE =>] static_integer_EXPRESSION
8790 -- | [TASK_STACK_SIZE_DEFAULT =>] static_integer_EXPRESSION
8791 -- | [TIME_SLICING_ENABLED =>] static_boolean_EXPRESSION
8793 when Pragma_Main => Main : declare
8794 Args : Args_List (1 .. 3);
8795 Names : constant Name_List (1 .. 3) := (
8797 Name_Task_Stack_Size_Default,
8798 Name_Time_Slicing_Enabled);
8804 Gather_Associations (Names, Args);
8806 for J in 1 .. 2 loop
8807 if Present (Args (J)) then
8808 Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
8812 if Present (Args (3)) then
8813 Check_Arg_Is_Static_Expression (Args (3), Standard_Boolean);
8817 while Present (Nod) loop
8818 if Nkind (Nod) = N_Pragma
8819 and then Pragma_Name (Nod) = Name_Main
8821 Error_Msg_Name_1 := Pname;
8822 Error_Msg_N ("duplicate pragma% not permitted", Nod);
8833 -- pragma Main_Storage
8834 -- (MAIN_STORAGE_OPTION [, MAIN_STORAGE_OPTION]);
8836 -- MAIN_STORAGE_OPTION ::=
8837 -- [WORKING_STORAGE =>] static_SIMPLE_EXPRESSION
8838 -- | [TOP_GUARD =>] static_SIMPLE_EXPRESSION
8840 when Pragma_Main_Storage => Main_Storage : declare
8841 Args : Args_List (1 .. 2);
8842 Names : constant Name_List (1 .. 2) := (
8843 Name_Working_Storage,
8850 Gather_Associations (Names, Args);
8852 for J in 1 .. 2 loop
8853 if Present (Args (J)) then
8854 Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
8858 Check_In_Main_Program;
8861 while Present (Nod) loop
8862 if Nkind (Nod) = N_Pragma
8863 and then Pragma_Name (Nod) = Name_Main_Storage
8865 Error_Msg_Name_1 := Pname;
8866 Error_Msg_N ("duplicate pragma% not permitted", Nod);
8877 -- pragma Memory_Size (NUMERIC_LITERAL)
8879 when Pragma_Memory_Size =>
8882 -- Memory size is simply ignored
8884 Check_No_Identifiers;
8885 Check_Arg_Count (1);
8886 Check_Arg_Is_Integer_Literal (Arg1);
8894 -- The only correct use of this pragma is on its own in a file, in
8895 -- which case it is specially processed (see Gnat1drv.Check_Bad_Body
8896 -- and Frontend, which use Sinput.L.Source_File_Is_Pragma_No_Body to
8897 -- check for a file containing nothing but a No_Body pragma). If we
8898 -- attempt to process it during normal semantics processing, it means
8899 -- it was misplaced.
8901 when Pragma_No_Body =>
8909 -- pragma No_Return (procedure_LOCAL_NAME {, procedure_Local_Name});
8911 when Pragma_No_Return => No_Return : declare
8919 Check_At_Least_N_Arguments (1);
8921 -- Loop through arguments of pragma
8924 while Present (Arg) loop
8925 Check_Arg_Is_Local_Name (Arg);
8926 Id := Expression (Arg);
8929 if not Is_Entity_Name (Id) then
8930 Error_Pragma_Arg ("entity name required", Arg);
8933 if Etype (Id) = Any_Type then
8937 -- Loop to find matching procedures
8942 and then Scope (E) = Current_Scope
8944 if Ekind (E) = E_Procedure
8945 or else Ekind (E) = E_Generic_Procedure
8949 -- Set flag on any alias as well
8951 if Is_Overloadable (E) and then Present (Alias (E)) then
8952 Set_No_Return (Alias (E));
8962 Error_Pragma_Arg ("no procedure & found for pragma%", Arg);
8973 -- pragma No_Run_Time;
8975 -- Note: this pragma is retained for backwards compatibility.
8976 -- See body of Rtsfind for full details on its handling.
8978 when Pragma_No_Run_Time =>
8980 Check_Valid_Configuration_Pragma;
8981 Check_Arg_Count (0);
8983 No_Run_Time_Mode := True;
8984 Configurable_Run_Time_Mode := True;
8986 -- Set Duration to 32 bits if word size is 32
8988 if Ttypes.System_Word_Size = 32 then
8989 Duration_32_Bits_On_Target := True;
8992 -- Set appropriate restrictions
8994 Set_Restriction (No_Finalization, N);
8995 Set_Restriction (No_Exception_Handlers, N);
8996 Set_Restriction (Max_Tasks, N, 0);
8997 Set_Restriction (No_Tasking, N);
8999 ------------------------
9000 -- No_Strict_Aliasing --
9001 ------------------------
9003 -- pragma No_Strict_Aliasing [([Entity =>] type_LOCAL_NAME)];
9005 when Pragma_No_Strict_Aliasing => No_Strict_Aliasing : declare
9010 Check_At_Most_N_Arguments (1);
9012 if Arg_Count = 0 then
9013 Check_Valid_Configuration_Pragma;
9014 Opt.No_Strict_Aliasing := True;
9017 Check_Optional_Identifier (Arg2, Name_Entity);
9018 Check_Arg_Is_Local_Name (Arg1);
9019 E_Id := Entity (Expression (Arg1));
9021 if E_Id = Any_Type then
9023 elsif No (E_Id) or else not Is_Access_Type (E_Id) then
9024 Error_Pragma_Arg ("pragma% requires access type", Arg1);
9027 Set_No_Strict_Aliasing (Implementation_Base_Type (E_Id));
9029 end No_Strict_Aliasing;
9031 -----------------------
9032 -- Normalize_Scalars --
9033 -----------------------
9035 -- pragma Normalize_Scalars;
9037 when Pragma_Normalize_Scalars =>
9038 Check_Ada_83_Warning;
9039 Check_Arg_Count (0);
9040 Check_Valid_Configuration_Pragma;
9041 Normalize_Scalars := True;
9042 Init_Or_Norm_Scalars := True;
9048 -- pragma Obsolescent [(
9049 -- [Entity => NAME,]
9050 -- [(static_string_EXPRESSION [, Ada_05])];
9052 when Pragma_Obsolescent => Obsolescent : declare
9056 procedure Set_Obsolescent (E : Entity_Id);
9057 -- Given an entity Ent, mark it as obsolescent if appropriate
9059 ---------------------
9060 -- Set_Obsolescent --
9061 ---------------------
9063 procedure Set_Obsolescent (E : Entity_Id) is
9072 -- Entity name was given
9074 if Present (Ename) then
9076 -- If entity name matches, we are fine
9078 if Chars (Ename) = Chars (Ent) then
9081 -- If entity name does not match, only possibility is an
9082 -- enumeration literal from an enumeration type declaration.
9084 elsif Ekind (Ent) /= E_Enumeration_Type then
9086 ("pragma % entity name does not match declaration");
9089 Ent := First_Literal (E);
9093 ("pragma % entity name does not match any " &
9094 "enumeration literal");
9096 elsif Chars (Ent) = Chars (Ename) then
9100 Ent := Next_Literal (Ent);
9106 -- Ent points to entity to be marked
9108 if Arg_Count >= 1 then
9110 -- Deal with static string argument
9112 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
9113 S := Strval (Expression (Arg1));
9115 for J in 1 .. String_Length (S) loop
9116 if not In_Character_Range (Get_String_Char (S, J)) then
9118 ("pragma% argument does not allow wide characters",
9123 Obsolescent_Warnings.Append
9124 ((Ent => Ent, Msg => Strval (Expression (Arg1))));
9126 -- Check for Ada_05 parameter
9128 if Arg_Count /= 1 then
9129 Check_Arg_Count (2);
9132 Argx : constant Node_Id := Get_Pragma_Arg (Arg2);
9135 Check_Arg_Is_Identifier (Argx);
9137 if Chars (Argx) /= Name_Ada_05 then
9138 Error_Msg_Name_2 := Name_Ada_05;
9140 ("only allowed argument for pragma% is %", Argx);
9143 if Ada_Version_Explicit < Ada_05
9144 or else not Warn_On_Ada_2005_Compatibility
9152 -- Set flag if pragma active
9155 Set_Is_Obsolescent (Ent);
9159 end Set_Obsolescent;
9161 -- Start of processing for pragma Obsolescent
9166 Check_At_Most_N_Arguments (3);
9168 -- See if first argument specifies an entity name
9171 and then Chars (Arg1) = Name_Entity
9173 Ename := Get_Pragma_Arg (Arg1);
9175 if Nkind (Ename) /= N_Character_Literal
9177 Nkind (Ename) /= N_Identifier
9179 Nkind (Ename) /= N_Operator_Symbol
9181 Error_Pragma_Arg ("entity name expected for pragma%", Arg1);
9184 -- Eliminate first argument, so we can share processing
9188 Arg_Count := Arg_Count - 1;
9190 -- No Entity name argument given
9196 Check_No_Identifiers;
9198 -- Get immediately preceding declaration
9201 while Present (Decl) and then Nkind (Decl) = N_Pragma loop
9205 -- Cases where we do not follow anything other than another pragma
9209 -- First case: library level compilation unit declaration with
9210 -- the pragma immediately following the declaration.
9212 if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
9214 (Defining_Entity (Unit (Parent (Parent (N)))));
9217 -- Case 2: library unit placement for package
9221 Ent : constant Entity_Id := Find_Lib_Unit_Name;
9223 if Ekind (Ent) = E_Package
9224 or else Ekind (Ent) = E_Generic_Package
9226 Set_Obsolescent (Ent);
9232 -- Cases where we must follow a declaration
9235 if Nkind (Decl) not in N_Declaration
9236 and then Nkind (Decl) not in N_Later_Decl_Item
9237 and then Nkind (Decl) not in N_Generic_Declaration
9240 ("pragma% misplaced, " &
9241 "must immediately follow a declaration");
9244 Set_Obsolescent (Defining_Entity (Decl));
9254 -- pragma Optimize (Time | Space | Off);
9256 -- The actual check for optimize is done in Gigi. Note that this
9257 -- pragma does not actually change the optimization setting, it
9258 -- simply checks that it is consistent with the pragma.
9260 when Pragma_Optimize =>
9261 Check_No_Identifiers;
9262 Check_Arg_Count (1);
9263 Check_Arg_Is_One_Of (Arg1, Name_Time, Name_Space, Name_Off);
9265 ------------------------
9266 -- Optimize_Alignment --
9267 ------------------------
9269 -- pragma Optimize_Alignment (Time | Space | Off);
9271 when Pragma_Optimize_Alignment =>
9273 Check_No_Identifiers;
9274 Check_Arg_Count (1);
9275 Check_Valid_Configuration_Pragma;
9278 Nam : constant Name_Id := Chars (Get_Pragma_Arg (Arg1));
9282 Opt.Optimize_Alignment := 'T';
9284 Opt.Optimize_Alignment := 'S';
9286 Opt.Optimize_Alignment := 'O';
9288 Error_Pragma_Arg ("invalid argument for pragma%", Arg1);
9292 -- Set indication that mode is set locally. If we are in fact in a
9293 -- configuration pragma file, this setting is harmless since the
9294 -- switch will get reset anyway at the start of each unit.
9296 Optimize_Alignment_Local := True;
9302 -- pragma Pack (first_subtype_LOCAL_NAME);
9304 when Pragma_Pack => Pack : declare
9305 Assoc : constant Node_Id := Arg1;
9310 Check_No_Identifiers;
9311 Check_Arg_Count (1);
9312 Check_Arg_Is_Local_Name (Arg1);
9314 Type_Id := Expression (Assoc);
9315 Find_Type (Type_Id);
9316 Typ := Entity (Type_Id);
9319 or else Rep_Item_Too_Early (Typ, N)
9323 Typ := Underlying_Type (Typ);
9326 if not Is_Array_Type (Typ) and then not Is_Record_Type (Typ) then
9327 Error_Pragma ("pragma% must specify array or record type");
9330 Check_First_Subtype (Arg1);
9332 if Has_Pragma_Pack (Typ) then
9333 Error_Pragma ("duplicate pragma%, only one allowed");
9337 elsif Is_Array_Type (Typ) then
9339 -- Pack not allowed for aliased or atomic components
9341 if Has_Aliased_Components (Base_Type (Typ)) then
9343 ("pragma% ignored, cannot pack aliased components?");
9345 elsif Has_Atomic_Components (Typ)
9346 or else Is_Atomic (Component_Type (Typ))
9349 ("?pragma% ignored, cannot pack atomic components");
9352 -- If we had an explicit component size given, then we do not
9353 -- let Pack override this given size. We also give a warning
9354 -- that Pack is being ignored unless we can tell for sure that
9355 -- the Pack would not have had any effect anyway.
9357 if Has_Component_Size_Clause (Typ) then
9358 if Known_Static_RM_Size (Component_Type (Typ))
9360 RM_Size (Component_Type (Typ)) = Component_Size (Typ)
9365 ("?pragma% ignored, explicit component size given");
9368 -- If no prior array component size given, Pack is effective
9371 if not Rep_Item_Too_Late (Typ, N) then
9372 if VM_Target = No_VM then
9373 Set_Is_Packed (Base_Type (Typ));
9374 elsif not GNAT_Mode then
9376 ("?pragma% ignored in this configuration");
9379 Set_Has_Pragma_Pack (Base_Type (Typ));
9380 Set_Has_Non_Standard_Rep (Base_Type (Typ));
9384 -- For record types, the pack is always effective
9386 else pragma Assert (Is_Record_Type (Typ));
9387 if not Rep_Item_Too_Late (Typ, N) then
9388 if VM_Target = No_VM then
9389 Set_Is_Packed (Base_Type (Typ));
9390 elsif not GNAT_Mode then
9391 Error_Pragma ("?pragma% ignored in this configuration");
9394 Set_Has_Pragma_Pack (Base_Type (Typ));
9395 Set_Has_Non_Standard_Rep (Base_Type (Typ));
9406 -- There is nothing to do here, since we did all the processing
9407 -- for this pragma in Par.Prag (so that it works properly even in
9408 -- syntax only mode)
9417 -- pragma Passive [(PASSIVE_FORM)];
9419 -- PASSIVE_FORM ::= Semaphore | No
9421 when Pragma_Passive =>
9424 if Nkind (Parent (N)) /= N_Task_Definition then
9425 Error_Pragma ("pragma% must be within task definition");
9428 if Arg_Count /= 0 then
9429 Check_Arg_Count (1);
9430 Check_Arg_Is_One_Of (Arg1, Name_Semaphore, Name_No);
9433 ----------------------------------
9434 -- Preelaborable_Initialization --
9435 ----------------------------------
9437 -- pragma Preelaborable_Initialization (DIRECT_NAME);
9439 when Pragma_Preelaborable_Initialization => Preelab_Init : declare
9444 Check_Arg_Count (1);
9445 Check_No_Identifiers;
9446 Check_Arg_Is_Identifier (Arg1);
9447 Check_Arg_Is_Local_Name (Arg1);
9448 Check_First_Subtype (Arg1);
9449 Ent := Entity (Expression (Arg1));
9451 if not Is_Private_Type (Ent)
9452 and then not Is_Protected_Type (Ent)
9455 ("pragma % can only be applied to private or protected type",
9459 -- Give an error if the pragma is applied to a protected type that
9460 -- does not qualify (due to having entries, or due to components
9461 -- that do not qualify).
9463 if Is_Protected_Type (Ent)
9464 and then not Has_Preelaborable_Initialization (Ent)
9467 ("protected type & does not have preelaborable " &
9468 "initialization", Ent);
9470 -- Otherwise mark the type as definitely having preelaborable
9474 Set_Known_To_Have_Preelab_Init (Ent);
9477 if Has_Pragma_Preelab_Init (Ent)
9478 and then Warn_On_Redundant_Constructs
9480 Error_Pragma ("?duplicate pragma%!");
9482 Set_Has_Pragma_Preelab_Init (Ent);
9486 --------------------
9487 -- Persistent_BSS --
9488 --------------------
9490 when Pragma_Persistent_BSS => Persistent_BSS : declare
9497 Check_At_Most_N_Arguments (1);
9499 -- Case of application to specific object (one argument)
9501 if Arg_Count = 1 then
9502 Check_Arg_Is_Library_Level_Local_Name (Arg1);
9504 if not Is_Entity_Name (Expression (Arg1))
9506 (Ekind (Entity (Expression (Arg1))) /= E_Variable
9507 and then Ekind (Entity (Expression (Arg1))) /= E_Constant)
9509 Error_Pragma_Arg ("pragma% only applies to objects", Arg1);
9512 Ent := Entity (Expression (Arg1));
9513 Decl := Parent (Ent);
9515 if Rep_Item_Too_Late (Ent, N) then
9519 if Present (Expression (Decl)) then
9521 ("object for pragma% cannot have initialization", Arg1);
9524 if not Is_Potentially_Persistent_Type (Etype (Ent)) then
9526 ("object type for pragma% is not potentially persistent",
9531 Make_Linker_Section_Pragma
9532 (Ent, Sloc (N), ".persistent.bss");
9533 Insert_After (N, Prag);
9536 -- Case of use as configuration pragma with no arguments
9539 Check_Valid_Configuration_Pragma;
9540 Persistent_BSS_Mode := True;
9548 -- pragma Polling (ON | OFF);
9550 when Pragma_Polling =>
9552 Check_Arg_Count (1);
9553 Check_No_Identifiers;
9554 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
9555 Polling_Required := (Chars (Expression (Arg1)) = Name_On);
9561 -- pragma Postcondition ([Check =>] Boolean_Expression
9562 -- [,[Message =>] String_Expression]);
9564 when Pragma_Postcondition => Postcondition : declare
9566 pragma Warnings (Off, In_Body);
9570 Check_At_Least_N_Arguments (1);
9571 Check_At_Most_N_Arguments (2);
9572 Check_Optional_Identifier (Arg1, Name_Check);
9574 -- All we need to do here is call the common check procedure,
9575 -- the remainder of the processing is found in Sem_Ch6/Sem_Ch7.
9577 Check_Precondition_Postcondition (In_Body);
9584 -- pragma Precondition ([Check =>] Boolean_Expression
9585 -- [,[Message =>] String_Expression]);
9587 when Pragma_Precondition => Precondition : declare
9592 Check_At_Least_N_Arguments (1);
9593 Check_At_Most_N_Arguments (2);
9594 Check_Optional_Identifier (Arg1, Name_Check);
9596 Check_Precondition_Postcondition (In_Body);
9598 -- If in spec, nothing to do. If in body, then we convert the
9599 -- pragma to pragma Check (Precondition, cond [, msg]). Note we
9600 -- do this whether or not precondition checks are enabled. That
9601 -- works fine since pragma Check will do this check.
9604 if Arg_Count = 2 then
9605 Check_Optional_Identifier (Arg3, Name_Message);
9606 Analyze_And_Resolve (Get_Pragma_Arg (Arg2), Standard_String);
9609 Analyze_And_Resolve (Get_Pragma_Arg (Arg1), Standard_Boolean);
9613 Chars => Name_Check,
9614 Pragma_Argument_Associations => New_List (
9615 Make_Pragma_Argument_Association (Loc,
9617 Make_Identifier (Loc,
9618 Chars => Name_Precondition)),
9620 Make_Pragma_Argument_Association (Sloc (Arg1),
9621 Expression => Relocate_Node (Get_Pragma_Arg (Arg1))))));
9623 if Arg_Count = 2 then
9624 Append_To (Pragma_Argument_Associations (N),
9625 Make_Pragma_Argument_Association (Sloc (Arg2),
9626 Expression => Relocate_Node (Get_Pragma_Arg (Arg2))));
9637 -- pragma Preelaborate [(library_unit_NAME)];
9639 -- Set the flag Is_Preelaborated of program unit name entity
9641 when Pragma_Preelaborate => Preelaborate : declare
9642 Pa : constant Node_Id := Parent (N);
9643 Pk : constant Node_Kind := Nkind (Pa);
9647 Check_Ada_83_Warning;
9648 Check_Valid_Library_Unit_Pragma;
9650 if Nkind (N) = N_Null_Statement then
9654 Ent := Find_Lib_Unit_Name;
9656 -- This filters out pragmas inside generic parent then
9657 -- show up inside instantiation
9660 and then not (Pk = N_Package_Specification
9661 and then Present (Generic_Parent (Pa)))
9663 if not Debug_Flag_U then
9664 Set_Is_Preelaborated (Ent);
9665 Set_Suppress_Elaboration_Warnings (Ent);
9670 ---------------------
9671 -- Preelaborate_05 --
9672 ---------------------
9674 -- pragma Preelaborate_05 [(library_unit_NAME)];
9676 -- This pragma is useable only in GNAT_Mode, where it is used like
9677 -- pragma Preelaborate but it is only effective in Ada 2005 mode
9678 -- (otherwise it is ignored). This is used to implement AI-362 which
9679 -- recategorizes some run-time packages in Ada 2005 mode.
9681 when Pragma_Preelaborate_05 => Preelaborate_05 : declare
9686 Check_Valid_Library_Unit_Pragma;
9688 if not GNAT_Mode then
9689 Error_Pragma ("pragma% only available in GNAT mode");
9692 if Nkind (N) = N_Null_Statement then
9696 -- This is one of the few cases where we need to test the value of
9697 -- Ada_Version_Explicit rather than Ada_Version (which is always
9698 -- set to Ada_05 in a predefined unit), we need to know the
9699 -- explicit version set to know if this pragma is active.
9701 if Ada_Version_Explicit >= Ada_05 then
9702 Ent := Find_Lib_Unit_Name;
9703 Set_Is_Preelaborated (Ent);
9704 Set_Suppress_Elaboration_Warnings (Ent);
9706 end Preelaborate_05;
9712 -- pragma Priority (EXPRESSION);
9714 when Pragma_Priority => Priority : declare
9715 P : constant Node_Id := Parent (N);
9719 Check_No_Identifiers;
9720 Check_Arg_Count (1);
9724 if Nkind (P) = N_Subprogram_Body then
9725 Check_In_Main_Program;
9727 Arg := Expression (Arg1);
9728 Analyze_And_Resolve (Arg, Standard_Integer);
9732 if not Is_Static_Expression (Arg) then
9733 Flag_Non_Static_Expr
9734 ("main subprogram priority is not static!", Arg);
9737 -- If constraint error, then we already signalled an error
9739 elsif Raises_Constraint_Error (Arg) then
9742 -- Otherwise check in range
9746 Val : constant Uint := Expr_Value (Arg);
9750 or else Val > Expr_Value (Expression
9751 (Parent (RTE (RE_Max_Priority))))
9754 ("main subprogram priority is out of range", Arg1);
9760 (Current_Sem_Unit, UI_To_Int (Expr_Value (Arg)));
9762 -- Load an arbitrary entity from System.Tasking to make sure
9763 -- this package is implicitly with'ed, since we need to have
9764 -- the tasking run-time active for the pragma Priority to have
9768 Discard : Entity_Id;
9769 pragma Warnings (Off, Discard);
9771 Discard := RTE (RE_Task_List);
9774 -- Task or Protected, must be of type Integer
9776 elsif Nkind (P) = N_Protected_Definition
9778 Nkind (P) = N_Task_Definition
9780 Arg := Expression (Arg1);
9782 -- The expression must be analyzed in the special manner
9783 -- described in "Handling of Default and Per-Object
9784 -- Expressions" in sem.ads.
9786 Preanalyze_Spec_Expression (Arg, Standard_Integer);
9788 if not Is_Static_Expression (Arg) then
9789 Check_Restriction (Static_Priorities, Arg);
9792 -- Anything else is incorrect
9798 if Has_Priority_Pragma (P) then
9799 Error_Pragma ("duplicate pragma% not allowed");
9801 Set_Has_Priority_Pragma (P, True);
9803 if Nkind (P) = N_Protected_Definition
9805 Nkind (P) = N_Task_Definition
9807 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
9808 -- exp_ch9 should use this ???
9813 -----------------------------------
9814 -- Priority_Specific_Dispatching --
9815 -----------------------------------
9817 -- pragma Priority_Specific_Dispatching (
9818 -- policy_IDENTIFIER,
9819 -- first_priority_EXPRESSION,
9820 -- last_priority_EXPRESSION);
9822 when Pragma_Priority_Specific_Dispatching =>
9823 Priority_Specific_Dispatching : declare
9824 Prio_Id : constant Entity_Id := RTE (RE_Any_Priority);
9825 -- This is the entity System.Any_Priority;
9828 Lower_Bound : Node_Id;
9829 Upper_Bound : Node_Id;
9835 Check_Arg_Count (3);
9836 Check_No_Identifiers;
9837 Check_Arg_Is_Task_Dispatching_Policy (Arg1);
9838 Check_Valid_Configuration_Pragma;
9839 Get_Name_String (Chars (Expression (Arg1)));
9840 DP := Fold_Upper (Name_Buffer (1));
9842 Lower_Bound := Expression (Arg2);
9843 Check_Arg_Is_Static_Expression (Lower_Bound, Standard_Integer);
9844 Lower_Val := Expr_Value (Lower_Bound);
9846 Upper_Bound := Expression (Arg3);
9847 Check_Arg_Is_Static_Expression (Upper_Bound, Standard_Integer);
9848 Upper_Val := Expr_Value (Upper_Bound);
9850 -- It is not allowed to use Task_Dispatching_Policy and
9851 -- Priority_Specific_Dispatching in the same partition.
9853 if Task_Dispatching_Policy /= ' ' then
9854 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
9856 ("pragma% incompatible with Task_Dispatching_Policy#");
9858 -- Check lower bound in range
9860 elsif Lower_Val < Expr_Value (Type_Low_Bound (Prio_Id))
9862 Lower_Val > Expr_Value (Type_High_Bound (Prio_Id))
9865 ("first_priority is out of range", Arg2);
9867 -- Check upper bound in range
9869 elsif Upper_Val < Expr_Value (Type_Low_Bound (Prio_Id))
9871 Upper_Val > Expr_Value (Type_High_Bound (Prio_Id))
9874 ("last_priority is out of range", Arg3);
9876 -- Check that the priority range is valid
9878 elsif Lower_Val > Upper_Val then
9880 ("last_priority_expression must be greater than" &
9881 " or equal to first_priority_expression");
9883 -- Store the new policy, but always preserve System_Location since
9884 -- we like the error message with the run-time name.
9887 -- Check overlapping in the priority ranges specified in other
9888 -- Priority_Specific_Dispatching pragmas within the same
9889 -- partition. We can only check those we know about!
9892 Specific_Dispatching.First .. Specific_Dispatching.Last
9894 if Specific_Dispatching.Table (J).First_Priority in
9895 UI_To_Int (Lower_Val) .. UI_To_Int (Upper_Val)
9896 or else Specific_Dispatching.Table (J).Last_Priority in
9897 UI_To_Int (Lower_Val) .. UI_To_Int (Upper_Val)
9900 Specific_Dispatching.Table (J).Pragma_Loc;
9902 ("priority range overlaps with "
9903 & "Priority_Specific_Dispatching#");
9907 -- The use of Priority_Specific_Dispatching is incompatible
9908 -- with Task_Dispatching_Policy.
9910 if Task_Dispatching_Policy /= ' ' then
9911 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
9913 ("Priority_Specific_Dispatching incompatible "
9914 & "with Task_Dispatching_Policy#");
9917 -- The use of Priority_Specific_Dispatching forces ceiling
9920 if Locking_Policy /= ' ' and then Locking_Policy /= 'C' then
9921 Error_Msg_Sloc := Locking_Policy_Sloc;
9923 ("Priority_Specific_Dispatching incompatible "
9924 & "with Locking_Policy#");
9926 -- Set the Ceiling_Locking policy, but preserve System_Location
9927 -- since we like the error message with the run time name.
9930 Locking_Policy := 'C';
9932 if Locking_Policy_Sloc /= System_Location then
9933 Locking_Policy_Sloc := Loc;
9937 -- Add entry in the table
9939 Specific_Dispatching.Append
9940 ((Dispatching_Policy => DP,
9941 First_Priority => UI_To_Int (Lower_Val),
9942 Last_Priority => UI_To_Int (Upper_Val),
9943 Pragma_Loc => Loc));
9945 end Priority_Specific_Dispatching;
9951 -- pragma Profile (profile_IDENTIFIER);
9953 -- profile_IDENTIFIER => Restricted | Ravenscar
9955 when Pragma_Profile =>
9957 Check_Arg_Count (1);
9958 Check_Valid_Configuration_Pragma;
9959 Check_No_Identifiers;
9962 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
9964 if Chars (Argx) = Name_Ravenscar then
9965 Set_Ravenscar_Profile (N);
9966 elsif Chars (Argx) = Name_Restricted then
9967 Set_Profile_Restrictions
9968 (Restricted, N, Warn => Treat_Restrictions_As_Warnings);
9970 Error_Pragma_Arg ("& is not a valid profile", Argx);
9974 ----------------------
9975 -- Profile_Warnings --
9976 ----------------------
9978 -- pragma Profile_Warnings (profile_IDENTIFIER);
9980 -- profile_IDENTIFIER => Restricted | Ravenscar
9982 when Pragma_Profile_Warnings =>
9984 Check_Arg_Count (1);
9985 Check_Valid_Configuration_Pragma;
9986 Check_No_Identifiers;
9989 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
9991 if Chars (Argx) = Name_Ravenscar then
9992 Set_Profile_Restrictions (Ravenscar, N, Warn => True);
9993 elsif Chars (Argx) = Name_Restricted then
9994 Set_Profile_Restrictions (Restricted, N, Warn => True);
9996 Error_Pragma_Arg ("& is not a valid profile", Argx);
10000 --------------------------
10001 -- Propagate_Exceptions --
10002 --------------------------
10004 -- pragma Propagate_Exceptions;
10006 -- Note: this pragma is obsolete and has no effect
10008 when Pragma_Propagate_Exceptions =>
10010 Check_Arg_Count (0);
10012 if In_Extended_Main_Source_Unit (N) then
10013 Propagate_Exceptions := True;
10020 -- pragma Psect_Object (
10021 -- [Internal =>] LOCAL_NAME,
10022 -- [, [External =>] EXTERNAL_SYMBOL]
10023 -- [, [Size =>] EXTERNAL_SYMBOL]);
10025 when Pragma_Psect_Object | Pragma_Common_Object =>
10026 Psect_Object : declare
10027 Args : Args_List (1 .. 3);
10028 Names : constant Name_List (1 .. 3) := (
10033 Internal : Node_Id renames Args (1);
10034 External : Node_Id renames Args (2);
10035 Size : Node_Id renames Args (3);
10037 Def_Id : Entity_Id;
10039 procedure Check_Too_Long (Arg : Node_Id);
10040 -- Posts message if the argument is an identifier with more
10041 -- than 31 characters, or a string literal with more than
10042 -- 31 characters, and we are operating under VMS
10044 --------------------
10045 -- Check_Too_Long --
10046 --------------------
10048 procedure Check_Too_Long (Arg : Node_Id) is
10049 X : constant Node_Id := Original_Node (Arg);
10052 if Nkind (X) /= N_String_Literal
10054 Nkind (X) /= N_Identifier
10057 ("inappropriate argument for pragma %", Arg);
10060 if OpenVMS_On_Target then
10061 if (Nkind (X) = N_String_Literal
10062 and then String_Length (Strval (X)) > 31)
10064 (Nkind (X) = N_Identifier
10065 and then Length_Of_Name (Chars (X)) > 31)
10068 ("argument for pragma % is longer than 31 characters",
10072 end Check_Too_Long;
10074 -- Start of processing for Common_Object/Psect_Object
10078 Gather_Associations (Names, Args);
10079 Process_Extended_Import_Export_Internal_Arg (Internal);
10081 Def_Id := Entity (Internal);
10083 if Ekind (Def_Id) /= E_Constant
10084 and then Ekind (Def_Id) /= E_Variable
10087 ("pragma% must designate an object", Internal);
10090 Check_Too_Long (Internal);
10092 if Is_Imported (Def_Id) or else Is_Exported (Def_Id) then
10094 ("cannot use pragma% for imported/exported object",
10098 if Is_Concurrent_Type (Etype (Internal)) then
10100 ("cannot specify pragma % for task/protected object",
10104 if Has_Rep_Pragma (Def_Id, Name_Common_Object)
10106 Has_Rep_Pragma (Def_Id, Name_Psect_Object)
10108 Error_Msg_N ("?duplicate Common/Psect_Object pragma", N);
10111 if Ekind (Def_Id) = E_Constant then
10113 ("cannot specify pragma % for a constant", Internal);
10116 if Is_Record_Type (Etype (Internal)) then
10122 Ent := First_Entity (Etype (Internal));
10123 while Present (Ent) loop
10124 Decl := Declaration_Node (Ent);
10126 if Ekind (Ent) = E_Component
10127 and then Nkind (Decl) = N_Component_Declaration
10128 and then Present (Expression (Decl))
10129 and then Warn_On_Export_Import
10132 ("?object for pragma % has defaults", Internal);
10142 if Present (Size) then
10143 Check_Too_Long (Size);
10146 if Present (External) then
10147 Check_Arg_Is_External_Name (External);
10148 Check_Too_Long (External);
10151 -- If all error tests pass, link pragma on to the rep item chain
10153 Record_Rep_Item (Def_Id, N);
10160 -- pragma Pure [(library_unit_NAME)];
10162 when Pragma_Pure => Pure : declare
10166 Check_Ada_83_Warning;
10167 Check_Valid_Library_Unit_Pragma;
10169 if Nkind (N) = N_Null_Statement then
10173 Ent := Find_Lib_Unit_Name;
10175 Set_Has_Pragma_Pure (Ent);
10176 Set_Suppress_Elaboration_Warnings (Ent);
10183 -- pragma Pure_05 [(library_unit_NAME)];
10185 -- This pragma is useable only in GNAT_Mode, where it is used like
10186 -- pragma Pure but it is only effective in Ada 2005 mode (otherwise
10187 -- it is ignored). It may be used after a pragma Preelaborate, in
10188 -- which case it overrides the effect of the pragma Preelaborate.
10189 -- This is used to implement AI-362 which recategorizes some run-time
10190 -- packages in Ada 2005 mode.
10192 when Pragma_Pure_05 => Pure_05 : declare
10197 Check_Valid_Library_Unit_Pragma;
10199 if not GNAT_Mode then
10200 Error_Pragma ("pragma% only available in GNAT mode");
10202 if Nkind (N) = N_Null_Statement then
10206 -- This is one of the few cases where we need to test the value of
10207 -- Ada_Version_Explicit rather than Ada_Version (which is always
10208 -- set to Ada_05 in a predefined unit), we need to know the
10209 -- explicit version set to know if this pragma is active.
10211 if Ada_Version_Explicit >= Ada_05 then
10212 Ent := Find_Lib_Unit_Name;
10213 Set_Is_Preelaborated (Ent, False);
10215 Set_Suppress_Elaboration_Warnings (Ent);
10219 -------------------
10220 -- Pure_Function --
10221 -------------------
10223 -- pragma Pure_Function ([Entity =>] function_LOCAL_NAME);
10225 when Pragma_Pure_Function => Pure_Function : declare
10228 Def_Id : Entity_Id;
10229 Effective : Boolean := False;
10233 Check_Arg_Count (1);
10234 Check_Optional_Identifier (Arg1, Name_Entity);
10235 Check_Arg_Is_Local_Name (Arg1);
10236 E_Id := Expression (Arg1);
10238 if Error_Posted (E_Id) then
10242 -- Loop through homonyms (overloadings) of referenced entity
10244 E := Entity (E_Id);
10246 if Present (E) then
10248 Def_Id := Get_Base_Subprogram (E);
10250 if Ekind (Def_Id) /= E_Function
10251 and then Ekind (Def_Id) /= E_Generic_Function
10252 and then Ekind (Def_Id) /= E_Operator
10255 ("pragma% requires a function name", Arg1);
10258 Set_Is_Pure (Def_Id);
10260 if not Has_Pragma_Pure_Function (Def_Id) then
10261 Set_Has_Pragma_Pure_Function (Def_Id);
10266 exit when No (E) or else Scope (E) /= Current_Scope;
10270 and then Warn_On_Redundant_Constructs
10272 Error_Msg_NE ("pragma Pure_Function on& is redundant?",
10278 --------------------
10279 -- Queuing_Policy --
10280 --------------------
10282 -- pragma Queuing_Policy (policy_IDENTIFIER);
10284 when Pragma_Queuing_Policy => declare
10288 Check_Ada_83_Warning;
10289 Check_Arg_Count (1);
10290 Check_No_Identifiers;
10291 Check_Arg_Is_Queuing_Policy (Arg1);
10292 Check_Valid_Configuration_Pragma;
10293 Get_Name_String (Chars (Expression (Arg1)));
10294 QP := Fold_Upper (Name_Buffer (1));
10296 if Queuing_Policy /= ' '
10297 and then Queuing_Policy /= QP
10299 Error_Msg_Sloc := Queuing_Policy_Sloc;
10300 Error_Pragma ("queuing policy incompatible with policy#");
10302 -- Set new policy, but always preserve System_Location since
10303 -- we like the error message with the run time name.
10306 Queuing_Policy := QP;
10308 if Queuing_Policy_Sloc /= System_Location then
10309 Queuing_Policy_Sloc := Loc;
10314 -----------------------
10315 -- Relative_Deadline --
10316 -----------------------
10318 -- pragma Relative_Deadline (time_span_EXPRESSION);
10320 when Pragma_Relative_Deadline => Relative_Deadline : declare
10321 P : constant Node_Id := Parent (N);
10326 Check_No_Identifiers;
10327 Check_Arg_Count (1);
10329 Arg := Expression (Arg1);
10331 -- The expression must be analyzed in the special manner described
10332 -- in "Handling of Default and Per-Object Expressions" in sem.ads.
10334 Preanalyze_Spec_Expression (Arg, RTE (RE_Time_Span));
10338 if Nkind (P) = N_Subprogram_Body then
10339 Check_In_Main_Program;
10343 elsif Nkind (P) = N_Task_Definition then
10346 -- Anything else is incorrect
10352 if Has_Relative_Deadline_Pragma (P) then
10353 Error_Pragma ("duplicate pragma% not allowed");
10355 Set_Has_Relative_Deadline_Pragma (P, True);
10357 if Nkind (P) = N_Task_Definition then
10358 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
10361 end Relative_Deadline;
10363 ---------------------------
10364 -- Remote_Call_Interface --
10365 ---------------------------
10367 -- pragma Remote_Call_Interface [(library_unit_NAME)];
10369 when Pragma_Remote_Call_Interface => Remote_Call_Interface : declare
10370 Cunit_Node : Node_Id;
10371 Cunit_Ent : Entity_Id;
10375 Check_Ada_83_Warning;
10376 Check_Valid_Library_Unit_Pragma;
10378 if Nkind (N) = N_Null_Statement then
10382 Cunit_Node := Cunit (Current_Sem_Unit);
10383 K := Nkind (Unit (Cunit_Node));
10384 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
10386 if K = N_Package_Declaration
10387 or else K = N_Generic_Package_Declaration
10388 or else K = N_Subprogram_Declaration
10389 or else K = N_Generic_Subprogram_Declaration
10390 or else (K = N_Subprogram_Body
10391 and then Acts_As_Spec (Unit (Cunit_Node)))
10396 "pragma% must apply to package or subprogram declaration");
10399 Set_Is_Remote_Call_Interface (Cunit_Ent);
10400 end Remote_Call_Interface;
10406 -- pragma Remote_Types [(library_unit_NAME)];
10408 when Pragma_Remote_Types => Remote_Types : declare
10409 Cunit_Node : Node_Id;
10410 Cunit_Ent : Entity_Id;
10413 Check_Ada_83_Warning;
10414 Check_Valid_Library_Unit_Pragma;
10416 if Nkind (N) = N_Null_Statement then
10420 Cunit_Node := Cunit (Current_Sem_Unit);
10421 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
10423 if Nkind (Unit (Cunit_Node)) /= N_Package_Declaration
10425 Nkind (Unit (Cunit_Node)) /= N_Generic_Package_Declaration
10428 "pragma% can only apply to a package declaration");
10431 Set_Is_Remote_Types (Cunit_Ent);
10438 -- pragma Ravenscar;
10440 when Pragma_Ravenscar =>
10442 Check_Arg_Count (0);
10443 Check_Valid_Configuration_Pragma;
10444 Set_Ravenscar_Profile (N);
10446 if Warn_On_Obsolescent_Feature then
10448 ("pragma Ravenscar is an obsolescent feature?", N);
10450 ("|use pragma Profile (Ravenscar) instead", N);
10453 -------------------------
10454 -- Restricted_Run_Time --
10455 -------------------------
10457 -- pragma Restricted_Run_Time;
10459 when Pragma_Restricted_Run_Time =>
10461 Check_Arg_Count (0);
10462 Check_Valid_Configuration_Pragma;
10463 Set_Profile_Restrictions
10464 (Restricted, N, Warn => Treat_Restrictions_As_Warnings);
10466 if Warn_On_Obsolescent_Feature then
10468 ("pragma Restricted_Run_Time is an obsolescent feature?", N);
10470 ("|use pragma Profile (Restricted) instead", N);
10477 -- pragma Restrictions (RESTRICTION {, RESTRICTION});
10480 -- restriction_IDENTIFIER
10481 -- | restriction_parameter_IDENTIFIER => EXPRESSION
10483 when Pragma_Restrictions =>
10484 Process_Restrictions_Or_Restriction_Warnings
10485 (Warn => Treat_Restrictions_As_Warnings);
10487 --------------------------
10488 -- Restriction_Warnings --
10489 --------------------------
10491 -- pragma Restriction_Warnings (RESTRICTION {, RESTRICTION});
10494 -- restriction_IDENTIFIER
10495 -- | restriction_parameter_IDENTIFIER => EXPRESSION
10497 when Pragma_Restriction_Warnings =>
10499 Process_Restrictions_Or_Restriction_Warnings (Warn => True);
10505 -- pragma Reviewable;
10507 when Pragma_Reviewable =>
10508 Check_Ada_83_Warning;
10509 Check_Arg_Count (0);
10512 -------------------
10513 -- Share_Generic --
10514 -------------------
10516 -- pragma Share_Generic (NAME {, NAME});
10518 when Pragma_Share_Generic =>
10520 Process_Generic_List;
10526 -- pragma Shared (LOCAL_NAME);
10528 when Pragma_Shared =>
10530 Process_Atomic_Shared_Volatile;
10532 --------------------
10533 -- Shared_Passive --
10534 --------------------
10536 -- pragma Shared_Passive [(library_unit_NAME)];
10538 -- Set the flag Is_Shared_Passive of program unit name entity
10540 when Pragma_Shared_Passive => Shared_Passive : declare
10541 Cunit_Node : Node_Id;
10542 Cunit_Ent : Entity_Id;
10545 Check_Ada_83_Warning;
10546 Check_Valid_Library_Unit_Pragma;
10548 if Nkind (N) = N_Null_Statement then
10552 Cunit_Node := Cunit (Current_Sem_Unit);
10553 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
10555 if Nkind (Unit (Cunit_Node)) /= N_Package_Declaration
10557 Nkind (Unit (Cunit_Node)) /= N_Generic_Package_Declaration
10560 "pragma% can only apply to a package declaration");
10563 Set_Is_Shared_Passive (Cunit_Ent);
10564 end Shared_Passive;
10566 ----------------------
10567 -- Source_File_Name --
10568 ----------------------
10570 -- There are five forms for this pragma:
10572 -- pragma Source_File_Name (
10573 -- [UNIT_NAME =>] unit_NAME,
10574 -- BODY_FILE_NAME => STRING_LITERAL
10575 -- [, [INDEX =>] INTEGER_LITERAL]);
10577 -- pragma Source_File_Name (
10578 -- [UNIT_NAME =>] unit_NAME,
10579 -- SPEC_FILE_NAME => STRING_LITERAL
10580 -- [, [INDEX =>] INTEGER_LITERAL]);
10582 -- pragma Source_File_Name (
10583 -- BODY_FILE_NAME => STRING_LITERAL
10584 -- [, DOT_REPLACEMENT => STRING_LITERAL]
10585 -- [, CASING => CASING_SPEC]);
10587 -- pragma Source_File_Name (
10588 -- SPEC_FILE_NAME => STRING_LITERAL
10589 -- [, DOT_REPLACEMENT => STRING_LITERAL]
10590 -- [, CASING => CASING_SPEC]);
10592 -- pragma Source_File_Name (
10593 -- SUBUNIT_FILE_NAME => STRING_LITERAL
10594 -- [, DOT_REPLACEMENT => STRING_LITERAL]
10595 -- [, CASING => CASING_SPEC]);
10597 -- CASING_SPEC ::= Uppercase | Lowercase | Mixedcase
10599 -- Pragma Source_File_Name_Project (SFNP) is equivalent to pragma
10600 -- Source_File_Name (SFN), however their usage is exclusive:
10601 -- SFN can only be used when no project file is used, while
10602 -- SFNP can only be used when a project file is used.
10604 -- No processing here. Processing was completed during parsing,
10605 -- since we need to have file names set as early as possible.
10606 -- Units are loaded well before semantic processing starts.
10608 -- The only processing we defer to this point is the check
10609 -- for correct placement.
10611 when Pragma_Source_File_Name =>
10613 Check_Valid_Configuration_Pragma;
10615 ------------------------------
10616 -- Source_File_Name_Project --
10617 ------------------------------
10619 -- See Source_File_Name for syntax
10621 -- No processing here. Processing was completed during parsing,
10622 -- since we need to have file names set as early as possible.
10623 -- Units are loaded well before semantic processing starts.
10625 -- The only processing we defer to this point is the check
10626 -- for correct placement.
10628 when Pragma_Source_File_Name_Project =>
10630 Check_Valid_Configuration_Pragma;
10632 -- Check that a pragma Source_File_Name_Project is used only
10633 -- in a configuration pragmas file.
10635 -- Pragmas Source_File_Name_Project should only be generated
10636 -- by the Project Manager in configuration pragmas files.
10638 -- This is really an ugly test. It seems to depend on some
10639 -- accidental and undocumented property. At the very least
10640 -- it needs to be documented, but it would be better to have
10641 -- a clean way of testing if we are in a configuration file???
10643 if Present (Parent (N)) then
10645 ("pragma% can only appear in a configuration pragmas file");
10648 ----------------------
10649 -- Source_Reference --
10650 ----------------------
10652 -- pragma Source_Reference (INTEGER_LITERAL [, STRING_LITERAL]);
10654 -- Nothing to do, all processing completed in Par.Prag, since we
10655 -- need the information for possible parser messages that are output
10657 when Pragma_Source_Reference =>
10660 --------------------------------
10661 -- Static_Elaboration_Desired --
10662 --------------------------------
10664 -- pragma Static_Elaboration_Desired (DIRECT_NAME);
10666 when Pragma_Static_Elaboration_Desired =>
10668 Check_At_Most_N_Arguments (1);
10670 if Is_Compilation_Unit (Current_Scope)
10671 and then Ekind (Current_Scope) = E_Package
10673 Set_Static_Elaboration_Desired (Current_Scope, True);
10675 Error_Pragma ("pragma% must apply to a library-level package");
10682 -- pragma Storage_Size (EXPRESSION);
10684 when Pragma_Storage_Size => Storage_Size : declare
10685 P : constant Node_Id := Parent (N);
10689 Check_No_Identifiers;
10690 Check_Arg_Count (1);
10692 -- The expression must be analyzed in the special manner described
10693 -- in "Handling of Default Expressions" in sem.ads.
10695 Arg := Expression (Arg1);
10696 Preanalyze_Spec_Expression (Arg, Any_Integer);
10698 if not Is_Static_Expression (Arg) then
10699 Check_Restriction (Static_Storage_Size, Arg);
10702 if Nkind (P) /= N_Task_Definition then
10707 if Has_Storage_Size_Pragma (P) then
10708 Error_Pragma ("duplicate pragma% not allowed");
10710 Set_Has_Storage_Size_Pragma (P, True);
10713 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
10714 -- ??? exp_ch9 should use this!
10722 -- pragma Storage_Unit (NUMERIC_LITERAL);
10724 -- Only permitted argument is System'Storage_Unit value
10726 when Pragma_Storage_Unit =>
10727 Check_No_Identifiers;
10728 Check_Arg_Count (1);
10729 Check_Arg_Is_Integer_Literal (Arg1);
10731 if Intval (Expression (Arg1)) /=
10732 UI_From_Int (Ttypes.System_Storage_Unit)
10734 Error_Msg_Uint_1 := UI_From_Int (Ttypes.System_Storage_Unit);
10736 ("the only allowed argument for pragma% is ^", Arg1);
10739 --------------------
10740 -- Stream_Convert --
10741 --------------------
10743 -- pragma Stream_Convert (
10744 -- [Entity =>] type_LOCAL_NAME,
10745 -- [Read =>] function_NAME,
10746 -- [Write =>] function NAME);
10748 when Pragma_Stream_Convert => Stream_Convert : declare
10750 procedure Check_OK_Stream_Convert_Function (Arg : Node_Id);
10751 -- Check that the given argument is the name of a local
10752 -- function of one argument that is not overloaded earlier
10753 -- in the current local scope. A check is also made that the
10754 -- argument is a function with one parameter.
10756 --------------------------------------
10757 -- Check_OK_Stream_Convert_Function --
10758 --------------------------------------
10760 procedure Check_OK_Stream_Convert_Function (Arg : Node_Id) is
10764 Check_Arg_Is_Local_Name (Arg);
10765 Ent := Entity (Expression (Arg));
10767 if Has_Homonym (Ent) then
10769 ("argument for pragma% may not be overloaded", Arg);
10772 if Ekind (Ent) /= E_Function
10773 or else No (First_Formal (Ent))
10774 or else Present (Next_Formal (First_Formal (Ent)))
10777 ("argument for pragma% must be" &
10778 " function of one argument", Arg);
10780 end Check_OK_Stream_Convert_Function;
10782 -- Start of processing for Stream_Convert
10786 Check_Arg_Order ((Name_Entity, Name_Read, Name_Write));
10787 Check_Arg_Count (3);
10788 Check_Optional_Identifier (Arg1, Name_Entity);
10789 Check_Optional_Identifier (Arg2, Name_Read);
10790 Check_Optional_Identifier (Arg3, Name_Write);
10791 Check_Arg_Is_Local_Name (Arg1);
10792 Check_OK_Stream_Convert_Function (Arg2);
10793 Check_OK_Stream_Convert_Function (Arg3);
10796 Typ : constant Entity_Id :=
10797 Underlying_Type (Entity (Expression (Arg1)));
10798 Read : constant Entity_Id := Entity (Expression (Arg2));
10799 Write : constant Entity_Id := Entity (Expression (Arg3));
10802 Check_First_Subtype (Arg1);
10804 -- Check for too early or too late. Note that we don't enforce
10805 -- the rule about primitive operations in this case, since, as
10806 -- is the case for explicit stream attributes themselves, these
10807 -- restrictions are not appropriate. Note that the chaining of
10808 -- the pragma by Rep_Item_Too_Late is actually the critical
10809 -- processing done for this pragma.
10811 if Rep_Item_Too_Early (Typ, N)
10813 Rep_Item_Too_Late (Typ, N, FOnly => True)
10818 -- Return if previous error
10820 if Etype (Typ) = Any_Type
10822 Etype (Read) = Any_Type
10824 Etype (Write) = Any_Type
10831 if Underlying_Type (Etype (Read)) /= Typ then
10833 ("incorrect return type for function&", Arg2);
10836 if Underlying_Type (Etype (First_Formal (Write))) /= Typ then
10838 ("incorrect parameter type for function&", Arg3);
10841 if Underlying_Type (Etype (First_Formal (Read))) /=
10842 Underlying_Type (Etype (Write))
10845 ("result type of & does not match Read parameter type",
10849 end Stream_Convert;
10851 -------------------------
10852 -- Style_Checks (GNAT) --
10853 -------------------------
10855 -- pragma Style_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
10857 -- This is processed by the parser since some of the style
10858 -- checks take place during source scanning and parsing. This
10859 -- means that we don't need to issue error messages here.
10861 when Pragma_Style_Checks => Style_Checks : declare
10862 A : constant Node_Id := Expression (Arg1);
10868 Check_No_Identifiers;
10870 -- Two argument form
10872 if Arg_Count = 2 then
10873 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
10880 E_Id := Expression (Arg2);
10883 if not Is_Entity_Name (E_Id) then
10885 ("second argument of pragma% must be entity name",
10889 E := Entity (E_Id);
10895 Set_Suppress_Style_Checks (E,
10896 (Chars (Expression (Arg1)) = Name_Off));
10897 exit when No (Homonym (E));
10903 -- One argument form
10906 Check_Arg_Count (1);
10908 if Nkind (A) = N_String_Literal then
10912 Slen : constant Natural := Natural (String_Length (S));
10913 Options : String (1 .. Slen);
10919 C := Get_String_Char (S, Int (J));
10920 exit when not In_Character_Range (C);
10921 Options (J) := Get_Character (C);
10923 -- If at end of string, set options. As per discussion
10924 -- above, no need to check for errors, since we issued
10925 -- them in the parser.
10928 Set_Style_Check_Options (Options);
10936 elsif Nkind (A) = N_Identifier then
10937 if Chars (A) = Name_All_Checks then
10938 Set_Default_Style_Check_Options;
10940 elsif Chars (A) = Name_On then
10941 Style_Check := True;
10943 elsif Chars (A) = Name_Off then
10944 Style_Check := False;
10954 -- pragma Subtitle ([Subtitle =>] STRING_LITERAL);
10956 when Pragma_Subtitle =>
10958 Check_Arg_Count (1);
10959 Check_Optional_Identifier (Arg1, Name_Subtitle);
10960 Check_Arg_Is_String_Literal (Arg1);
10966 -- pragma Suppress (IDENTIFIER [, [On =>] NAME]);
10968 when Pragma_Suppress =>
10969 Process_Suppress_Unsuppress (True);
10975 -- pragma Suppress_All;
10977 -- The only check made here is that the pragma appears in the
10978 -- proper place, i.e. following a compilation unit. If indeed
10979 -- it appears in this context, then the parser has already
10980 -- inserted an equivalent pragma Suppress (All_Checks) to get
10981 -- the required effect.
10983 when Pragma_Suppress_All =>
10985 Check_Arg_Count (0);
10987 if Nkind (Parent (N)) /= N_Compilation_Unit_Aux
10988 or else not Is_List_Member (N)
10989 or else List_Containing (N) /= Pragmas_After (Parent (N))
10992 ("misplaced pragma%, must follow compilation unit");
10995 -------------------------
10996 -- Suppress_Debug_Info --
10997 -------------------------
10999 -- pragma Suppress_Debug_Info ([Entity =>] LOCAL_NAME);
11001 when Pragma_Suppress_Debug_Info =>
11003 Check_Arg_Count (1);
11004 Check_Optional_Identifier (Arg1, Name_Entity);
11005 Check_Arg_Is_Local_Name (Arg1);
11006 Set_Debug_Info_Off (Entity (Get_Pragma_Arg (Arg1)));
11008 ----------------------------------
11009 -- Suppress_Exception_Locations --
11010 ----------------------------------
11012 -- pragma Suppress_Exception_Locations;
11014 when Pragma_Suppress_Exception_Locations =>
11016 Check_Arg_Count (0);
11017 Check_Valid_Configuration_Pragma;
11018 Exception_Locations_Suppressed := True;
11020 -----------------------------
11021 -- Suppress_Initialization --
11022 -----------------------------
11024 -- pragma Suppress_Initialization ([Entity =>] type_Name);
11026 when Pragma_Suppress_Initialization => Suppress_Init : declare
11032 Check_Arg_Count (1);
11033 Check_Optional_Identifier (Arg1, Name_Entity);
11034 Check_Arg_Is_Local_Name (Arg1);
11036 E_Id := Expression (Arg1);
11038 if Etype (E_Id) = Any_Type then
11042 E := Entity (E_Id);
11044 if Is_Type (E) then
11045 if Is_Incomplete_Or_Private_Type (E) then
11046 if No (Full_View (Base_Type (E))) then
11048 ("argument of pragma% cannot be an incomplete type",
11051 Set_Suppress_Init_Proc (Full_View (Base_Type (E)));
11054 Set_Suppress_Init_Proc (Base_Type (E));
11059 ("pragma% requires argument that is a type name", Arg1);
11067 -- pragma System_Name (DIRECT_NAME);
11069 -- Syntax check: one argument, which must be the identifier GNAT
11070 -- or the identifier GCC, no other identifiers are acceptable.
11072 when Pragma_System_Name =>
11074 Check_No_Identifiers;
11075 Check_Arg_Count (1);
11076 Check_Arg_Is_One_Of (Arg1, Name_Gcc, Name_Gnat);
11078 -----------------------------
11079 -- Task_Dispatching_Policy --
11080 -----------------------------
11082 -- pragma Task_Dispatching_Policy (policy_IDENTIFIER);
11084 when Pragma_Task_Dispatching_Policy => declare
11088 Check_Ada_83_Warning;
11089 Check_Arg_Count (1);
11090 Check_No_Identifiers;
11091 Check_Arg_Is_Task_Dispatching_Policy (Arg1);
11092 Check_Valid_Configuration_Pragma;
11093 Get_Name_String (Chars (Expression (Arg1)));
11094 DP := Fold_Upper (Name_Buffer (1));
11096 if Task_Dispatching_Policy /= ' '
11097 and then Task_Dispatching_Policy /= DP
11099 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
11101 ("task dispatching policy incompatible with policy#");
11103 -- Set new policy, but always preserve System_Location since
11104 -- we like the error message with the run time name.
11107 Task_Dispatching_Policy := DP;
11109 if Task_Dispatching_Policy_Sloc /= System_Location then
11110 Task_Dispatching_Policy_Sloc := Loc;
11119 -- pragma Task_Info (EXPRESSION);
11121 when Pragma_Task_Info => Task_Info : declare
11122 P : constant Node_Id := Parent (N);
11127 if Nkind (P) /= N_Task_Definition then
11128 Error_Pragma ("pragma% must appear in task definition");
11131 Check_No_Identifiers;
11132 Check_Arg_Count (1);
11134 Analyze_And_Resolve (Expression (Arg1), RTE (RE_Task_Info_Type));
11136 if Etype (Expression (Arg1)) = Any_Type then
11140 if Has_Task_Info_Pragma (P) then
11141 Error_Pragma ("duplicate pragma% not allowed");
11143 Set_Has_Task_Info_Pragma (P, True);
11151 -- pragma Task_Name (string_EXPRESSION);
11153 when Pragma_Task_Name => Task_Name : declare
11154 P : constant Node_Id := Parent (N);
11158 Check_No_Identifiers;
11159 Check_Arg_Count (1);
11161 Arg := Expression (Arg1);
11162 Analyze_And_Resolve (Arg, Standard_String);
11164 if Nkind (P) /= N_Task_Definition then
11168 if Has_Task_Name_Pragma (P) then
11169 Error_Pragma ("duplicate pragma% not allowed");
11171 Set_Has_Task_Name_Pragma (P, True);
11172 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
11180 -- pragma Task_Storage (
11181 -- [Task_Type =>] LOCAL_NAME,
11182 -- [Top_Guard =>] static_integer_EXPRESSION);
11184 when Pragma_Task_Storage => Task_Storage : declare
11185 Args : Args_List (1 .. 2);
11186 Names : constant Name_List (1 .. 2) := (
11190 Task_Type : Node_Id renames Args (1);
11191 Top_Guard : Node_Id renames Args (2);
11197 Gather_Associations (Names, Args);
11199 if No (Task_Type) then
11201 ("missing task_type argument for pragma%");
11204 Check_Arg_Is_Local_Name (Task_Type);
11206 Ent := Entity (Task_Type);
11208 if not Is_Task_Type (Ent) then
11210 ("argument for pragma% must be task type", Task_Type);
11213 if No (Top_Guard) then
11215 ("pragma% takes two arguments", Task_Type);
11217 Check_Arg_Is_Static_Expression (Top_Guard, Any_Integer);
11220 Check_First_Subtype (Task_Type);
11222 if Rep_Item_Too_Late (Ent, N) then
11231 -- pragma Time_Slice (static_duration_EXPRESSION);
11233 when Pragma_Time_Slice => Time_Slice : declare
11239 Check_Arg_Count (1);
11240 Check_No_Identifiers;
11241 Check_In_Main_Program;
11242 Check_Arg_Is_Static_Expression (Arg1, Standard_Duration);
11244 if not Error_Posted (Arg1) then
11246 while Present (Nod) loop
11247 if Nkind (Nod) = N_Pragma
11248 and then Pragma_Name (Nod) = Name_Time_Slice
11250 Error_Msg_Name_1 := Pname;
11251 Error_Msg_N ("duplicate pragma% not permitted", Nod);
11258 -- Process only if in main unit
11260 if Get_Source_Unit (Loc) = Main_Unit then
11261 Opt.Time_Slice_Set := True;
11262 Val := Expr_Value_R (Expression (Arg1));
11264 if Val <= Ureal_0 then
11265 Opt.Time_Slice_Value := 0;
11267 elsif Val > UR_From_Uint (UI_From_Int (1000)) then
11268 Opt.Time_Slice_Value := 1_000_000_000;
11271 Opt.Time_Slice_Value :=
11272 UI_To_Int (UR_To_Uint (Val * UI_From_Int (1_000_000)));
11281 -- pragma Title (TITLING_OPTION [, TITLING OPTION]);
11283 -- TITLING_OPTION ::=
11284 -- [Title =>] STRING_LITERAL
11285 -- | [Subtitle =>] STRING_LITERAL
11287 when Pragma_Title => Title : declare
11288 Args : Args_List (1 .. 2);
11289 Names : constant Name_List (1 .. 2) := (
11295 Gather_Associations (Names, Args);
11297 for J in 1 .. 2 loop
11298 if Present (Args (J)) then
11299 Check_Arg_Is_String_Literal (Args (J));
11304 ---------------------
11305 -- Unchecked_Union --
11306 ---------------------
11308 -- pragma Unchecked_Union (first_subtype_LOCAL_NAME)
11310 when Pragma_Unchecked_Union => Unchecked_Union : declare
11311 Assoc : constant Node_Id := Arg1;
11312 Type_Id : constant Node_Id := Expression (Assoc);
11323 Check_No_Identifiers;
11324 Check_Arg_Count (1);
11325 Check_Arg_Is_Local_Name (Arg1);
11327 Find_Type (Type_Id);
11328 Typ := Entity (Type_Id);
11331 or else Rep_Item_Too_Early (Typ, N)
11335 Typ := Underlying_Type (Typ);
11338 if Rep_Item_Too_Late (Typ, N) then
11342 Check_First_Subtype (Arg1);
11344 -- Note remaining cases are references to a type in the current
11345 -- declarative part. If we find an error, we post the error on
11346 -- the relevant type declaration at an appropriate point.
11348 if not Is_Record_Type (Typ) then
11349 Error_Msg_N ("Unchecked_Union must be record type", Typ);
11352 elsif Is_Tagged_Type (Typ) then
11353 Error_Msg_N ("Unchecked_Union must not be tagged", Typ);
11356 elsif Is_Limited_Type (Typ) then
11358 ("Unchecked_Union must not be limited record type", Typ);
11359 Explain_Limited_Type (Typ, Typ);
11363 if not Has_Discriminants (Typ) then
11365 ("Unchecked_Union must have one discriminant", Typ);
11369 Discr := First_Discriminant (Typ);
11370 while Present (Discr) loop
11371 if No (Discriminant_Default_Value (Discr)) then
11373 ("Unchecked_Union discriminant must have default value",
11376 Next_Discriminant (Discr);
11379 Tdef := Type_Definition (Declaration_Node (Typ));
11380 Clist := Component_List (Tdef);
11382 Comp := First (Component_Items (Clist));
11383 while Present (Comp) loop
11384 Check_Component (Comp);
11388 if No (Clist) or else No (Variant_Part (Clist)) then
11390 ("Unchecked_Union must have variant part",
11395 Vpart := Variant_Part (Clist);
11397 Variant := First (Variants (Vpart));
11398 while Present (Variant) loop
11399 Check_Variant (Variant);
11404 Set_Is_Unchecked_Union (Typ, True);
11405 Set_Convention (Typ, Convention_C);
11407 Set_Has_Unchecked_Union (Base_Type (Typ), True);
11408 Set_Is_Unchecked_Union (Base_Type (Typ), True);
11409 end Unchecked_Union;
11411 ------------------------
11412 -- Unimplemented_Unit --
11413 ------------------------
11415 -- pragma Unimplemented_Unit;
11417 -- Note: this only gives an error if we are generating code,
11418 -- or if we are in a generic library unit (where the pragma
11419 -- appears in the body, not in the spec).
11421 when Pragma_Unimplemented_Unit => Unimplemented_Unit : declare
11422 Cunitent : constant Entity_Id :=
11423 Cunit_Entity (Get_Source_Unit (Loc));
11424 Ent_Kind : constant Entity_Kind :=
11429 Check_Arg_Count (0);
11431 if Operating_Mode = Generate_Code
11432 or else Ent_Kind = E_Generic_Function
11433 or else Ent_Kind = E_Generic_Procedure
11434 or else Ent_Kind = E_Generic_Package
11436 Get_Name_String (Chars (Cunitent));
11437 Set_Casing (Mixed_Case);
11438 Write_Str (Name_Buffer (1 .. Name_Len));
11439 Write_Str (" is not supported in this configuration");
11441 raise Unrecoverable_Error;
11443 end Unimplemented_Unit;
11445 ------------------------
11446 -- Universal_Aliasing --
11447 ------------------------
11449 -- pragma Universal_Aliasing [([Entity =>] type_LOCAL_NAME)];
11451 when Pragma_Universal_Aliasing => Universal_Alias : declare
11456 Check_Arg_Count (1);
11457 Check_Optional_Identifier (Arg2, Name_Entity);
11458 Check_Arg_Is_Local_Name (Arg1);
11459 E_Id := Entity (Expression (Arg1));
11461 if E_Id = Any_Type then
11463 elsif No (E_Id) or else not Is_Type (E_Id) then
11464 Error_Pragma_Arg ("pragma% requires type", Arg1);
11467 Set_Universal_Aliasing (Implementation_Base_Type (E_Id));
11468 end Universal_Alias;
11470 --------------------
11471 -- Universal_Data --
11472 --------------------
11474 -- pragma Universal_Data [(library_unit_NAME)];
11476 when Pragma_Universal_Data =>
11479 -- If this is a configuration pragma, then set the universal
11480 -- addressing option, otherwise confirm that the pragma
11481 -- satisfies the requirements of library unit pragma placement
11482 -- and leave it to the GNAAMP back end to detect the pragma
11483 -- (avoids transitive setting of the option due to withed units).
11485 if Is_Configuration_Pragma then
11486 Universal_Addressing_On_AAMP := True;
11488 Check_Valid_Library_Unit_Pragma;
11491 if not AAMP_On_Target then
11492 Error_Pragma ("?pragma% ignored (applies only to AAMP)");
11499 -- pragma Unmodified (local_Name {, local_Name});
11501 when Pragma_Unmodified => Unmodified : declare
11502 Arg_Node : Node_Id;
11503 Arg_Expr : Node_Id;
11504 Arg_Ent : Entity_Id;
11508 Check_At_Least_N_Arguments (1);
11510 -- Loop through arguments
11513 while Present (Arg_Node) loop
11514 Check_No_Identifier (Arg_Node);
11516 -- Note: the analyze call done by Check_Arg_Is_Local_Name
11517 -- will in fact generate reference, so that the entity will
11518 -- have a reference, which will inhibit any warnings about
11519 -- it not being referenced, and also properly show up in the
11520 -- ali file as a reference. But this reference is recorded
11521 -- before the Has_Pragma_Unreferenced flag is set, so that
11522 -- no warning is generated for this reference.
11524 Check_Arg_Is_Local_Name (Arg_Node);
11525 Arg_Expr := Get_Pragma_Arg (Arg_Node);
11527 if Is_Entity_Name (Arg_Expr) then
11528 Arg_Ent := Entity (Arg_Expr);
11530 if not Is_Assignable (Arg_Ent) then
11532 ("pragma% can only be applied to a variable",
11535 Set_Has_Pragma_Unmodified (Arg_Ent);
11547 -- pragma Unreferenced (local_Name {, local_Name});
11549 -- or when used in a context clause:
11551 -- pragma Unreferenced (library_unit_NAME {, library_unit_NAME}
11553 when Pragma_Unreferenced => Unreferenced : declare
11554 Arg_Node : Node_Id;
11555 Arg_Expr : Node_Id;
11556 Arg_Ent : Entity_Id;
11561 Check_At_Least_N_Arguments (1);
11563 -- Check case of appearing within context clause
11565 if Is_In_Context_Clause then
11567 -- The arguments must all be units mentioned in a with clause
11568 -- in the same context clause. Note we already checked (in
11569 -- Par.Prag) that the arguments are either identifiers or
11570 -- selected components.
11573 while Present (Arg_Node) loop
11574 Citem := First (List_Containing (N));
11575 while Citem /= N loop
11576 if Nkind (Citem) = N_With_Clause
11577 and then Same_Name (Name (Citem), Expression (Arg_Node))
11579 Set_Has_Pragma_Unreferenced
11582 (Library_Unit (Citem))));
11583 Set_Unit_Name (Expression (Arg_Node), Name (Citem));
11592 ("argument of pragma% is not with'ed unit", Arg_Node);
11598 -- Case of not in list of context items
11602 while Present (Arg_Node) loop
11603 Check_No_Identifier (Arg_Node);
11605 -- Note: the analyze call done by Check_Arg_Is_Local_Name
11606 -- will in fact generate reference, so that the entity will
11607 -- have a reference, which will inhibit any warnings about
11608 -- it not being referenced, and also properly show up in the
11609 -- ali file as a reference. But this reference is recorded
11610 -- before the Has_Pragma_Unreferenced flag is set, so that
11611 -- no warning is generated for this reference.
11613 Check_Arg_Is_Local_Name (Arg_Node);
11614 Arg_Expr := Get_Pragma_Arg (Arg_Node);
11616 if Is_Entity_Name (Arg_Expr) then
11617 Arg_Ent := Entity (Arg_Expr);
11619 -- If the entity is overloaded, the pragma applies to the
11620 -- most recent overloading, as documented. In this case,
11621 -- name resolution does not generate a reference, so it
11622 -- must be done here explicitly.
11624 if Is_Overloaded (Arg_Expr) then
11625 Generate_Reference (Arg_Ent, N);
11628 Set_Has_Pragma_Unreferenced (Arg_Ent);
11636 --------------------------
11637 -- Unreferenced_Objects --
11638 --------------------------
11640 -- pragma Unreferenced_Objects (local_Name {, local_Name});
11642 when Pragma_Unreferenced_Objects => Unreferenced_Objects : declare
11643 Arg_Node : Node_Id;
11644 Arg_Expr : Node_Id;
11648 Check_At_Least_N_Arguments (1);
11651 while Present (Arg_Node) loop
11652 Check_No_Identifier (Arg_Node);
11653 Check_Arg_Is_Local_Name (Arg_Node);
11654 Arg_Expr := Get_Pragma_Arg (Arg_Node);
11656 if not Is_Entity_Name (Arg_Expr)
11657 or else not Is_Type (Entity (Arg_Expr))
11660 ("argument for pragma% must be type or subtype", Arg_Node);
11663 Set_Has_Pragma_Unreferenced_Objects (Entity (Arg_Expr));
11666 end Unreferenced_Objects;
11668 ------------------------------
11669 -- Unreserve_All_Interrupts --
11670 ------------------------------
11672 -- pragma Unreserve_All_Interrupts;
11674 when Pragma_Unreserve_All_Interrupts =>
11676 Check_Arg_Count (0);
11678 if In_Extended_Main_Code_Unit (Main_Unit_Entity) then
11679 Unreserve_All_Interrupts := True;
11686 -- pragma Unsuppress (IDENTIFIER [, [On =>] NAME]);
11688 when Pragma_Unsuppress =>
11690 Process_Suppress_Unsuppress (False);
11692 -------------------
11693 -- Use_VADS_Size --
11694 -------------------
11696 -- pragma Use_VADS_Size;
11698 when Pragma_Use_VADS_Size =>
11700 Check_Arg_Count (0);
11701 Check_Valid_Configuration_Pragma;
11702 Use_VADS_Size := True;
11704 ---------------------
11705 -- Validity_Checks --
11706 ---------------------
11708 -- pragma Validity_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
11710 when Pragma_Validity_Checks => Validity_Checks : declare
11711 A : constant Node_Id := Expression (Arg1);
11717 Check_Arg_Count (1);
11718 Check_No_Identifiers;
11720 if Nkind (A) = N_String_Literal then
11724 Slen : constant Natural := Natural (String_Length (S));
11725 Options : String (1 .. Slen);
11731 C := Get_String_Char (S, Int (J));
11732 exit when not In_Character_Range (C);
11733 Options (J) := Get_Character (C);
11736 Set_Validity_Check_Options (Options);
11744 elsif Nkind (A) = N_Identifier then
11746 if Chars (A) = Name_All_Checks then
11747 Set_Validity_Check_Options ("a");
11749 elsif Chars (A) = Name_On then
11750 Validity_Checks_On := True;
11752 elsif Chars (A) = Name_Off then
11753 Validity_Checks_On := False;
11757 end Validity_Checks;
11763 -- pragma Volatile (LOCAL_NAME);
11765 when Pragma_Volatile =>
11766 Process_Atomic_Shared_Volatile;
11768 -------------------------
11769 -- Volatile_Components --
11770 -------------------------
11772 -- pragma Volatile_Components (array_LOCAL_NAME);
11774 -- Volatile is handled by the same circuit as Atomic_Components
11780 -- pragma Warnings (On | Off);
11781 -- pragma Warnings (On | Off, LOCAL_NAME);
11782 -- pragma Warnings (static_string_EXPRESSION);
11783 -- pragma Warnings (On | Off, STRING_LITERAL);
11785 when Pragma_Warnings => Warnings : begin
11787 Check_At_Least_N_Arguments (1);
11788 Check_No_Identifiers;
11791 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
11794 -- One argument case
11796 if Arg_Count = 1 then
11798 -- On/Off one argument case was processed by parser
11800 if Nkind (Argx) = N_Identifier
11802 (Chars (Argx) = Name_On
11804 Chars (Argx) = Name_Off)
11808 -- One argument case must be ON/OFF or static string expr
11810 elsif not Is_Static_String_Expression (Arg1) then
11812 ("argument of pragma% must be On/Off or " &
11813 "static string expression", Arg2);
11815 -- One argument string expression case
11819 Lit : constant Node_Id := Expr_Value_S (Argx);
11820 Str : constant String_Id := Strval (Lit);
11821 Len : constant Nat := String_Length (Str);
11829 while J <= Len loop
11830 C := Get_String_Char (Str, J);
11831 OK := In_Character_Range (C);
11834 Chr := Get_Character (C);
11838 if J < Len and then Chr = '.' then
11840 C := Get_String_Char (Str, J);
11841 Chr := Get_Character (C);
11843 if not Set_Dot_Warning_Switch (Chr) then
11845 ("invalid warning switch character " &
11852 OK := Set_Warning_Switch (Chr);
11858 ("invalid warning switch character " & Chr,
11867 -- Two or more arguments (must be two)
11870 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
11871 Check_At_Most_N_Arguments (2);
11879 E_Id := Expression (Arg2);
11882 -- In the expansion of an inlined body, a reference to
11883 -- the formal may be wrapped in a conversion if the
11884 -- actual is a conversion. Retrieve the real entity name.
11886 if (In_Instance_Body
11887 or else In_Inlined_Body)
11888 and then Nkind (E_Id) = N_Unchecked_Type_Conversion
11890 E_Id := Expression (E_Id);
11893 -- Entity name case
11895 if Is_Entity_Name (E_Id) then
11896 E := Entity (E_Id);
11903 (E, (Chars (Expression (Arg1)) = Name_Off));
11905 if Chars (Expression (Arg1)) = Name_Off
11906 and then Warn_On_Warnings_Off
11908 Warnings_Off_Pragmas.Append ((N, E));
11911 if Is_Enumeration_Type (E) then
11915 Lit := First_Literal (E);
11916 while Present (Lit) loop
11917 Set_Warnings_Off (Lit);
11918 Next_Literal (Lit);
11923 exit when No (Homonym (E));
11928 -- Error if not entity or static string literal case
11930 elsif not Is_Static_String_Expression (Arg2) then
11932 ("second argument of pragma% must be entity " &
11933 "name or static string expression", Arg2);
11935 -- String literal case
11938 String_To_Name_Buffer
11939 (Strval (Expr_Value_S (Expression (Arg2))));
11941 -- Note on configuration pragma case: If this is a
11942 -- configuration pragma, then for an OFF pragma, we
11943 -- just set Config True in the call, which is all
11944 -- that needs to be done. For the case of ON, this
11945 -- is normally an error, unless it is canceling the
11946 -- effect of a previous OFF pragma in the same file.
11947 -- In any other case, an error will be signalled (ON
11948 -- with no matching OFF).
11950 if Chars (Argx) = Name_Off then
11951 Set_Specific_Warning_Off
11952 (Loc, Name_Buffer (1 .. Name_Len),
11953 Config => Is_Configuration_Pragma);
11955 elsif Chars (Argx) = Name_On then
11956 Set_Specific_Warning_On
11957 (Loc, Name_Buffer (1 .. Name_Len), Err);
11961 ("?pragma Warnings On with no " &
11962 "matching Warnings Off",
11972 -------------------
11973 -- Weak_External --
11974 -------------------
11976 -- pragma Weak_External ([Entity =>] LOCAL_NAME);
11978 when Pragma_Weak_External => Weak_External : declare
11983 Check_Arg_Count (1);
11984 Check_Optional_Identifier (Arg1, Name_Entity);
11985 Check_Arg_Is_Library_Level_Local_Name (Arg1);
11986 Ent := Entity (Expression (Arg1));
11988 if Rep_Item_Too_Early (Ent, N) then
11991 Ent := Underlying_Type (Ent);
11994 -- The only processing required is to link this item on to the
11995 -- list of rep items for the given entity. This is accomplished
11996 -- by the call to Rep_Item_Too_Late (when no error is detected
11997 -- and False is returned).
11999 if Rep_Item_Too_Late (Ent, N) then
12002 Set_Has_Gigi_Rep_Item (Ent);
12006 -----------------------------
12007 -- Wide_Character_Encoding --
12008 -----------------------------
12010 -- pragma Wide_Character_Encoding (IDENTIFIER);
12012 when Pragma_Wide_Character_Encoding =>
12015 -- Nothing to do, handled in parser. Note that we do not enforce
12016 -- configuration pragma placement, this pragma can appear at any
12017 -- place in the source, allowing mixed encodings within a single
12022 --------------------
12023 -- Unknown_Pragma --
12024 --------------------
12026 -- Should be impossible, since the case of an unknown pragma is
12027 -- separately processed before the case statement is entered.
12029 when Unknown_Pragma =>
12030 raise Program_Error;
12034 when Pragma_Exit => null;
12035 end Analyze_Pragma;
12037 -------------------
12038 -- Check_Enabled --
12039 -------------------
12041 function Check_Enabled (Nam : Name_Id) return Boolean is
12045 PP := Opt.Check_Policy_List;
12048 return Assertions_Enabled;
12051 Nam = Chars (Expression (First (Pragma_Argument_Associations (PP))))
12054 Chars (Expression (Last (Pragma_Argument_Associations (PP))))
12056 when Name_On | Name_Check =>
12058 when Name_Off | Name_Ignore =>
12061 raise Program_Error;
12065 PP := Next_Pragma (PP);
12070 ---------------------------------
12071 -- Delay_Config_Pragma_Analyze --
12072 ---------------------------------
12074 function Delay_Config_Pragma_Analyze (N : Node_Id) return Boolean is
12076 return Pragma_Name (N) = Name_Interrupt_State
12078 Pragma_Name (N) = Name_Priority_Specific_Dispatching;
12079 end Delay_Config_Pragma_Analyze;
12081 -------------------------
12082 -- Get_Base_Subprogram --
12083 -------------------------
12085 function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id is
12086 Result : Entity_Id;
12089 -- Follow subprogram renaming chain
12092 while Is_Subprogram (Result)
12094 (Is_Generic_Instance (Result)
12095 or else Nkind (Parent (Declaration_Node (Result))) =
12096 N_Subprogram_Renaming_Declaration)
12097 and then Present (Alias (Result))
12099 Result := Alias (Result);
12103 end Get_Base_Subprogram;
12105 --------------------
12106 -- Get_Pragma_Arg --
12107 --------------------
12109 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id is
12111 if Nkind (Arg) = N_Pragma_Argument_Association then
12112 return Expression (Arg);
12116 end Get_Pragma_Arg;
12122 procedure Initialize is
12127 -----------------------------
12128 -- Is_Config_Static_String --
12129 -----------------------------
12131 function Is_Config_Static_String (Arg : Node_Id) return Boolean is
12133 function Add_Config_Static_String (Arg : Node_Id) return Boolean;
12134 -- This is an internal recursive function that is just like the
12135 -- outer function except that it adds the string to the name buffer
12136 -- rather than placing the string in the name buffer.
12138 ------------------------------
12139 -- Add_Config_Static_String --
12140 ------------------------------
12142 function Add_Config_Static_String (Arg : Node_Id) return Boolean is
12149 if Nkind (N) = N_Op_Concat then
12150 if Add_Config_Static_String (Left_Opnd (N)) then
12151 N := Right_Opnd (N);
12157 if Nkind (N) /= N_String_Literal then
12158 Error_Msg_N ("string literal expected for pragma argument", N);
12162 for J in 1 .. String_Length (Strval (N)) loop
12163 C := Get_String_Char (Strval (N), J);
12165 if not In_Character_Range (C) then
12167 ("string literal contains invalid wide character",
12168 Sloc (N) + 1 + Source_Ptr (J));
12172 Add_Char_To_Name_Buffer (Get_Character (C));
12177 end Add_Config_Static_String;
12179 -- Start of processing for Is_Config_Static_String
12184 return Add_Config_Static_String (Arg);
12185 end Is_Config_Static_String;
12187 -----------------------------------------
12188 -- Is_Non_Significant_Pragma_Reference --
12189 -----------------------------------------
12191 -- This function makes use of the following static table which indicates
12192 -- whether a given pragma is significant. A value of -1 in this table
12193 -- indicates that the reference is significant. A value of zero indicates
12194 -- than appearance as any argument is insignificant, a positive value
12195 -- indicates that appearance in that parameter position is significant.
12197 -- A value of 99 flags a special case requiring a special check (this is
12198 -- used for cases not covered by this standard encoding, e.g. pragma Check
12199 -- where the first argument is not significant, but the others are).
12201 Sig_Flags : constant array (Pragma_Id) of Int :=
12202 (Pragma_AST_Entry => -1,
12203 Pragma_Abort_Defer => -1,
12204 Pragma_Ada_83 => -1,
12205 Pragma_Ada_95 => -1,
12206 Pragma_Ada_05 => -1,
12207 Pragma_Ada_2005 => -1,
12208 Pragma_All_Calls_Remote => -1,
12209 Pragma_Annotate => -1,
12210 Pragma_Assert => -1,
12211 Pragma_Assertion_Policy => 0,
12212 Pragma_Asynchronous => -1,
12213 Pragma_Atomic => 0,
12214 Pragma_Atomic_Components => 0,
12215 Pragma_Attach_Handler => -1,
12216 Pragma_Check => 99,
12217 Pragma_Check_Name => 0,
12218 Pragma_Check_Policy => 0,
12219 Pragma_CIL_Constructor => -1,
12220 Pragma_CPP_Class => 0,
12221 Pragma_CPP_Constructor => 0,
12222 Pragma_CPP_Virtual => 0,
12223 Pragma_CPP_Vtable => 0,
12224 Pragma_C_Pass_By_Copy => 0,
12225 Pragma_Comment => 0,
12226 Pragma_Common_Object => -1,
12227 Pragma_Compile_Time_Error => -1,
12228 Pragma_Compile_Time_Warning => -1,
12229 Pragma_Compiler_Unit => 0,
12230 Pragma_Complete_Representation => 0,
12231 Pragma_Complex_Representation => 0,
12232 Pragma_Component_Alignment => -1,
12233 Pragma_Controlled => 0,
12234 Pragma_Convention => 0,
12235 Pragma_Convention_Identifier => 0,
12236 Pragma_Debug => -1,
12237 Pragma_Debug_Policy => 0,
12238 Pragma_Detect_Blocking => -1,
12239 Pragma_Discard_Names => 0,
12240 Pragma_Elaborate => -1,
12241 Pragma_Elaborate_All => -1,
12242 Pragma_Elaborate_Body => -1,
12243 Pragma_Elaboration_Checks => -1,
12244 Pragma_Eliminate => -1,
12245 Pragma_Export => -1,
12246 Pragma_Export_Exception => -1,
12247 Pragma_Export_Function => -1,
12248 Pragma_Export_Object => -1,
12249 Pragma_Export_Procedure => -1,
12250 Pragma_Export_Value => -1,
12251 Pragma_Export_Valued_Procedure => -1,
12252 Pragma_Extend_System => -1,
12253 Pragma_Extensions_Allowed => -1,
12254 Pragma_External => -1,
12255 Pragma_Favor_Top_Level => -1,
12256 Pragma_External_Name_Casing => -1,
12257 Pragma_Fast_Math => -1,
12258 Pragma_Finalize_Storage_Only => 0,
12259 Pragma_Float_Representation => 0,
12260 Pragma_Ident => -1,
12261 Pragma_Implemented_By_Entry => -1,
12262 Pragma_Implicit_Packing => 0,
12263 Pragma_Import => +2,
12264 Pragma_Import_Exception => 0,
12265 Pragma_Import_Function => 0,
12266 Pragma_Import_Object => 0,
12267 Pragma_Import_Procedure => 0,
12268 Pragma_Import_Valued_Procedure => 0,
12269 Pragma_Initialize_Scalars => -1,
12270 Pragma_Inline => 0,
12271 Pragma_Inline_Always => 0,
12272 Pragma_Inline_Generic => 0,
12273 Pragma_Inspection_Point => -1,
12274 Pragma_Interface => +2,
12275 Pragma_Interface_Name => +2,
12276 Pragma_Interrupt_Handler => -1,
12277 Pragma_Interrupt_Priority => -1,
12278 Pragma_Interrupt_State => -1,
12279 Pragma_Java_Constructor => -1,
12280 Pragma_Java_Interface => -1,
12281 Pragma_Keep_Names => 0,
12282 Pragma_License => -1,
12283 Pragma_Link_With => -1,
12284 Pragma_Linker_Alias => -1,
12285 Pragma_Linker_Constructor => -1,
12286 Pragma_Linker_Destructor => -1,
12287 Pragma_Linker_Options => -1,
12288 Pragma_Linker_Section => -1,
12290 Pragma_Locking_Policy => -1,
12291 Pragma_Long_Float => -1,
12292 Pragma_Machine_Attribute => -1,
12294 Pragma_Main_Storage => -1,
12295 Pragma_Memory_Size => -1,
12296 Pragma_No_Return => 0,
12297 Pragma_No_Body => 0,
12298 Pragma_No_Run_Time => -1,
12299 Pragma_No_Strict_Aliasing => -1,
12300 Pragma_Normalize_Scalars => -1,
12301 Pragma_Obsolescent => 0,
12302 Pragma_Optimize => -1,
12303 Pragma_Optimize_Alignment => -1,
12306 Pragma_Passive => -1,
12307 Pragma_Preelaborable_Initialization => -1,
12308 Pragma_Polling => -1,
12309 Pragma_Persistent_BSS => 0,
12310 Pragma_Postcondition => -1,
12311 Pragma_Precondition => -1,
12312 Pragma_Preelaborate => -1,
12313 Pragma_Preelaborate_05 => -1,
12314 Pragma_Priority => -1,
12315 Pragma_Priority_Specific_Dispatching => -1,
12316 Pragma_Profile => 0,
12317 Pragma_Profile_Warnings => 0,
12318 Pragma_Propagate_Exceptions => -1,
12319 Pragma_Psect_Object => -1,
12321 Pragma_Pure_05 => -1,
12322 Pragma_Pure_Function => -1,
12323 Pragma_Queuing_Policy => -1,
12324 Pragma_Ravenscar => -1,
12325 Pragma_Relative_Deadline => -1,
12326 Pragma_Remote_Call_Interface => -1,
12327 Pragma_Remote_Types => -1,
12328 Pragma_Restricted_Run_Time => -1,
12329 Pragma_Restriction_Warnings => -1,
12330 Pragma_Restrictions => -1,
12331 Pragma_Reviewable => -1,
12332 Pragma_Share_Generic => -1,
12333 Pragma_Shared => -1,
12334 Pragma_Shared_Passive => -1,
12335 Pragma_Source_File_Name => -1,
12336 Pragma_Source_File_Name_Project => -1,
12337 Pragma_Source_Reference => -1,
12338 Pragma_Storage_Size => -1,
12339 Pragma_Storage_Unit => -1,
12340 Pragma_Static_Elaboration_Desired => -1,
12341 Pragma_Stream_Convert => -1,
12342 Pragma_Style_Checks => -1,
12343 Pragma_Subtitle => -1,
12344 Pragma_Suppress => 0,
12345 Pragma_Suppress_Exception_Locations => 0,
12346 Pragma_Suppress_All => -1,
12347 Pragma_Suppress_Debug_Info => 0,
12348 Pragma_Suppress_Initialization => 0,
12349 Pragma_System_Name => -1,
12350 Pragma_Task_Dispatching_Policy => -1,
12351 Pragma_Task_Info => -1,
12352 Pragma_Task_Name => -1,
12353 Pragma_Task_Storage => 0,
12354 Pragma_Time_Slice => -1,
12355 Pragma_Title => -1,
12356 Pragma_Unchecked_Union => 0,
12357 Pragma_Unimplemented_Unit => -1,
12358 Pragma_Universal_Aliasing => -1,
12359 Pragma_Universal_Data => -1,
12360 Pragma_Unmodified => -1,
12361 Pragma_Unreferenced => -1,
12362 Pragma_Unreferenced_Objects => -1,
12363 Pragma_Unreserve_All_Interrupts => -1,
12364 Pragma_Unsuppress => 0,
12365 Pragma_Use_VADS_Size => -1,
12366 Pragma_Validity_Checks => -1,
12367 Pragma_Volatile => 0,
12368 Pragma_Volatile_Components => 0,
12369 Pragma_Warnings => -1,
12370 Pragma_Weak_External => -1,
12371 Pragma_Wide_Character_Encoding => 0,
12372 Unknown_Pragma => 0);
12374 function Is_Non_Significant_Pragma_Reference (N : Node_Id) return Boolean is
12383 if Nkind (P) /= N_Pragma_Argument_Association then
12387 Id := Get_Pragma_Id (Parent (P));
12388 C := Sig_Flags (Id);
12400 -- For pragma Check, the first argument is not significant,
12401 -- the second and the third (if present) arguments are
12404 when Pragma_Check =>
12406 P = First (Pragma_Argument_Associations (Parent (P)));
12409 raise Program_Error;
12413 A := First (Pragma_Argument_Associations (Parent (P)));
12414 for J in 1 .. C - 1 loop
12422 return A = P; -- is this wrong way round ???
12425 end Is_Non_Significant_Pragma_Reference;
12427 ------------------------------
12428 -- Is_Pragma_String_Literal --
12429 ------------------------------
12431 -- This function returns true if the corresponding pragma argument is
12432 -- a static string expression. These are the only cases in which string
12433 -- literals can appear as pragma arguments. We also allow a string
12434 -- literal as the first argument to pragma Assert (although it will
12435 -- of course always generate a type error).
12437 function Is_Pragma_String_Literal (Par : Node_Id) return Boolean is
12438 Pragn : constant Node_Id := Parent (Par);
12439 Assoc : constant List_Id := Pragma_Argument_Associations (Pragn);
12440 Pname : constant Name_Id := Pragma_Name (Pragn);
12446 N := First (Assoc);
12453 if Pname = Name_Assert then
12456 elsif Pname = Name_Export then
12459 elsif Pname = Name_Ident then
12462 elsif Pname = Name_Import then
12465 elsif Pname = Name_Interface_Name then
12468 elsif Pname = Name_Linker_Alias then
12471 elsif Pname = Name_Linker_Section then
12474 elsif Pname = Name_Machine_Attribute then
12477 elsif Pname = Name_Source_File_Name then
12480 elsif Pname = Name_Source_Reference then
12483 elsif Pname = Name_Title then
12486 elsif Pname = Name_Subtitle then
12492 end Is_Pragma_String_Literal;
12494 --------------------------------------
12495 -- Process_Compilation_Unit_Pragmas --
12496 --------------------------------------
12498 procedure Process_Compilation_Unit_Pragmas (N : Node_Id) is
12500 -- A special check for pragma Suppress_All. This is a strange DEC
12501 -- pragma, strange because it comes at the end of the unit. If we
12502 -- have a pragma Suppress_All in the Pragmas_After of the current
12503 -- unit, then we insert a pragma Suppress (All_Checks) at the start
12504 -- of the context clause to ensure the correct processing.
12507 PA : constant List_Id := Pragmas_After (Aux_Decls_Node (N));
12511 if Present (PA) then
12513 while Present (P) loop
12514 if Pragma_Name (P) = Name_Suppress_All then
12515 Prepend_To (Context_Items (N),
12516 Make_Pragma (Sloc (P),
12517 Chars => Name_Suppress,
12518 Pragma_Argument_Associations => New_List (
12519 Make_Pragma_Argument_Association (Sloc (P),
12521 Make_Identifier (Sloc (P),
12522 Chars => Name_All_Checks)))));
12530 end Process_Compilation_Unit_Pragmas;
12541 --------------------------------
12542 -- Set_Encoded_Interface_Name --
12543 --------------------------------
12545 procedure Set_Encoded_Interface_Name (E : Entity_Id; S : Node_Id) is
12546 Str : constant String_Id := Strval (S);
12547 Len : constant Int := String_Length (Str);
12552 Hex : constant array (0 .. 15) of Character := "0123456789abcdef";
12555 -- Stores encoded value of character code CC. The encoding we
12556 -- use an underscore followed by four lower case hex digits.
12562 procedure Encode is
12564 Store_String_Char (Get_Char_Code ('_'));
12566 (Get_Char_Code (Hex (Integer (CC / 2 ** 12))));
12568 (Get_Char_Code (Hex (Integer (CC / 2 ** 8 and 16#0F#))));
12570 (Get_Char_Code (Hex (Integer (CC / 2 ** 4 and 16#0F#))));
12572 (Get_Char_Code (Hex (Integer (CC and 16#0F#))));
12575 -- Start of processing for Set_Encoded_Interface_Name
12578 -- If first character is asterisk, this is a link name, and we
12579 -- leave it completely unmodified. We also ignore null strings
12580 -- (the latter case happens only in error cases) and no encoding
12581 -- should occur for Java or AAMP interface names.
12584 or else Get_String_Char (Str, 1) = Get_Char_Code ('*')
12585 or else VM_Target /= No_VM
12586 or else AAMP_On_Target
12588 Set_Interface_Name (E, S);
12593 CC := Get_String_Char (Str, J);
12595 exit when not In_Character_Range (CC);
12597 C := Get_Character (CC);
12599 exit when C /= '_' and then C /= '$'
12600 and then C not in '0' .. '9'
12601 and then C not in 'a' .. 'z'
12602 and then C not in 'A' .. 'Z';
12605 Set_Interface_Name (E, S);
12613 -- Here we need to encode. The encoding we use as follows:
12614 -- three underscores + four hex digits (lower case)
12618 for J in 1 .. String_Length (Str) loop
12619 CC := Get_String_Char (Str, J);
12621 if not In_Character_Range (CC) then
12624 C := Get_Character (CC);
12626 if C = '_' or else C = '$'
12627 or else C in '0' .. '9'
12628 or else C in 'a' .. 'z'
12629 or else C in 'A' .. 'Z'
12631 Store_String_Char (CC);
12638 Set_Interface_Name (E,
12639 Make_String_Literal (Sloc (S),
12640 Strval => End_String));
12642 end Set_Encoded_Interface_Name;
12644 -------------------
12645 -- Set_Unit_Name --
12646 -------------------
12648 procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id) is
12653 if Nkind (N) = N_Identifier
12654 and then Nkind (With_Item) = N_Identifier
12656 Set_Entity (N, Entity (With_Item));
12658 elsif Nkind (N) = N_Selected_Component then
12659 Change_Selected_Component_To_Expanded_Name (N);
12660 Set_Entity (N, Entity (With_Item));
12661 Set_Entity (Selector_Name (N), Entity (N));
12663 Pref := Prefix (N);
12664 Scop := Scope (Entity (N));
12665 while Nkind (Pref) = N_Selected_Component loop
12666 Change_Selected_Component_To_Expanded_Name (Pref);
12667 Set_Entity (Selector_Name (Pref), Scop);
12668 Set_Entity (Pref, Scop);
12669 Pref := Prefix (Pref);
12670 Scop := Scope (Scop);
12673 Set_Entity (Pref, Scop);