1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2010, 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 Elists; use Elists;
39 with Errout; use Errout;
40 with Exp_Ch7; use Exp_Ch7;
41 with Exp_Dist; use Exp_Dist;
43 with Lib.Writ; use Lib.Writ;
44 with Lib.Xref; use Lib.Xref;
45 with Namet.Sp; use Namet.Sp;
46 with Nlists; use Nlists;
47 with Nmake; use Nmake;
49 with Output; use Output;
50 with Par_SCO; use Par_SCO;
51 with Restrict; use Restrict;
52 with Rident; use Rident;
53 with Rtsfind; use Rtsfind;
55 with Sem_Aux; use Sem_Aux;
56 with Sem_Ch3; use Sem_Ch3;
57 with Sem_Ch6; use Sem_Ch6;
58 with Sem_Ch8; use Sem_Ch8;
59 with Sem_Ch12; use Sem_Ch12;
60 with Sem_Ch13; use Sem_Ch13;
61 with Sem_Dist; use Sem_Dist;
62 with Sem_Elim; use Sem_Elim;
63 with Sem_Eval; use Sem_Eval;
64 with Sem_Intr; use Sem_Intr;
65 with Sem_Mech; use Sem_Mech;
66 with Sem_Res; use Sem_Res;
67 with Sem_Type; use Sem_Type;
68 with Sem_Util; use Sem_Util;
69 with Sem_VFpt; use Sem_VFpt;
70 with Sem_Warn; use Sem_Warn;
71 with Stand; use Stand;
72 with Sinfo; use Sinfo;
73 with Sinfo.CN; use Sinfo.CN;
74 with Sinput; use Sinput;
75 with Snames; use Snames;
76 with Stringt; use Stringt;
77 with Stylesw; use Stylesw;
79 with Targparm; use Targparm;
80 with Tbuild; use Tbuild;
82 with Uintp; use Uintp;
83 with Uname; use Uname;
84 with Urealp; use Urealp;
85 with Validsw; use Validsw;
87 package body Sem_Prag is
89 ----------------------------------------------
90 -- Common Handling of Import-Export Pragmas --
91 ----------------------------------------------
93 -- In the following section, a number of Import_xxx and Export_xxx
94 -- pragmas are defined by GNAT. These are compatible with the DEC
95 -- pragmas of the same name, and all have the following common
96 -- form and processing:
99 -- [Internal =>] LOCAL_NAME
100 -- [, [External =>] EXTERNAL_SYMBOL]
101 -- [, other optional parameters ]);
104 -- [Internal =>] LOCAL_NAME
105 -- [, [External =>] EXTERNAL_SYMBOL]
106 -- [, other optional parameters ]);
108 -- EXTERNAL_SYMBOL ::=
110 -- | static_string_EXPRESSION
112 -- The internal LOCAL_NAME designates the entity that is imported or
113 -- exported, and must refer to an entity in the current declarative
114 -- part (as required by the rules for LOCAL_NAME).
116 -- The external linker name is designated by the External parameter if
117 -- given, or the Internal parameter if not (if there is no External
118 -- parameter, the External parameter is a copy of the Internal name).
120 -- If the External parameter is given as a string, then this string is
121 -- treated as an external name (exactly as though it had been given as an
122 -- External_Name parameter for a normal Import pragma).
124 -- If the External parameter is given as an identifier (or there is no
125 -- External parameter, so that the Internal identifier is used), then
126 -- the external name is the characters of the identifier, translated
127 -- to all upper case letters for OpenVMS versions of GNAT, and to all
128 -- lower case letters for all other versions
130 -- Note: the external name specified or implied by any of these special
131 -- Import_xxx or Export_xxx pragmas override an external or link name
132 -- specified in a previous Import or Export pragma.
134 -- Note: these and all other DEC-compatible GNAT pragmas allow full use of
135 -- named notation, following the standard rules for subprogram calls, i.e.
136 -- parameters can be given in any order if named notation is used, and
137 -- positional and named notation can be mixed, subject to the rule that all
138 -- positional parameters must appear first.
140 -- Note: All these pragmas are implemented exactly following the DEC design
141 -- and implementation and are intended to be fully compatible with the use
142 -- of these pragmas in the DEC Ada compiler.
144 --------------------------------------------
145 -- Checking for Duplicated External Names --
146 --------------------------------------------
148 -- It is suspicious if two separate Export pragmas use the same external
149 -- name. The following table is used to diagnose this situation so that
150 -- an appropriate warning can be issued.
152 -- The Node_Id stored is for the N_String_Literal node created to hold
153 -- the value of the external name. The Sloc of this node is used to
154 -- cross-reference the location of the duplication.
156 package Externals is new Table.Table (
157 Table_Component_Type => Node_Id,
158 Table_Index_Type => Int,
159 Table_Low_Bound => 0,
160 Table_Initial => 100,
161 Table_Increment => 100,
162 Table_Name => "Name_Externals");
164 -------------------------------------
165 -- Local Subprograms and Variables --
166 -------------------------------------
168 function Adjust_External_Name_Case (N : Node_Id) return Node_Id;
169 -- This routine is used for possible casing adjustment of an explicit
170 -- external name supplied as a string literal (the node N), according to
171 -- the casing requirement of Opt.External_Name_Casing. If this is set to
172 -- As_Is, then the string literal is returned unchanged, but if it is set
173 -- to Uppercase or Lowercase, then a new string literal with appropriate
174 -- casing is constructed.
176 function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id;
177 -- If Def_Id refers to a renamed subprogram, then the base subprogram (the
178 -- original one, following the renaming chain) is returned. Otherwise the
179 -- entity is returned unchanged. Should be in Einfo???
181 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id;
182 -- All the routines that check pragma arguments take either a pragma
183 -- argument association (in which case the expression of the argument
184 -- association is checked), or the expression directly. The function
185 -- Get_Pragma_Arg is a utility used to deal with these two cases. If Arg
186 -- is a pragma argument association node, then its expression is returned,
187 -- otherwise Arg is returned unchanged.
190 -- This is a dummy function called by the processing for pragma Reviewable.
191 -- It is there for assisting front end debugging. By placing a Reviewable
192 -- pragma in the source program, a breakpoint on rv catches this place in
193 -- the source, allowing convenient stepping to the point of interest.
195 procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id);
196 -- Place semantic information on the argument of an Elaborate/Elaborate_All
197 -- pragma. Entity name for unit and its parents is taken from item in
198 -- previous with_clause that mentions the unit.
200 -------------------------------
201 -- Adjust_External_Name_Case --
202 -------------------------------
204 function Adjust_External_Name_Case (N : Node_Id) return Node_Id is
208 -- Adjust case of literal if required
210 if Opt.External_Name_Exp_Casing = As_Is then
214 -- Copy existing string
220 for J in 1 .. String_Length (Strval (N)) loop
221 CC := Get_String_Char (Strval (N), J);
223 if Opt.External_Name_Exp_Casing = Uppercase
224 and then CC >= Get_Char_Code ('a')
225 and then CC <= Get_Char_Code ('z')
227 Store_String_Char (CC - 32);
229 elsif Opt.External_Name_Exp_Casing = Lowercase
230 and then CC >= Get_Char_Code ('A')
231 and then CC <= Get_Char_Code ('Z')
233 Store_String_Char (CC + 32);
236 Store_String_Char (CC);
241 Make_String_Literal (Sloc (N),
242 Strval => End_String);
244 end Adjust_External_Name_Case;
246 ------------------------------
247 -- Analyze_PPC_In_Decl_Part --
248 ------------------------------
250 procedure Analyze_PPC_In_Decl_Part (N : Node_Id; S : Entity_Id) is
251 Arg1 : constant Node_Id :=
252 First (Pragma_Argument_Associations (N));
253 Arg2 : constant Node_Id := Next (Arg1);
256 -- Install formals and push subprogram spec onto scope stack so that we
257 -- can see the formals from the pragma.
262 -- Preanalyze the boolean expression, we treat this as a spec expression
263 -- (i.e. similar to a default expression).
265 Preanalyze_Spec_Expression
266 (Get_Pragma_Arg (Arg1), Standard_Boolean);
268 -- If there is a message argument, analyze it the same way
270 if Present (Arg2) then
271 Preanalyze_Spec_Expression
272 (Get_Pragma_Arg (Arg2), Standard_String);
275 -- Remove the subprogram from the scope stack now that the pre-analysis
276 -- of the precondition/postcondition is done.
279 end Analyze_PPC_In_Decl_Part;
285 procedure Analyze_Pragma (N : Node_Id) is
286 Loc : constant Source_Ptr := Sloc (N);
287 Pname : constant Name_Id := Pragma_Name (N);
290 Pragma_Exit : exception;
291 -- This exception is used to exit pragma processing completely. It is
292 -- used when an error is detected, and no further processing is
293 -- required. It is also used if an earlier error has left the tree in
294 -- a state where the pragma should not be processed.
297 -- Number of pragma argument associations
303 -- First four pragma arguments (pragma argument association nodes, or
304 -- Empty if the corresponding argument does not exist).
306 type Name_List is array (Natural range <>) of Name_Id;
307 type Args_List is array (Natural range <>) of Node_Id;
308 -- Types used for arguments to Check_Arg_Order and Gather_Associations
310 procedure Ada_2005_Pragma;
311 -- Called for pragmas defined in Ada 2005, that are not in Ada 95. In
312 -- Ada 95 mode, these are implementation defined pragmas, so should be
313 -- caught by the No_Implementation_Pragmas restriction
315 procedure Check_Ada_83_Warning;
316 -- Issues a warning message for the current pragma if operating in Ada
317 -- 83 mode (used for language pragmas that are not a standard part of
318 -- Ada 83). This procedure does not raise Error_Pragma. Also notes use
321 procedure Check_Arg_Count (Required : Nat);
322 -- Check argument count for pragma is equal to given parameter. If not,
323 -- then issue an error message and raise Pragma_Exit.
325 -- Note: all routines whose name is Check_Arg_Is_xxx take an argument
326 -- Arg which can either be a pragma argument association, in which case
327 -- the check is applied to the expression of the association or an
328 -- expression directly.
330 procedure Check_Arg_Is_External_Name (Arg : Node_Id);
331 -- Check that an argument has the right form for an EXTERNAL_NAME
332 -- parameter of an extended import/export pragma. The rule is that the
333 -- name must be an identifier or string literal (in Ada 83 mode) or a
334 -- static string expression (in Ada 95 mode).
336 procedure Check_Arg_Is_Identifier (Arg : Node_Id);
337 -- Check the specified argument Arg to make sure that it is an
338 -- identifier. If not give error and raise Pragma_Exit.
340 procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id);
341 -- Check the specified argument Arg to make sure that it is an integer
342 -- literal. If not give error and raise Pragma_Exit.
344 procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id);
345 -- Check the specified argument Arg to make sure that it has the proper
346 -- syntactic form for a local name and meets the semantic requirements
347 -- for a local name. The local name is analyzed as part of the
348 -- processing for this call. In addition, the local name is required
349 -- to represent an entity at the library level.
351 procedure Check_Arg_Is_Local_Name (Arg : Node_Id);
352 -- Check the specified argument Arg to make sure that it has the proper
353 -- syntactic form for a local name and meets the semantic requirements
354 -- for a local name. The local name is analyzed as part of the
355 -- processing for this call.
357 procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id);
358 -- Check the specified argument Arg to make sure that it is a valid
359 -- locking policy name. If not give error and raise Pragma_Exit.
361 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id);
362 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2, N3 : Name_Id);
363 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2, N3, N4 : Name_Id);
364 -- Check the specified argument Arg to make sure that it is an
365 -- identifier whose name matches either N1 or N2 (or N3 if present).
366 -- If not then give error and raise Pragma_Exit.
368 procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id);
369 -- Check the specified argument Arg to make sure that it is a valid
370 -- queuing policy name. If not give error and raise Pragma_Exit.
372 procedure Check_Arg_Is_Static_Expression
374 Typ : Entity_Id := Empty);
375 -- Check the specified argument Arg to make sure that it is a static
376 -- expression of the given type (i.e. it will be analyzed and resolved
377 -- using this type, which can be any valid argument to Resolve, e.g.
378 -- Any_Integer is OK). If not, given error and raise Pragma_Exit. If
379 -- Typ is left Empty, then any static expression is allowed.
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 task
383 -- dispatching policy name. If not give error and raise Pragma_Exit.
385 procedure Check_Arg_Order (Names : Name_List);
386 -- Checks for an instance of two arguments with identifiers for the
387 -- current pragma which are not in the sequence indicated by Names,
388 -- and if so, generates a fatal message about bad order of arguments.
390 procedure Check_At_Least_N_Arguments (N : Nat);
391 -- Check there are at least N arguments present
393 procedure Check_At_Most_N_Arguments (N : Nat);
394 -- Check there are no more than N arguments present
396 procedure Check_Component
399 In_Variant_Part : Boolean := False);
400 -- Examine an Unchecked_Union component for correct use of per-object
401 -- constrained subtypes, and for restrictions on finalizable components.
402 -- UU_Typ is the related Unchecked_Union type. Flag In_Variant_Part
403 -- should be set when Comp comes from a record variant.
405 procedure Check_Duplicated_Export_Name (Nam : Node_Id);
406 -- Nam is an N_String_Literal node containing the external name set by
407 -- an Import or Export pragma (or extended Import or Export pragma).
408 -- This procedure checks for possible duplications if this is the export
409 -- case, and if found, issues an appropriate error message.
411 procedure Check_First_Subtype (Arg : Node_Id);
412 -- Checks that Arg, whose expression is an entity name referencing a
413 -- subtype, does not reference a type that is not a first subtype.
415 procedure Check_In_Main_Program;
416 -- Common checks for pragmas that appear within a main program
417 -- (Priority, Main_Storage, Time_Slice, Relative_Deadline).
419 procedure Check_Interrupt_Or_Attach_Handler;
420 -- Common processing for first argument of pragma Interrupt_Handler or
421 -- pragma Attach_Handler.
423 procedure Check_Is_In_Decl_Part_Or_Package_Spec;
424 -- Check that pragma appears in a declarative part, or in a package
425 -- specification, i.e. that it does not occur in a statement sequence
428 procedure Check_No_Identifier (Arg : Node_Id);
429 -- Checks that the given argument does not have an identifier. If
430 -- an identifier is present, then an error message is issued, and
431 -- Pragma_Exit is raised.
433 procedure Check_No_Identifiers;
434 -- Checks that none of the arguments to the pragma has an identifier.
435 -- If any argument has an identifier, then an error message is issued,
436 -- and Pragma_Exit is raised.
438 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id);
439 -- Checks if the given argument has an identifier, and if so, requires
440 -- it to match the given identifier name. If there is a non-matching
441 -- identifier, then an error message is given and Error_Pragmas raised.
443 procedure Check_Optional_Identifier (Arg : Node_Id; Id : String);
444 -- Checks if the given argument has an identifier, and if so, requires
445 -- it to match the given identifier name. If there is a non-matching
446 -- identifier, then an error message is given and Error_Pragmas raised.
447 -- In this version of the procedure, the identifier name is given as
448 -- a string with lower case letters.
450 procedure Check_Precondition_Postcondition (In_Body : out Boolean);
451 -- Called to process a precondition or postcondition pragma. There are
454 -- The pragma appears after a subprogram spec
456 -- If the corresponding check is not enabled, the pragma is analyzed
457 -- but otherwise ignored and control returns with In_Body set False.
459 -- If the check is enabled, then the first step is to analyze the
460 -- pragma, but this is skipped if the subprogram spec appears within
461 -- a package specification (because this is the case where we delay
462 -- analysis till the end of the spec). Then (whether or not it was
463 -- analyzed), the pragma is chained to the subprogram in question
464 -- (using Spec_PPC_List and Next_Pragma) and control returns to the
465 -- caller with In_Body set False.
467 -- The pragma appears at the start of subprogram body declarations
469 -- In this case an immediate return to the caller is made with
470 -- In_Body set True, and the pragma is NOT analyzed.
472 -- In all other cases, an error message for bad placement is given
474 procedure Check_Static_Constraint (Constr : Node_Id);
475 -- Constr is a constraint from an N_Subtype_Indication node from a
476 -- component constraint in an Unchecked_Union type. This routine checks
477 -- that the constraint is static as required by the restrictions for
480 procedure Check_Valid_Configuration_Pragma;
481 -- Legality checks for placement of a configuration pragma
483 procedure Check_Valid_Library_Unit_Pragma;
484 -- Legality checks for library unit pragmas. A special case arises for
485 -- pragmas in generic instances that come from copies of the original
486 -- library unit pragmas in the generic templates. In the case of other
487 -- than library level instantiations these can appear in contexts which
488 -- would normally be invalid (they only apply to the original template
489 -- and to library level instantiations), and they are simply ignored,
490 -- which is implemented by rewriting them as null statements.
492 procedure Check_Variant (Variant : Node_Id; UU_Typ : Entity_Id);
493 -- Check an Unchecked_Union variant for lack of nested variants and
494 -- presence of at least one component. UU_Typ is the related Unchecked_
497 procedure Error_Pragma (Msg : String);
498 pragma No_Return (Error_Pragma);
499 -- Outputs error message for current pragma. The message contains a %
500 -- that will be replaced with the pragma name, and the flag is placed
501 -- on the pragma itself. Pragma_Exit is then raised.
503 procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id);
504 pragma No_Return (Error_Pragma_Arg);
505 -- Outputs error message for current pragma. The message may contain
506 -- a % that will be replaced with the pragma name. The parameter Arg
507 -- may either be a pragma argument association, in which case the flag
508 -- is placed on the expression of this association, or an expression,
509 -- in which case the flag is placed directly on the expression. The
510 -- message is placed using Error_Msg_N, so the message may also contain
511 -- an & insertion character which will reference the given Arg value.
512 -- After placing the message, Pragma_Exit is raised.
514 procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id);
515 pragma No_Return (Error_Pragma_Arg);
516 -- Similar to above form of Error_Pragma_Arg except that two messages
517 -- are provided, the second is a continuation comment starting with \.
519 procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id);
520 pragma No_Return (Error_Pragma_Arg_Ident);
521 -- Outputs error message for current pragma. The message may contain
522 -- a % that will be replaced with the pragma name. The parameter Arg
523 -- must be a pragma argument association with a non-empty identifier
524 -- (i.e. its Chars field must be set), and the error message is placed
525 -- on the identifier. The message is placed using Error_Msg_N so
526 -- the message may also contain an & insertion character which will
527 -- reference the identifier. After placing the message, Pragma_Exit
530 procedure Error_Pragma_Ref (Msg : String; Ref : Entity_Id);
531 pragma No_Return (Error_Pragma_Ref);
532 -- Outputs error message for current pragma. The message may contain
533 -- a % that will be replaced with the pragma name. The parameter Ref
534 -- must be an entity whose name can be referenced by & and sloc by #.
535 -- After placing the message, Pragma_Exit is raised.
537 function Find_Lib_Unit_Name return Entity_Id;
538 -- Used for a library unit pragma to find the entity to which the
539 -- library unit pragma applies, returns the entity found.
541 procedure Find_Program_Unit_Name (Id : Node_Id);
542 -- If the pragma is a compilation unit pragma, the id must denote the
543 -- compilation unit in the same compilation, and the pragma must appear
544 -- in the list of preceding or trailing pragmas. If it is a program
545 -- unit pragma that is not a compilation unit pragma, then the
546 -- identifier must be visible.
548 function Find_Unique_Parameterless_Procedure
550 Arg : Node_Id) return Entity_Id;
551 -- Used for a procedure pragma to find the unique parameterless
552 -- procedure identified by Name, returns it if it exists, otherwise
553 -- errors out and uses Arg as the pragma argument for the message.
555 procedure Gather_Associations
557 Args : out Args_List);
558 -- This procedure is used to gather the arguments for a pragma that
559 -- permits arbitrary ordering of parameters using the normal rules
560 -- for named and positional parameters. The Names argument is a list
561 -- of Name_Id values that corresponds to the allowed pragma argument
562 -- association identifiers in order. The result returned in Args is
563 -- a list of corresponding expressions that are the pragma arguments.
564 -- Note that this is a list of expressions, not of pragma argument
565 -- associations (Gather_Associations has completely checked all the
566 -- optional identifiers when it returns). An entry in Args is Empty
567 -- on return if the corresponding argument is not present.
569 procedure GNAT_Pragma;
570 -- Called for all GNAT defined pragmas to check the relevant restriction
571 -- (No_Implementation_Pragmas).
573 function Is_Before_First_Decl
574 (Pragma_Node : Node_Id;
575 Decls : List_Id) return Boolean;
576 -- Return True if Pragma_Node is before the first declarative item in
577 -- Decls where Decls is the list of declarative items.
579 function Is_Configuration_Pragma return Boolean;
580 -- Determines if the placement of the current pragma is appropriate
581 -- for a configuration pragma.
583 function Is_In_Context_Clause return Boolean;
584 -- Returns True if pragma appears within the context clause of a unit,
585 -- and False for any other placement (does not generate any messages).
587 function Is_Static_String_Expression (Arg : Node_Id) return Boolean;
588 -- Analyzes the argument, and determines if it is a static string
589 -- expression, returns True if so, False if non-static or not String.
591 procedure Pragma_Misplaced;
592 pragma No_Return (Pragma_Misplaced);
593 -- Issue fatal error message for misplaced pragma
595 procedure Process_Atomic_Shared_Volatile;
596 -- Common processing for pragmas Atomic, Shared, Volatile. Note that
597 -- Shared is an obsolete Ada 83 pragma, treated as being identical
598 -- in effect to pragma Atomic.
600 procedure Process_Compile_Time_Warning_Or_Error;
601 -- Common processing for Compile_Time_Error and Compile_Time_Warning
603 procedure Process_Convention
604 (C : out Convention_Id;
605 Ent : out Entity_Id);
606 -- Common processing for Convention, Interface, Import and Export.
607 -- Checks first two arguments of pragma, and sets the appropriate
608 -- convention value in the specified entity or entities. On return
609 -- C is the convention, Ent is the referenced entity.
611 procedure Process_Extended_Import_Export_Exception_Pragma
612 (Arg_Internal : Node_Id;
613 Arg_External : Node_Id;
616 -- Common processing for the pragmas Import/Export_Exception. The three
617 -- arguments correspond to the three named parameters of the pragma. An
618 -- argument is empty if the corresponding parameter is not present in
621 procedure Process_Extended_Import_Export_Object_Pragma
622 (Arg_Internal : Node_Id;
623 Arg_External : Node_Id;
625 -- Common processing for the pragmas Import/Export_Object. The three
626 -- arguments correspond to the three named parameters of the pragmas. An
627 -- argument is empty if the corresponding parameter is not present in
630 procedure Process_Extended_Import_Export_Internal_Arg
631 (Arg_Internal : Node_Id := Empty);
632 -- Common processing for all extended Import and Export pragmas. The
633 -- argument is the pragma parameter for the Internal argument. If
634 -- Arg_Internal is empty or inappropriate, an error message is posted.
635 -- Otherwise, on normal return, the Entity_Field of Arg_Internal is
636 -- set to identify the referenced entity.
638 procedure Process_Extended_Import_Export_Subprogram_Pragma
639 (Arg_Internal : Node_Id;
640 Arg_External : Node_Id;
641 Arg_Parameter_Types : Node_Id;
642 Arg_Result_Type : Node_Id := Empty;
643 Arg_Mechanism : Node_Id;
644 Arg_Result_Mechanism : Node_Id := Empty;
645 Arg_First_Optional_Parameter : Node_Id := Empty);
646 -- Common processing for all extended Import and Export pragmas applying
647 -- to subprograms. The caller omits any arguments that do not apply to
648 -- the pragma in question (for example, Arg_Result_Type can be non-Empty
649 -- only in the Import_Function and Export_Function cases). The argument
650 -- names correspond to the allowed pragma association identifiers.
652 procedure Process_Generic_List;
653 -- Common processing for Share_Generic and Inline_Generic
655 procedure Process_Import_Or_Interface;
656 -- Common processing for Import of Interface
658 procedure Process_Inline (Active : Boolean);
659 -- Common processing for Inline and Inline_Always. The parameter
660 -- indicates if the inline pragma is active, i.e. if it should actually
661 -- cause inlining to occur.
663 procedure Process_Interface_Name
664 (Subprogram_Def : Entity_Id;
667 -- Given the last two arguments of pragma Import, pragma Export, or
668 -- pragma Interface_Name, performs validity checks and sets the
669 -- Interface_Name field of the given subprogram entity to the
670 -- appropriate external or link name, depending on the arguments given.
671 -- Ext_Arg is always present, but Link_Arg may be missing. Note that
672 -- Ext_Arg may represent the Link_Name if Link_Arg is missing, and
673 -- appropriate named notation is used for Ext_Arg. If neither Ext_Arg
674 -- nor Link_Arg is present, the interface name is set to the default
675 -- from the subprogram name.
677 procedure Process_Interrupt_Or_Attach_Handler;
678 -- Common processing for Interrupt and Attach_Handler pragmas
680 procedure Process_Restrictions_Or_Restriction_Warnings (Warn : Boolean);
681 -- Common processing for Restrictions and Restriction_Warnings pragmas.
682 -- Warn is True for Restriction_Warnings, or for Restrictions if the
683 -- flag Treat_Restrictions_As_Warnings is set, and False if this flag
684 -- is not set in the Restrictions case.
686 procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean);
687 -- Common processing for Suppress and Unsuppress. The boolean parameter
688 -- Suppress_Case is True for the Suppress case, and False for the
691 procedure Set_Exported (E : Entity_Id; Arg : Node_Id);
692 -- This procedure sets the Is_Exported flag for the given entity,
693 -- checking that the entity was not previously imported. Arg is
694 -- the argument that specified the entity. A check is also made
695 -- for exporting inappropriate entities.
697 procedure Set_Extended_Import_Export_External_Name
698 (Internal_Ent : Entity_Id;
699 Arg_External : Node_Id);
700 -- Common processing for all extended import export pragmas. The first
701 -- argument, Internal_Ent, is the internal entity, which has already
702 -- been checked for validity by the caller. Arg_External is from the
703 -- Import or Export pragma, and may be null if no External parameter
704 -- was present. If Arg_External is present and is a non-null string
705 -- (a null string is treated as the default), then the Interface_Name
706 -- field of Internal_Ent is set appropriately.
708 procedure Set_Imported (E : Entity_Id);
709 -- This procedure sets the Is_Imported flag for the given entity,
710 -- checking that it is not previously exported or imported.
712 procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id);
713 -- Mech is a parameter passing mechanism (see Import_Function syntax
714 -- for MECHANISM_NAME). This routine checks that the mechanism argument
715 -- has the right form, and if not issues an error message. If the
716 -- argument has the right form then the Mechanism field of Ent is
717 -- set appropriately.
719 procedure Set_Ravenscar_Profile (N : Node_Id);
720 -- Activate the set of configuration pragmas and restrictions that make
721 -- up the Ravenscar Profile. N is the corresponding pragma node, which
722 -- is used for error messages on any constructs that violate the
725 ---------------------
726 -- Ada_2005_Pragma --
727 ---------------------
729 procedure Ada_2005_Pragma is
731 if Ada_Version <= Ada_95 then
732 Check_Restriction (No_Implementation_Pragmas, N);
736 --------------------------
737 -- Check_Ada_83_Warning --
738 --------------------------
740 procedure Check_Ada_83_Warning is
742 if Ada_Version = Ada_83 and then Comes_From_Source (N) then
743 Error_Msg_N ("(Ada 83) pragma& is non-standard?", N);
745 end Check_Ada_83_Warning;
747 ---------------------
748 -- Check_Arg_Count --
749 ---------------------
751 procedure Check_Arg_Count (Required : Nat) is
753 if Arg_Count /= Required then
754 Error_Pragma ("wrong number of arguments for pragma%");
758 --------------------------------
759 -- Check_Arg_Is_External_Name --
760 --------------------------------
762 procedure Check_Arg_Is_External_Name (Arg : Node_Id) is
763 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
766 if Nkind (Argx) = N_Identifier then
770 Analyze_And_Resolve (Argx, Standard_String);
772 if Is_OK_Static_Expression (Argx) then
775 elsif Etype (Argx) = Any_Type then
778 -- An interesting special case, if we have a string literal and
779 -- we are in Ada 83 mode, then we allow it even though it will
780 -- not be flagged as static. This allows expected Ada 83 mode
781 -- use of external names which are string literals, even though
782 -- technically these are not static in Ada 83.
784 elsif Ada_Version = Ada_83
785 and then Nkind (Argx) = N_String_Literal
789 -- Static expression that raises Constraint_Error. This has
790 -- already been flagged, so just exit from pragma processing.
792 elsif Is_Static_Expression (Argx) then
795 -- Here we have a real error (non-static expression)
798 Error_Msg_Name_1 := Pname;
800 ("argument for pragma% must be a identifier or " &
801 "static string expression!", Argx);
805 end Check_Arg_Is_External_Name;
807 -----------------------------
808 -- Check_Arg_Is_Identifier --
809 -----------------------------
811 procedure Check_Arg_Is_Identifier (Arg : Node_Id) is
812 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
814 if Nkind (Argx) /= N_Identifier then
816 ("argument for pragma% must be identifier", Argx);
818 end Check_Arg_Is_Identifier;
820 ----------------------------------
821 -- Check_Arg_Is_Integer_Literal --
822 ----------------------------------
824 procedure Check_Arg_Is_Integer_Literal (Arg : Node_Id) is
825 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
827 if Nkind (Argx) /= N_Integer_Literal then
829 ("argument for pragma% must be integer literal", Argx);
831 end Check_Arg_Is_Integer_Literal;
833 -------------------------------------------
834 -- Check_Arg_Is_Library_Level_Local_Name --
835 -------------------------------------------
839 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
840 -- | library_unit_NAME
842 procedure Check_Arg_Is_Library_Level_Local_Name (Arg : Node_Id) is
844 Check_Arg_Is_Local_Name (Arg);
846 if not Is_Library_Level_Entity (Entity (Expression (Arg)))
847 and then Comes_From_Source (N)
850 ("argument for pragma% must be library level entity", Arg);
852 end Check_Arg_Is_Library_Level_Local_Name;
854 -----------------------------
855 -- Check_Arg_Is_Local_Name --
856 -----------------------------
860 -- | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
861 -- | library_unit_NAME
863 procedure Check_Arg_Is_Local_Name (Arg : Node_Id) is
864 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
869 if Nkind (Argx) not in N_Direct_Name
870 and then (Nkind (Argx) /= N_Attribute_Reference
871 or else Present (Expressions (Argx))
872 or else Nkind (Prefix (Argx)) /= N_Identifier)
873 and then (not Is_Entity_Name (Argx)
874 or else not Is_Compilation_Unit (Entity (Argx)))
876 Error_Pragma_Arg ("argument for pragma% must be local name", Argx);
879 if Is_Entity_Name (Argx)
880 and then Scope (Entity (Argx)) /= Current_Scope
883 ("pragma% argument must be in same declarative part", Arg);
885 end Check_Arg_Is_Local_Name;
887 ---------------------------------
888 -- Check_Arg_Is_Locking_Policy --
889 ---------------------------------
891 procedure Check_Arg_Is_Locking_Policy (Arg : Node_Id) is
892 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
895 Check_Arg_Is_Identifier (Argx);
897 if not Is_Locking_Policy_Name (Chars (Argx)) then
899 ("& is not a valid locking policy name", Argx);
901 end Check_Arg_Is_Locking_Policy;
903 -------------------------
904 -- Check_Arg_Is_One_Of --
905 -------------------------
907 procedure Check_Arg_Is_One_Of (Arg : Node_Id; N1, N2 : Name_Id) is
908 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
911 Check_Arg_Is_Identifier (Argx);
913 if Chars (Argx) /= N1 and then Chars (Argx) /= N2 then
914 Error_Msg_Name_2 := N1;
915 Error_Msg_Name_3 := N2;
916 Error_Pragma_Arg ("argument for pragma% must be% or%", Argx);
918 end Check_Arg_Is_One_Of;
920 procedure Check_Arg_Is_One_Of
922 N1, N2, N3 : Name_Id)
924 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
927 Check_Arg_Is_Identifier (Argx);
929 if Chars (Argx) /= N1
930 and then Chars (Argx) /= N2
931 and then Chars (Argx) /= N3
933 Error_Pragma_Arg ("invalid argument for pragma%", Argx);
935 end Check_Arg_Is_One_Of;
937 procedure Check_Arg_Is_One_Of
939 N1, N2, N3, N4 : Name_Id)
941 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
944 Check_Arg_Is_Identifier (Argx);
946 if Chars (Argx) /= N1
947 and then Chars (Argx) /= N2
948 and then Chars (Argx) /= N3
949 and then Chars (Argx) /= N4
951 Error_Pragma_Arg ("invalid argument for pragma%", Argx);
953 end Check_Arg_Is_One_Of;
955 ---------------------------------
956 -- Check_Arg_Is_Queuing_Policy --
957 ---------------------------------
959 procedure Check_Arg_Is_Queuing_Policy (Arg : Node_Id) is
960 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
963 Check_Arg_Is_Identifier (Argx);
965 if not Is_Queuing_Policy_Name (Chars (Argx)) then
967 ("& is not a valid queuing policy name", Argx);
969 end Check_Arg_Is_Queuing_Policy;
971 ------------------------------------
972 -- Check_Arg_Is_Static_Expression --
973 ------------------------------------
975 procedure Check_Arg_Is_Static_Expression
977 Typ : Entity_Id := Empty)
979 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
982 if Present (Typ) then
983 Analyze_And_Resolve (Argx, Typ);
985 Analyze_And_Resolve (Argx);
988 if Is_OK_Static_Expression (Argx) then
991 elsif Etype (Argx) = Any_Type then
994 -- An interesting special case, if we have a string literal and we
995 -- are in Ada 83 mode, then we allow it even though it will not be
996 -- flagged as static. This allows the use of Ada 95 pragmas like
997 -- Import in Ada 83 mode. They will of course be flagged with
998 -- warnings as usual, but will not cause errors.
1000 elsif Ada_Version = Ada_83
1001 and then Nkind (Argx) = N_String_Literal
1005 -- Static expression that raises Constraint_Error. This has already
1006 -- been flagged, so just exit from pragma processing.
1008 elsif Is_Static_Expression (Argx) then
1011 -- Finally, we have a real error
1014 Error_Msg_Name_1 := Pname;
1015 Flag_Non_Static_Expr
1016 ("argument for pragma% must be a static expression!", Argx);
1019 end Check_Arg_Is_Static_Expression;
1021 ------------------------------------------
1022 -- Check_Arg_Is_Task_Dispatching_Policy --
1023 ------------------------------------------
1025 procedure Check_Arg_Is_Task_Dispatching_Policy (Arg : Node_Id) is
1026 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1029 Check_Arg_Is_Identifier (Argx);
1031 if not Is_Task_Dispatching_Policy_Name (Chars (Argx)) then
1033 ("& is not a valid task dispatching policy name", Argx);
1035 end Check_Arg_Is_Task_Dispatching_Policy;
1037 ---------------------
1038 -- Check_Arg_Order --
1039 ---------------------
1041 procedure Check_Arg_Order (Names : Name_List) is
1044 Highest_So_Far : Natural := 0;
1045 -- Highest index in Names seen do far
1049 for J in 1 .. Arg_Count loop
1050 if Chars (Arg) /= No_Name then
1051 for K in Names'Range loop
1052 if Chars (Arg) = Names (K) then
1053 if K < Highest_So_Far then
1054 Error_Msg_Name_1 := Pname;
1056 ("parameters out of order for pragma%", Arg);
1057 Error_Msg_Name_1 := Names (K);
1058 Error_Msg_Name_2 := Names (Highest_So_Far);
1059 Error_Msg_N ("\% must appear before %", Arg);
1063 Highest_So_Far := K;
1071 end Check_Arg_Order;
1073 --------------------------------
1074 -- Check_At_Least_N_Arguments --
1075 --------------------------------
1077 procedure Check_At_Least_N_Arguments (N : Nat) is
1079 if Arg_Count < N then
1080 Error_Pragma ("too few arguments for pragma%");
1082 end Check_At_Least_N_Arguments;
1084 -------------------------------
1085 -- Check_At_Most_N_Arguments --
1086 -------------------------------
1088 procedure Check_At_Most_N_Arguments (N : Nat) is
1091 if Arg_Count > N then
1093 for J in 1 .. N loop
1095 Error_Pragma_Arg ("too many arguments for pragma%", Arg);
1098 end Check_At_Most_N_Arguments;
1100 ---------------------
1101 -- Check_Component --
1102 ---------------------
1104 procedure Check_Component
1107 In_Variant_Part : Boolean := False)
1109 Comp_Id : constant Entity_Id := Defining_Identifier (Comp);
1110 Sindic : constant Node_Id :=
1111 Subtype_Indication (Component_Definition (Comp));
1112 Typ : constant Entity_Id := Etype (Comp_Id);
1114 function Inside_Generic_Body (Id : Entity_Id) return Boolean;
1115 -- Determine whether entity Id appears inside a generic body
1117 -------------------------
1118 -- Inside_Generic_Body --
1119 -------------------------
1121 function Inside_Generic_Body (Id : Entity_Id) return Boolean is
1122 S : Entity_Id := Id;
1126 and then S /= Standard_Standard
1128 if Ekind (S) = E_Generic_Package
1129 and then In_Package_Body (S)
1138 end Inside_Generic_Body;
1140 -- Start of processing for Check_Component
1143 -- Ada 2005 (AI-216): If a component subtype is subject to a per-
1144 -- object constraint, then the component type shall be an Unchecked_
1147 if Nkind (Sindic) = N_Subtype_Indication
1148 and then Has_Per_Object_Constraint (Comp_Id)
1149 and then not Is_Unchecked_Union (Etype (Subtype_Mark (Sindic)))
1152 ("component subtype subject to per-object constraint " &
1153 "must be an Unchecked_Union", Comp);
1155 -- Ada 2012 (AI05-0026): For an unchecked union type declared within
1156 -- the body of a generic unit, or within the body of any of its
1157 -- descendant library units, no part of the type of a component
1158 -- declared in a variant_part of the unchecked union type shall be of
1159 -- a formal private type or formal private extension declared within
1160 -- the formal part of the generic unit.
1162 elsif Ada_Version >= Ada_2012
1163 and then Inside_Generic_Body (UU_Typ)
1164 and then In_Variant_Part
1165 and then Is_Private_Type (Typ)
1166 and then Is_Generic_Type (Typ)
1169 ("component of Unchecked_Union cannot be of generic type", Comp);
1171 elsif Needs_Finalization (Typ) then
1173 ("component of Unchecked_Union cannot be controlled", Comp);
1175 elsif Has_Task (Typ) then
1177 ("component of Unchecked_Union cannot have tasks", Comp);
1179 end Check_Component;
1181 ----------------------------------
1182 -- Check_Duplicated_Export_Name --
1183 ----------------------------------
1185 procedure Check_Duplicated_Export_Name (Nam : Node_Id) is
1186 String_Val : constant String_Id := Strval (Nam);
1189 -- We are only interested in the export case, and in the case of
1190 -- generics, it is the instance, not the template, that is the
1191 -- problem (the template will generate a warning in any case).
1193 if not Inside_A_Generic
1194 and then (Prag_Id = Pragma_Export
1196 Prag_Id = Pragma_Export_Procedure
1198 Prag_Id = Pragma_Export_Valued_Procedure
1200 Prag_Id = Pragma_Export_Function)
1202 for J in Externals.First .. Externals.Last loop
1203 if String_Equal (String_Val, Strval (Externals.Table (J))) then
1204 Error_Msg_Sloc := Sloc (Externals.Table (J));
1205 Error_Msg_N ("external name duplicates name given#", Nam);
1210 Externals.Append (Nam);
1212 end Check_Duplicated_Export_Name;
1214 -------------------------
1215 -- Check_First_Subtype --
1216 -------------------------
1218 procedure Check_First_Subtype (Arg : Node_Id) is
1219 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
1221 if not Is_First_Subtype (Entity (Argx)) then
1223 ("pragma% cannot apply to subtype", Argx);
1225 end Check_First_Subtype;
1227 ---------------------------
1228 -- Check_In_Main_Program --
1229 ---------------------------
1231 procedure Check_In_Main_Program is
1232 P : constant Node_Id := Parent (N);
1235 -- Must be at in subprogram body
1237 if Nkind (P) /= N_Subprogram_Body then
1238 Error_Pragma ("% pragma allowed only in subprogram");
1240 -- Otherwise warn if obviously not main program
1242 elsif Present (Parameter_Specifications (Specification (P)))
1243 or else not Is_Compilation_Unit (Defining_Entity (P))
1245 Error_Msg_Name_1 := Pname;
1247 ("?pragma% is only effective in main program", N);
1249 end Check_In_Main_Program;
1251 ---------------------------------------
1252 -- Check_Interrupt_Or_Attach_Handler --
1253 ---------------------------------------
1255 procedure Check_Interrupt_Or_Attach_Handler is
1256 Arg1_X : constant Node_Id := Expression (Arg1);
1257 Handler_Proc, Proc_Scope : Entity_Id;
1262 if Prag_Id = Pragma_Interrupt_Handler then
1263 Check_Restriction (No_Dynamic_Attachment, N);
1266 Handler_Proc := Find_Unique_Parameterless_Procedure (Arg1_X, Arg1);
1267 Proc_Scope := Scope (Handler_Proc);
1269 -- On AAMP only, a pragma Interrupt_Handler is supported for
1270 -- nonprotected parameterless procedures.
1272 if not AAMP_On_Target
1273 or else Prag_Id = Pragma_Attach_Handler
1275 if Ekind (Proc_Scope) /= E_Protected_Type then
1277 ("argument of pragma% must be protected procedure", Arg1);
1280 if Parent (N) /= Protected_Definition (Parent (Proc_Scope)) then
1281 Error_Pragma ("pragma% must be in protected definition");
1285 if not Is_Library_Level_Entity (Proc_Scope)
1286 or else (AAMP_On_Target
1287 and then not Is_Library_Level_Entity (Handler_Proc))
1290 ("argument for pragma% must be library level entity", Arg1);
1292 end Check_Interrupt_Or_Attach_Handler;
1294 -------------------------------------------
1295 -- Check_Is_In_Decl_Part_Or_Package_Spec --
1296 -------------------------------------------
1298 procedure Check_Is_In_Decl_Part_Or_Package_Spec is
1307 elsif Nkind (P) = N_Handled_Sequence_Of_Statements then
1310 elsif Nkind_In (P, N_Package_Specification,
1315 -- Note: the following tests seem a little peculiar, because
1316 -- they test for bodies, but if we were in the statement part
1317 -- of the body, we would already have hit the handled statement
1318 -- sequence, so the only way we get here is by being in the
1319 -- declarative part of the body.
1321 elsif Nkind_In (P, N_Subprogram_Body,
1332 Error_Pragma ("pragma% is not in declarative part or package spec");
1333 end Check_Is_In_Decl_Part_Or_Package_Spec;
1335 -------------------------
1336 -- Check_No_Identifier --
1337 -------------------------
1339 procedure Check_No_Identifier (Arg : Node_Id) is
1341 if Chars (Arg) /= No_Name then
1342 Error_Pragma_Arg_Ident
1343 ("pragma% does not permit identifier& here", Arg);
1345 end Check_No_Identifier;
1347 --------------------------
1348 -- Check_No_Identifiers --
1349 --------------------------
1351 procedure Check_No_Identifiers is
1354 if Arg_Count > 0 then
1356 while Present (Arg_Node) loop
1357 Check_No_Identifier (Arg_Node);
1361 end Check_No_Identifiers;
1363 -------------------------------
1364 -- Check_Optional_Identifier --
1365 -------------------------------
1367 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id) is
1369 if Present (Arg) and then Chars (Arg) /= No_Name then
1370 if Chars (Arg) /= Id then
1371 Error_Msg_Name_1 := Pname;
1372 Error_Msg_Name_2 := Id;
1373 Error_Msg_N ("pragma% argument expects identifier%", Arg);
1377 end Check_Optional_Identifier;
1379 procedure Check_Optional_Identifier (Arg : Node_Id; Id : String) is
1381 Name_Buffer (1 .. Id'Length) := Id;
1382 Name_Len := Id'Length;
1383 Check_Optional_Identifier (Arg, Name_Find);
1384 end Check_Optional_Identifier;
1386 --------------------------------------
1387 -- Check_Precondition_Postcondition --
1388 --------------------------------------
1390 procedure Check_Precondition_Postcondition (In_Body : out Boolean) is
1394 procedure Chain_PPC (PO : Node_Id);
1395 -- If PO is a subprogram declaration node (or a generic subprogram
1396 -- declaration node), then the precondition/postcondition applies
1397 -- to this subprogram and the processing for the pragma is completed.
1398 -- Otherwise the pragma is misplaced.
1404 procedure Chain_PPC (PO : Node_Id) is
1408 if not Nkind_In (PO, N_Subprogram_Declaration,
1409 N_Generic_Subprogram_Declaration)
1414 -- Here if we have subprogram or generic subprogram declaration
1416 S := Defining_Unit_Name (Specification (PO));
1418 -- Analyze the pragma unless it appears within a package spec,
1419 -- which is the case where we delay the analysis of the PPC until
1420 -- the end of the package declarations (for details, see
1421 -- Analyze_Package_Specification.Analyze_PPCs).
1423 if not Is_Package_Or_Generic_Package (Scope (S)) then
1424 Analyze_PPC_In_Decl_Part (N, S);
1427 -- Chain spec PPC pragma to list for subprogram
1429 Set_Next_Pragma (N, Spec_PPC_List (S));
1430 Set_Spec_PPC_List (S, N);
1432 -- Return indicating spec case
1438 -- Start of processing for Check_Precondition_Postcondition
1441 if not Is_List_Member (N) then
1445 -- Record if pragma is enabled
1447 if Check_Enabled (Pname) then
1448 Set_Pragma_Enabled (N);
1449 Set_SCO_Pragma_Enabled (Loc);
1452 -- If we are within an inlined body, the legality of the pragma
1453 -- has been checked already.
1455 if In_Inlined_Body then
1460 -- Search prior declarations
1463 while Present (Prev (P)) loop
1466 -- If the previous node is a generic subprogram, do not go to to
1467 -- the original node, which is the unanalyzed tree: we need to
1468 -- attach the pre/postconditions to the analyzed version at this
1469 -- point. They get propagated to the original tree when analyzing
1470 -- the corresponding body.
1472 if Nkind (P) not in N_Generic_Declaration then
1473 PO := Original_Node (P);
1478 -- Skip past prior pragma
1480 if Nkind (PO) = N_Pragma then
1483 -- Skip stuff not coming from source
1485 elsif not Comes_From_Source (PO) then
1488 -- Only remaining possibility is subprogram declaration
1496 -- If we fall through loop, pragma is at start of list, so see if it
1497 -- is at the start of declarations of a subprogram body.
1499 if Nkind (Parent (N)) = N_Subprogram_Body
1500 and then List_Containing (N) = Declarations (Parent (N))
1502 if Operating_Mode /= Generate_Code
1503 or else Inside_A_Generic
1506 -- Analyze expression in pragma, for correctness
1507 -- and for ASIS use.
1509 Preanalyze_Spec_Expression
1510 (Get_Pragma_Arg (Arg1), Standard_Boolean);
1516 -- See if it is in the pragmas after a library level subprogram
1518 elsif Nkind (Parent (N)) = N_Compilation_Unit_Aux then
1519 Chain_PPC (Unit (Parent (Parent (N))));
1523 -- If we fall through, pragma was misplaced
1526 end Check_Precondition_Postcondition;
1528 -----------------------------
1529 -- Check_Static_Constraint --
1530 -----------------------------
1532 -- Note: for convenience in writing this procedure, in addition to
1533 -- the officially (i.e. by spec) allowed argument which is always a
1534 -- constraint, it also allows ranges and discriminant associations.
1535 -- Above is not clear ???
1537 procedure Check_Static_Constraint (Constr : Node_Id) is
1539 procedure Require_Static (E : Node_Id);
1540 -- Require given expression to be static expression
1542 --------------------
1543 -- Require_Static --
1544 --------------------
1546 procedure Require_Static (E : Node_Id) is
1548 if not Is_OK_Static_Expression (E) then
1549 Flag_Non_Static_Expr
1550 ("non-static constraint not allowed in Unchecked_Union!", E);
1555 -- Start of processing for Check_Static_Constraint
1558 case Nkind (Constr) is
1559 when N_Discriminant_Association =>
1560 Require_Static (Expression (Constr));
1563 Require_Static (Low_Bound (Constr));
1564 Require_Static (High_Bound (Constr));
1566 when N_Attribute_Reference =>
1567 Require_Static (Type_Low_Bound (Etype (Prefix (Constr))));
1568 Require_Static (Type_High_Bound (Etype (Prefix (Constr))));
1570 when N_Range_Constraint =>
1571 Check_Static_Constraint (Range_Expression (Constr));
1573 when N_Index_Or_Discriminant_Constraint =>
1577 IDC := First (Constraints (Constr));
1578 while Present (IDC) loop
1579 Check_Static_Constraint (IDC);
1587 end Check_Static_Constraint;
1589 --------------------------------------
1590 -- Check_Valid_Configuration_Pragma --
1591 --------------------------------------
1593 -- A configuration pragma must appear in the context clause of a
1594 -- compilation unit, and only other pragmas may precede it. Note that
1595 -- the test also allows use in a configuration pragma file.
1597 procedure Check_Valid_Configuration_Pragma is
1599 if not Is_Configuration_Pragma then
1600 Error_Pragma ("incorrect placement for configuration pragma%");
1602 end Check_Valid_Configuration_Pragma;
1604 -------------------------------------
1605 -- Check_Valid_Library_Unit_Pragma --
1606 -------------------------------------
1608 procedure Check_Valid_Library_Unit_Pragma is
1610 Parent_Node : Node_Id;
1611 Unit_Name : Entity_Id;
1612 Unit_Kind : Node_Kind;
1613 Unit_Node : Node_Id;
1614 Sindex : Source_File_Index;
1617 if not Is_List_Member (N) then
1621 Plist := List_Containing (N);
1622 Parent_Node := Parent (Plist);
1624 if Parent_Node = Empty then
1627 -- Case of pragma appearing after a compilation unit. In this case
1628 -- it must have an argument with the corresponding name and must
1629 -- be part of the following pragmas of its parent.
1631 elsif Nkind (Parent_Node) = N_Compilation_Unit_Aux then
1632 if Plist /= Pragmas_After (Parent_Node) then
1635 elsif Arg_Count = 0 then
1637 ("argument required if outside compilation unit");
1640 Check_No_Identifiers;
1641 Check_Arg_Count (1);
1642 Unit_Node := Unit (Parent (Parent_Node));
1643 Unit_Kind := Nkind (Unit_Node);
1645 Analyze (Expression (Arg1));
1647 if Unit_Kind = N_Generic_Subprogram_Declaration
1648 or else Unit_Kind = N_Subprogram_Declaration
1650 Unit_Name := Defining_Entity (Unit_Node);
1652 elsif Unit_Kind in N_Generic_Instantiation then
1653 Unit_Name := Defining_Entity (Unit_Node);
1656 Unit_Name := Cunit_Entity (Current_Sem_Unit);
1659 if Chars (Unit_Name) /=
1660 Chars (Entity (Expression (Arg1)))
1663 ("pragma% argument is not current unit name", Arg1);
1666 if Ekind (Unit_Name) = E_Package
1667 and then Present (Renamed_Entity (Unit_Name))
1669 Error_Pragma ("pragma% not allowed for renamed package");
1673 -- Pragma appears other than after a compilation unit
1676 -- Here we check for the generic instantiation case and also
1677 -- for the case of processing a generic formal package. We
1678 -- detect these cases by noting that the Sloc on the node
1679 -- does not belong to the current compilation unit.
1681 Sindex := Source_Index (Current_Sem_Unit);
1683 if Loc not in Source_First (Sindex) .. Source_Last (Sindex) then
1684 Rewrite (N, Make_Null_Statement (Loc));
1687 -- If before first declaration, the pragma applies to the
1688 -- enclosing unit, and the name if present must be this name.
1690 elsif Is_Before_First_Decl (N, Plist) then
1691 Unit_Node := Unit_Declaration_Node (Current_Scope);
1692 Unit_Kind := Nkind (Unit_Node);
1694 if Nkind (Parent (Unit_Node)) /= N_Compilation_Unit then
1697 elsif Unit_Kind = N_Subprogram_Body
1698 and then not Acts_As_Spec (Unit_Node)
1702 elsif Nkind (Parent_Node) = N_Package_Body then
1705 elsif Nkind (Parent_Node) = N_Package_Specification
1706 and then Plist = Private_Declarations (Parent_Node)
1710 elsif (Nkind (Parent_Node) = N_Generic_Package_Declaration
1711 or else Nkind (Parent_Node) =
1712 N_Generic_Subprogram_Declaration)
1713 and then Plist = Generic_Formal_Declarations (Parent_Node)
1717 elsif Arg_Count > 0 then
1718 Analyze (Expression (Arg1));
1720 if Entity (Expression (Arg1)) /= Current_Scope then
1722 ("name in pragma% must be enclosing unit", Arg1);
1725 -- It is legal to have no argument in this context
1731 -- Error if not before first declaration. This is because a
1732 -- library unit pragma argument must be the name of a library
1733 -- unit (RM 10.1.5(7)), but the only names permitted in this
1734 -- context are (RM 10.1.5(6)) names of subprogram declarations,
1735 -- generic subprogram declarations or generic instantiations.
1739 ("pragma% misplaced, must be before first declaration");
1743 end Check_Valid_Library_Unit_Pragma;
1749 procedure Check_Variant (Variant : Node_Id; UU_Typ : Entity_Id) is
1750 Clist : constant Node_Id := Component_List (Variant);
1754 if not Is_Non_Empty_List (Component_Items (Clist)) then
1756 ("Unchecked_Union may not have empty component list",
1761 Comp := First (Component_Items (Clist));
1762 while Present (Comp) loop
1763 Check_Component (Comp, UU_Typ, In_Variant_Part => True);
1772 procedure Error_Pragma (Msg : String) is
1774 Error_Msg_Name_1 := Pname;
1775 Error_Msg_N (Msg, N);
1779 ----------------------
1780 -- Error_Pragma_Arg --
1781 ----------------------
1783 procedure Error_Pragma_Arg (Msg : String; Arg : Node_Id) is
1785 Error_Msg_Name_1 := Pname;
1786 Error_Msg_N (Msg, Get_Pragma_Arg (Arg));
1788 end Error_Pragma_Arg;
1790 procedure Error_Pragma_Arg (Msg1, Msg2 : String; Arg : Node_Id) is
1792 Error_Msg_Name_1 := Pname;
1793 Error_Msg_N (Msg1, Get_Pragma_Arg (Arg));
1794 Error_Pragma_Arg (Msg2, Arg);
1795 end Error_Pragma_Arg;
1797 ----------------------------
1798 -- Error_Pragma_Arg_Ident --
1799 ----------------------------
1801 procedure Error_Pragma_Arg_Ident (Msg : String; Arg : Node_Id) is
1803 Error_Msg_Name_1 := Pname;
1804 Error_Msg_N (Msg, Arg);
1806 end Error_Pragma_Arg_Ident;
1808 ----------------------
1809 -- Error_Pragma_Ref --
1810 ----------------------
1812 procedure Error_Pragma_Ref (Msg : String; Ref : Entity_Id) is
1814 Error_Msg_Name_1 := Pname;
1815 Error_Msg_Sloc := Sloc (Ref);
1816 Error_Msg_NE (Msg, N, Ref);
1818 end Error_Pragma_Ref;
1820 ------------------------
1821 -- Find_Lib_Unit_Name --
1822 ------------------------
1824 function Find_Lib_Unit_Name return Entity_Id is
1826 -- Return inner compilation unit entity, for case of nested
1827 -- categorization pragmas. This happens in generic unit.
1829 if Nkind (Parent (N)) = N_Package_Specification
1830 and then Defining_Entity (Parent (N)) /= Current_Scope
1832 return Defining_Entity (Parent (N));
1834 return Current_Scope;
1836 end Find_Lib_Unit_Name;
1838 ----------------------------
1839 -- Find_Program_Unit_Name --
1840 ----------------------------
1842 procedure Find_Program_Unit_Name (Id : Node_Id) is
1843 Unit_Name : Entity_Id;
1844 Unit_Kind : Node_Kind;
1845 P : constant Node_Id := Parent (N);
1848 if Nkind (P) = N_Compilation_Unit then
1849 Unit_Kind := Nkind (Unit (P));
1851 if Unit_Kind = N_Subprogram_Declaration
1852 or else Unit_Kind = N_Package_Declaration
1853 or else Unit_Kind in N_Generic_Declaration
1855 Unit_Name := Defining_Entity (Unit (P));
1857 if Chars (Id) = Chars (Unit_Name) then
1858 Set_Entity (Id, Unit_Name);
1859 Set_Etype (Id, Etype (Unit_Name));
1861 Set_Etype (Id, Any_Type);
1863 ("cannot find program unit referenced by pragma%");
1867 Set_Etype (Id, Any_Type);
1868 Error_Pragma ("pragma% inapplicable to this unit");
1874 end Find_Program_Unit_Name;
1876 -----------------------------------------
1877 -- Find_Unique_Parameterless_Procedure --
1878 -----------------------------------------
1880 function Find_Unique_Parameterless_Procedure
1882 Arg : Node_Id) return Entity_Id
1884 Proc : Entity_Id := Empty;
1887 -- The body of this procedure needs some comments ???
1889 if not Is_Entity_Name (Name) then
1891 ("argument of pragma% must be entity name", Arg);
1893 elsif not Is_Overloaded (Name) then
1894 Proc := Entity (Name);
1896 if Ekind (Proc) /= E_Procedure
1897 or else Present (First_Formal (Proc))
1900 ("argument of pragma% must be parameterless procedure", Arg);
1905 Found : Boolean := False;
1907 Index : Interp_Index;
1910 Get_First_Interp (Name, Index, It);
1911 while Present (It.Nam) loop
1914 if Ekind (Proc) = E_Procedure
1915 and then No (First_Formal (Proc))
1919 Set_Entity (Name, Proc);
1920 Set_Is_Overloaded (Name, False);
1923 ("ambiguous handler name for pragma% ", Arg);
1927 Get_Next_Interp (Index, It);
1932 ("argument of pragma% must be parameterless procedure",
1935 Proc := Entity (Name);
1941 end Find_Unique_Parameterless_Procedure;
1943 -------------------------
1944 -- Gather_Associations --
1945 -------------------------
1947 procedure Gather_Associations
1949 Args : out Args_List)
1954 -- Initialize all parameters to Empty
1956 for J in Args'Range loop
1960 -- That's all we have to do if there are no argument associations
1962 if No (Pragma_Argument_Associations (N)) then
1966 -- Otherwise first deal with any positional parameters present
1968 Arg := First (Pragma_Argument_Associations (N));
1969 for Index in Args'Range loop
1970 exit when No (Arg) or else Chars (Arg) /= No_Name;
1971 Args (Index) := Expression (Arg);
1975 -- Positional parameters all processed, if any left, then we
1976 -- have too many positional parameters.
1978 if Present (Arg) and then Chars (Arg) = No_Name then
1980 ("too many positional associations for pragma%", Arg);
1983 -- Process named parameters if any are present
1985 while Present (Arg) loop
1986 if Chars (Arg) = No_Name then
1988 ("positional association cannot follow named association",
1992 for Index in Names'Range loop
1993 if Names (Index) = Chars (Arg) then
1994 if Present (Args (Index)) then
1996 ("duplicate argument association for pragma%", Arg);
1998 Args (Index) := Expression (Arg);
2003 if Index = Names'Last then
2004 Error_Msg_Name_1 := Pname;
2005 Error_Msg_N ("pragma% does not allow & argument", Arg);
2007 -- Check for possible misspelling
2009 for Index1 in Names'Range loop
2010 if Is_Bad_Spelling_Of
2011 (Chars (Arg), Names (Index1))
2013 Error_Msg_Name_1 := Names (Index1);
2014 Error_Msg_N -- CODEFIX
2015 ("\possible misspelling of%", Arg);
2027 end Gather_Associations;
2033 procedure GNAT_Pragma is
2035 Check_Restriction (No_Implementation_Pragmas, N);
2038 --------------------------
2039 -- Is_Before_First_Decl --
2040 --------------------------
2042 function Is_Before_First_Decl
2043 (Pragma_Node : Node_Id;
2044 Decls : List_Id) return Boolean
2046 Item : Node_Id := First (Decls);
2049 -- Only other pragmas can come before this pragma
2052 if No (Item) or else Nkind (Item) /= N_Pragma then
2055 elsif Item = Pragma_Node then
2061 end Is_Before_First_Decl;
2063 -----------------------------
2064 -- Is_Configuration_Pragma --
2065 -----------------------------
2067 -- A configuration pragma must appear in the context clause of a
2068 -- compilation unit, and only other pragmas may precede it. Note that
2069 -- the test below also permits use in a configuration pragma file.
2071 function Is_Configuration_Pragma return Boolean is
2072 Lis : constant List_Id := List_Containing (N);
2073 Par : constant Node_Id := Parent (N);
2077 -- If no parent, then we are in the configuration pragma file,
2078 -- so the placement is definitely appropriate.
2083 -- Otherwise we must be in the context clause of a compilation unit
2084 -- and the only thing allowed before us in the context list is more
2085 -- configuration pragmas.
2087 elsif Nkind (Par) = N_Compilation_Unit
2088 and then Context_Items (Par) = Lis
2095 elsif Nkind (Prg) /= N_Pragma then
2105 end Is_Configuration_Pragma;
2107 --------------------------
2108 -- Is_In_Context_Clause --
2109 --------------------------
2111 function Is_In_Context_Clause return Boolean is
2113 Parent_Node : Node_Id;
2116 if not Is_List_Member (N) then
2120 Plist := List_Containing (N);
2121 Parent_Node := Parent (Plist);
2123 if Parent_Node = Empty
2124 or else Nkind (Parent_Node) /= N_Compilation_Unit
2125 or else Context_Items (Parent_Node) /= Plist
2132 end Is_In_Context_Clause;
2134 ---------------------------------
2135 -- Is_Static_String_Expression --
2136 ---------------------------------
2138 function Is_Static_String_Expression (Arg : Node_Id) return Boolean is
2139 Argx : constant Node_Id := Get_Pragma_Arg (Arg);
2142 Analyze_And_Resolve (Argx);
2143 return Is_OK_Static_Expression (Argx)
2144 and then Nkind (Argx) = N_String_Literal;
2145 end Is_Static_String_Expression;
2147 ----------------------
2148 -- Pragma_Misplaced --
2149 ----------------------
2151 procedure Pragma_Misplaced is
2153 Error_Pragma ("incorrect placement of pragma%");
2154 end Pragma_Misplaced;
2156 ------------------------------------
2157 -- Process Atomic_Shared_Volatile --
2158 ------------------------------------
2160 procedure Process_Atomic_Shared_Volatile is
2167 procedure Set_Atomic (E : Entity_Id);
2168 -- Set given type as atomic, and if no explicit alignment was given,
2169 -- set alignment to unknown, since back end knows what the alignment
2170 -- requirements are for atomic arrays. Note: this step is necessary
2171 -- for derived types.
2177 procedure Set_Atomic (E : Entity_Id) is
2181 if not Has_Alignment_Clause (E) then
2182 Set_Alignment (E, Uint_0);
2186 -- Start of processing for Process_Atomic_Shared_Volatile
2189 Check_Ada_83_Warning;
2190 Check_No_Identifiers;
2191 Check_Arg_Count (1);
2192 Check_Arg_Is_Local_Name (Arg1);
2193 E_Id := Expression (Arg1);
2195 if Etype (E_Id) = Any_Type then
2200 D := Declaration_Node (E);
2204 if Rep_Item_Too_Early (E, N)
2206 Rep_Item_Too_Late (E, N)
2210 Check_First_Subtype (Arg1);
2213 if Prag_Id /= Pragma_Volatile then
2215 Set_Atomic (Underlying_Type (E));
2216 Set_Atomic (Base_Type (E));
2219 -- Attribute belongs on the base type. If the view of the type is
2220 -- currently private, it also belongs on the underlying type.
2222 Set_Is_Volatile (Base_Type (E));
2223 Set_Is_Volatile (Underlying_Type (E));
2225 Set_Treat_As_Volatile (E);
2226 Set_Treat_As_Volatile (Underlying_Type (E));
2228 elsif K = N_Object_Declaration
2229 or else (K = N_Component_Declaration
2230 and then Original_Record_Component (E) = E)
2232 if Rep_Item_Too_Late (E, N) then
2236 if Prag_Id /= Pragma_Volatile then
2239 -- If the object declaration has an explicit initialization, a
2240 -- temporary may have to be created to hold the expression, to
2241 -- ensure that access to the object remain atomic.
2243 if Nkind (Parent (E)) = N_Object_Declaration
2244 and then Present (Expression (Parent (E)))
2246 Set_Has_Delayed_Freeze (E);
2249 -- An interesting improvement here. If an object of type X is
2250 -- declared atomic, and the type X is not atomic, that's a
2251 -- pity, since it may not have appropriate alignment etc. We
2252 -- can rescue this in the special case where the object and
2253 -- type are in the same unit by just setting the type as
2254 -- atomic, so that the back end will process it as atomic.
2256 Utyp := Underlying_Type (Etype (E));
2259 and then Sloc (E) > No_Location
2260 and then Sloc (Utyp) > No_Location
2262 Get_Source_File_Index (Sloc (E)) =
2263 Get_Source_File_Index (Sloc (Underlying_Type (Etype (E))))
2265 Set_Is_Atomic (Underlying_Type (Etype (E)));
2269 Set_Is_Volatile (E);
2270 Set_Treat_As_Volatile (E);
2274 ("inappropriate entity for pragma%", Arg1);
2276 end Process_Atomic_Shared_Volatile;
2278 -------------------------------------------
2279 -- Process_Compile_Time_Warning_Or_Error --
2280 -------------------------------------------
2282 procedure Process_Compile_Time_Warning_Or_Error is
2283 Arg1x : constant Node_Id := Get_Pragma_Arg (Arg1);
2286 Check_Arg_Count (2);
2287 Check_No_Identifiers;
2288 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
2289 Analyze_And_Resolve (Arg1x, Standard_Boolean);
2291 if Compile_Time_Known_Value (Arg1x) then
2292 if Is_True (Expr_Value (Get_Pragma_Arg (Arg1))) then
2294 Str : constant String_Id :=
2295 Strval (Get_Pragma_Arg (Arg2));
2296 Len : constant Int := String_Length (Str);
2301 Cent : constant Entity_Id :=
2302 Cunit_Entity (Current_Sem_Unit);
2304 Force : constant Boolean :=
2305 Prag_Id = Pragma_Compile_Time_Warning
2307 Is_Spec_Name (Unit_Name (Current_Sem_Unit))
2308 and then (Ekind (Cent) /= E_Package
2309 or else not In_Private_Part (Cent));
2310 -- Set True if this is the warning case, and we are in the
2311 -- visible part of a package spec, or in a subprogram spec,
2312 -- in which case we want to force the client to see the
2313 -- warning, even though it is not in the main unit.
2316 -- Loop through segments of message separated by line feeds.
2317 -- We output these segments as separate messages with
2318 -- continuation marks for all but the first.
2323 Error_Msg_Strlen := 0;
2325 -- Loop to copy characters from argument to error message
2329 exit when Ptr > Len;
2330 CC := Get_String_Char (Str, Ptr);
2333 -- Ignore wide chars ??? else store character
2335 if In_Character_Range (CC) then
2336 C := Get_Character (CC);
2337 exit when C = ASCII.LF;
2338 Error_Msg_Strlen := Error_Msg_Strlen + 1;
2339 Error_Msg_String (Error_Msg_Strlen) := C;
2343 -- Here with one line ready to go
2345 Error_Msg_Warn := Prag_Id = Pragma_Compile_Time_Warning;
2347 -- If this is a warning in a spec, then we want clients
2348 -- to see the warning, so mark the message with the
2349 -- special sequence !! to force the warning. In the case
2350 -- of a package spec, we do not force this if we are in
2351 -- the private part of the spec.
2354 if Cont = False then
2355 Error_Msg_N ("<~!!", Arg1);
2358 Error_Msg_N ("\<~!!", Arg1);
2361 -- Error, rather than warning, or in a body, so we do not
2362 -- need to force visibility for client (error will be
2363 -- output in any case, and this is the situation in which
2364 -- we do not want a client to get a warning, since the
2365 -- warning is in the body or the spec private part.
2368 if Cont = False then
2369 Error_Msg_N ("<~", Arg1);
2372 Error_Msg_N ("\<~", Arg1);
2376 exit when Ptr > Len;
2381 end Process_Compile_Time_Warning_Or_Error;
2383 ------------------------
2384 -- Process_Convention --
2385 ------------------------
2387 procedure Process_Convention
2388 (C : out Convention_Id;
2389 Ent : out Entity_Id)
2395 Comp_Unit : Unit_Number_Type;
2397 procedure Diagnose_Multiple_Pragmas (S : Entity_Id);
2398 -- Called if we have more than one Export/Import/Convention pragma.
2399 -- This is generally illegal, but we have a special case of allowing
2400 -- Import and Interface to coexist if they specify the convention in
2401 -- a consistent manner. We are allowed to do this, since Interface is
2402 -- an implementation defined pragma, and we choose to do it since we
2403 -- know Rational allows this combination. S is the entity id of the
2404 -- subprogram in question. This procedure also sets the special flag
2405 -- Import_Interface_Present in both pragmas in the case where we do
2406 -- have matching Import and Interface pragmas.
2408 procedure Set_Convention_From_Pragma (E : Entity_Id);
2409 -- Set convention in entity E, and also flag that the entity has a
2410 -- convention pragma. If entity is for a private or incomplete type,
2411 -- also set convention and flag on underlying type. This procedure
2412 -- also deals with the special case of C_Pass_By_Copy convention.
2414 -------------------------------
2415 -- Diagnose_Multiple_Pragmas --
2416 -------------------------------
2418 procedure Diagnose_Multiple_Pragmas (S : Entity_Id) is
2419 Pdec : constant Node_Id := Declaration_Node (S);
2423 function Same_Convention (Decl : Node_Id) return Boolean;
2424 -- Decl is a pragma node. This function returns True if this
2425 -- pragma has a first argument that is an identifier with a
2426 -- Chars field corresponding to the Convention_Id C.
2428 function Same_Name (Decl : Node_Id) return Boolean;
2429 -- Decl is a pragma node. This function returns True if this
2430 -- pragma has a second argument that is an identifier with a
2431 -- Chars field that matches the Chars of the current subprogram.
2433 ---------------------
2434 -- Same_Convention --
2435 ---------------------
2437 function Same_Convention (Decl : Node_Id) return Boolean is
2438 Arg1 : constant Node_Id :=
2439 First (Pragma_Argument_Associations (Decl));
2442 if Present (Arg1) then
2444 Arg : constant Node_Id := Get_Pragma_Arg (Arg1);
2446 if Nkind (Arg) = N_Identifier
2447 and then Is_Convention_Name (Chars (Arg))
2448 and then Get_Convention_Id (Chars (Arg)) = C
2456 end Same_Convention;
2462 function Same_Name (Decl : Node_Id) return Boolean is
2463 Arg1 : constant Node_Id :=
2464 First (Pragma_Argument_Associations (Decl));
2472 Arg2 := Next (Arg1);
2479 Arg : constant Node_Id := Get_Pragma_Arg (Arg2);
2481 if Nkind (Arg) = N_Identifier
2482 and then Chars (Arg) = Chars (S)
2491 -- Start of processing for Diagnose_Multiple_Pragmas
2496 -- Definitely give message if we have Convention/Export here
2498 if Prag_Id = Pragma_Convention or else Prag_Id = Pragma_Export then
2501 -- If we have an Import or Export, scan back from pragma to
2502 -- find any previous pragma applying to the same procedure.
2503 -- The scan will be terminated by the start of the list, or
2504 -- hitting the subprogram declaration. This won't allow one
2505 -- pragma to appear in the public part and one in the private
2506 -- part, but that seems very unlikely in practice.
2510 while Present (Decl) and then Decl /= Pdec loop
2512 -- Look for pragma with same name as us
2514 if Nkind (Decl) = N_Pragma
2515 and then Same_Name (Decl)
2517 -- Give error if same as our pragma or Export/Convention
2519 if Pragma_Name (Decl) = Name_Export
2521 Pragma_Name (Decl) = Name_Convention
2523 Pragma_Name (Decl) = Pragma_Name (N)
2527 -- Case of Import/Interface or the other way round
2529 elsif Pragma_Name (Decl) = Name_Interface
2531 Pragma_Name (Decl) = Name_Import
2533 -- Here we know that we have Import and Interface. It
2534 -- doesn't matter which way round they are. See if
2535 -- they specify the same convention. If so, all OK,
2536 -- and set special flags to stop other messages
2538 if Same_Convention (Decl) then
2539 Set_Import_Interface_Present (N);
2540 Set_Import_Interface_Present (Decl);
2543 -- If different conventions, special message
2546 Error_Msg_Sloc := Sloc (Decl);
2548 ("convention differs from that given#", Arg1);
2558 -- Give message if needed if we fall through those tests
2562 ("at most one Convention/Export/Import pragma is allowed",
2565 end Diagnose_Multiple_Pragmas;
2567 --------------------------------
2568 -- Set_Convention_From_Pragma --
2569 --------------------------------
2571 procedure Set_Convention_From_Pragma (E : Entity_Id) is
2573 -- Ada 2005 (AI-430): Check invalid attempt to change convention
2574 -- for an overridden dispatching operation. Technically this is
2575 -- an amendment and should only be done in Ada 2005 mode. However,
2576 -- this is clearly a mistake, since the problem that is addressed
2577 -- by this AI is that there is a clear gap in the RM!
2579 if Is_Dispatching_Operation (E)
2580 and then Present (Overridden_Operation (E))
2581 and then C /= Convention (Overridden_Operation (E))
2584 ("cannot change convention for " &
2585 "overridden dispatching operation",
2589 -- Set the convention
2591 Set_Convention (E, C);
2592 Set_Has_Convention_Pragma (E);
2594 if Is_Incomplete_Or_Private_Type (E) then
2595 Set_Convention (Underlying_Type (E), C);
2596 Set_Has_Convention_Pragma (Underlying_Type (E), True);
2599 -- A class-wide type should inherit the convention of the specific
2600 -- root type (although this isn't specified clearly by the RM).
2602 if Is_Type (E) and then Present (Class_Wide_Type (E)) then
2603 Set_Convention (Class_Wide_Type (E), C);
2606 -- If the entity is a record type, then check for special case of
2607 -- C_Pass_By_Copy, which is treated the same as C except that the
2608 -- special record flag is set. This convention is only permitted
2609 -- on record types (see AI95-00131).
2611 if Cname = Name_C_Pass_By_Copy then
2612 if Is_Record_Type (E) then
2613 Set_C_Pass_By_Copy (Base_Type (E));
2614 elsif Is_Incomplete_Or_Private_Type (E)
2615 and then Is_Record_Type (Underlying_Type (E))
2617 Set_C_Pass_By_Copy (Base_Type (Underlying_Type (E)));
2620 ("C_Pass_By_Copy convention allowed only for record type",
2625 -- If the entity is a derived boolean type, check for the special
2626 -- case of convention C, C++, or Fortran, where we consider any
2627 -- nonzero value to represent true.
2629 if Is_Discrete_Type (E)
2630 and then Root_Type (Etype (E)) = Standard_Boolean
2636 C = Convention_Fortran)
2638 Set_Nonzero_Is_True (Base_Type (E));
2640 end Set_Convention_From_Pragma;
2642 -- Start of processing for Process_Convention
2645 Check_At_Least_N_Arguments (2);
2646 Check_Optional_Identifier (Arg1, Name_Convention);
2647 Check_Arg_Is_Identifier (Arg1);
2648 Cname := Chars (Expression (Arg1));
2650 -- C_Pass_By_Copy is treated as a synonym for convention C (this is
2651 -- tested again below to set the critical flag).
2652 if Cname = Name_C_Pass_By_Copy then
2655 -- Otherwise we must have something in the standard convention list
2657 elsif Is_Convention_Name (Cname) then
2658 C := Get_Convention_Id (Chars (Expression (Arg1)));
2660 -- In DEC VMS, it seems that there is an undocumented feature that
2661 -- any unrecognized convention is treated as the default, which for
2662 -- us is convention C. It does not seem so terrible to do this
2663 -- unconditionally, silently in the VMS case, and with a warning
2664 -- in the non-VMS case.
2667 if Warn_On_Export_Import and not OpenVMS_On_Target then
2669 ("?unrecognized convention name, C assumed",
2676 Check_Optional_Identifier (Arg2, Name_Entity);
2677 Check_Arg_Is_Local_Name (Arg2);
2679 Id := Expression (Arg2);
2682 if not Is_Entity_Name (Id) then
2683 Error_Pragma_Arg ("entity name required", Arg2);
2688 -- Set entity to return
2692 -- Go to renamed subprogram if present, since convention applies to
2693 -- the actual renamed entity, not to the renaming entity. If the
2694 -- subprogram is inherited, go to parent subprogram.
2696 if Is_Subprogram (E)
2697 and then Present (Alias (E))
2699 if Nkind (Parent (Declaration_Node (E))) =
2700 N_Subprogram_Renaming_Declaration
2702 if Scope (E) /= Scope (Alias (E)) then
2704 ("cannot apply pragma% to non-local entity&#", E);
2709 elsif Nkind_In (Parent (E), N_Full_Type_Declaration,
2710 N_Private_Extension_Declaration)
2711 and then Scope (E) = Scope (Alias (E))
2715 -- Return the parent subprogram the entity was inherited from
2721 -- Check that we are not applying this to a specless body
2723 if Is_Subprogram (E)
2724 and then Nkind (Parent (Declaration_Node (E))) = N_Subprogram_Body
2727 ("pragma% requires separate spec and must come before body");
2730 -- Check that we are not applying this to a named constant
2732 if Ekind_In (E, E_Named_Integer, E_Named_Real) then
2733 Error_Msg_Name_1 := Pname;
2735 ("cannot apply pragma% to named constant!",
2736 Get_Pragma_Arg (Arg2));
2738 ("\supply appropriate type for&!", Arg2);
2741 if Ekind (E) = E_Enumeration_Literal then
2742 Error_Pragma ("enumeration literal not allowed for pragma%");
2745 -- Check for rep item appearing too early or too late
2747 if Etype (E) = Any_Type
2748 or else Rep_Item_Too_Early (E, N)
2752 E := Underlying_Type (E);
2755 if Rep_Item_Too_Late (E, N) then
2759 if Has_Convention_Pragma (E) then
2760 Diagnose_Multiple_Pragmas (E);
2762 elsif Convention (E) = Convention_Protected
2763 or else Ekind (Scope (E)) = E_Protected_Type
2766 ("a protected operation cannot be given a different convention",
2770 -- For Intrinsic, a subprogram is required
2772 if C = Convention_Intrinsic
2773 and then not Is_Subprogram (E)
2774 and then not Is_Generic_Subprogram (E)
2777 ("second argument of pragma% must be a subprogram", Arg2);
2780 -- For Stdcall, a subprogram, variable or subprogram type is required
2782 if C = Convention_Stdcall
2783 and then not Is_Subprogram (E)
2784 and then not Is_Generic_Subprogram (E)
2785 and then Ekind (E) /= E_Variable
2788 and then Ekind (Designated_Type (E)) = E_Subprogram_Type)
2791 ("second argument of pragma% must be subprogram (type)",
2795 if not Is_Subprogram (E)
2796 and then not Is_Generic_Subprogram (E)
2798 Set_Convention_From_Pragma (E);
2801 Check_First_Subtype (Arg2);
2802 Set_Convention_From_Pragma (Base_Type (E));
2804 -- For subprograms, we must set the convention on the
2805 -- internally generated directly designated type as well.
2807 if Ekind (E) = E_Access_Subprogram_Type then
2808 Set_Convention_From_Pragma (Directly_Designated_Type (E));
2812 -- For the subprogram case, set proper convention for all homonyms
2813 -- in same scope and the same declarative part, i.e. the same
2814 -- compilation unit.
2817 Comp_Unit := Get_Source_Unit (E);
2818 Set_Convention_From_Pragma (E);
2820 -- Treat a pragma Import as an implicit body, for GPS use
2822 if Prag_Id = Pragma_Import then
2823 Generate_Reference (E, Id, 'b');
2826 -- Loop through the homonyms of the pragma argument's entity
2831 exit when No (E1) or else Scope (E1) /= Current_Scope;
2833 -- Do not set the pragma on inherited operations or on formal
2836 if Comes_From_Source (E1)
2837 and then Comp_Unit = Get_Source_Unit (E1)
2838 and then not Is_Formal_Subprogram (E1)
2839 and then Nkind (Original_Node (Parent (E1))) /=
2840 N_Full_Type_Declaration
2842 if Present (Alias (E1))
2843 and then Scope (E1) /= Scope (Alias (E1))
2846 ("cannot apply pragma% to non-local entity& declared#",
2850 Set_Convention_From_Pragma (E1);
2852 if Prag_Id = Pragma_Import then
2853 Generate_Reference (E1, Id, 'b');
2858 end Process_Convention;
2860 -----------------------------------------------------
2861 -- Process_Extended_Import_Export_Exception_Pragma --
2862 -----------------------------------------------------
2864 procedure Process_Extended_Import_Export_Exception_Pragma
2865 (Arg_Internal : Node_Id;
2866 Arg_External : Node_Id;
2874 if not OpenVMS_On_Target then
2876 ("?pragma% ignored (applies only to Open'V'M'S)");
2879 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2880 Def_Id := Entity (Arg_Internal);
2882 if Ekind (Def_Id) /= E_Exception then
2884 ("pragma% must refer to declared exception", Arg_Internal);
2887 Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2889 if Present (Arg_Form) then
2890 Check_Arg_Is_One_Of (Arg_Form, Name_Ada, Name_VMS);
2893 if Present (Arg_Form)
2894 and then Chars (Arg_Form) = Name_Ada
2898 Set_Is_VMS_Exception (Def_Id);
2899 Set_Exception_Code (Def_Id, No_Uint);
2902 if Present (Arg_Code) then
2903 if not Is_VMS_Exception (Def_Id) then
2905 ("Code option for pragma% not allowed for Ada case",
2909 Check_Arg_Is_Static_Expression (Arg_Code, Any_Integer);
2910 Code_Val := Expr_Value (Arg_Code);
2912 if not UI_Is_In_Int_Range (Code_Val) then
2914 ("Code option for pragma% must be in 32-bit range",
2918 Set_Exception_Code (Def_Id, Code_Val);
2921 end Process_Extended_Import_Export_Exception_Pragma;
2923 -------------------------------------------------
2924 -- Process_Extended_Import_Export_Internal_Arg --
2925 -------------------------------------------------
2927 procedure Process_Extended_Import_Export_Internal_Arg
2928 (Arg_Internal : Node_Id := Empty)
2931 if No (Arg_Internal) then
2932 Error_Pragma ("Internal parameter required for pragma%");
2935 if Nkind (Arg_Internal) = N_Identifier then
2938 elsif Nkind (Arg_Internal) = N_Operator_Symbol
2939 and then (Prag_Id = Pragma_Import_Function
2941 Prag_Id = Pragma_Export_Function)
2947 ("wrong form for Internal parameter for pragma%", Arg_Internal);
2950 Check_Arg_Is_Local_Name (Arg_Internal);
2951 end Process_Extended_Import_Export_Internal_Arg;
2953 --------------------------------------------------
2954 -- Process_Extended_Import_Export_Object_Pragma --
2955 --------------------------------------------------
2957 procedure Process_Extended_Import_Export_Object_Pragma
2958 (Arg_Internal : Node_Id;
2959 Arg_External : Node_Id;
2965 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
2966 Def_Id := Entity (Arg_Internal);
2968 if not Ekind_In (Def_Id, E_Constant, E_Variable) then
2970 ("pragma% must designate an object", Arg_Internal);
2973 if Has_Rep_Pragma (Def_Id, Name_Common_Object)
2975 Has_Rep_Pragma (Def_Id, Name_Psect_Object)
2978 ("previous Common/Psect_Object applies, pragma % not permitted",
2982 if Rep_Item_Too_Late (Def_Id, N) then
2986 Set_Extended_Import_Export_External_Name (Def_Id, Arg_External);
2988 if Present (Arg_Size) then
2989 Check_Arg_Is_External_Name (Arg_Size);
2992 -- Export_Object case
2994 if Prag_Id = Pragma_Export_Object then
2995 if not Is_Library_Level_Entity (Def_Id) then
2997 ("argument for pragma% must be library level entity",
3001 if Ekind (Current_Scope) = E_Generic_Package then
3002 Error_Pragma ("pragma& cannot appear in a generic unit");
3005 if not Size_Known_At_Compile_Time (Etype (Def_Id)) then
3007 ("exported object must have compile time known size",
3011 if Warn_On_Export_Import and then Is_Exported (Def_Id) then
3012 Error_Msg_N ("?duplicate Export_Object pragma", N);
3014 Set_Exported (Def_Id, Arg_Internal);
3017 -- Import_Object case
3020 if Is_Concurrent_Type (Etype (Def_Id)) then
3022 ("cannot use pragma% for task/protected object",
3026 if Ekind (Def_Id) = E_Constant then
3028 ("cannot import a constant", Arg_Internal);
3031 if Warn_On_Export_Import
3032 and then Has_Discriminants (Etype (Def_Id))
3035 ("imported value must be initialized?", Arg_Internal);
3038 if Warn_On_Export_Import
3039 and then Is_Access_Type (Etype (Def_Id))
3042 ("cannot import object of an access type?", Arg_Internal);
3045 if Warn_On_Export_Import
3046 and then Is_Imported (Def_Id)
3049 ("?duplicate Import_Object pragma", N);
3051 -- Check for explicit initialization present. Note that an
3052 -- initialization generated by the code generator, e.g. for an
3053 -- access type, does not count here.
3055 elsif Present (Expression (Parent (Def_Id)))
3058 (Original_Node (Expression (Parent (Def_Id))))
3060 Error_Msg_Sloc := Sloc (Def_Id);
3062 ("imported entities cannot be initialized (RM B.1(24))",
3063 "\no initialization allowed for & declared#", Arg1);
3065 Set_Imported (Def_Id);
3066 Note_Possible_Modification (Arg_Internal, Sure => False);
3069 end Process_Extended_Import_Export_Object_Pragma;
3071 ------------------------------------------------------
3072 -- Process_Extended_Import_Export_Subprogram_Pragma --
3073 ------------------------------------------------------
3075 procedure Process_Extended_Import_Export_Subprogram_Pragma
3076 (Arg_Internal : Node_Id;
3077 Arg_External : Node_Id;
3078 Arg_Parameter_Types : Node_Id;
3079 Arg_Result_Type : Node_Id := Empty;
3080 Arg_Mechanism : Node_Id;
3081 Arg_Result_Mechanism : Node_Id := Empty;
3082 Arg_First_Optional_Parameter : Node_Id := Empty)
3088 Ambiguous : Boolean;
3092 function Same_Base_Type
3094 Formal : Entity_Id) return Boolean;
3095 -- Determines if Ptype references the type of Formal. Note that only
3096 -- the base types need to match according to the spec. Ptype here is
3097 -- the argument from the pragma, which is either a type name, or an
3098 -- access attribute.
3100 --------------------
3101 -- Same_Base_Type --
3102 --------------------
3104 function Same_Base_Type
3106 Formal : Entity_Id) return Boolean
3108 Ftyp : constant Entity_Id := Base_Type (Etype (Formal));
3112 -- Case where pragma argument is typ'Access
3114 if Nkind (Ptype) = N_Attribute_Reference
3115 and then Attribute_Name (Ptype) = Name_Access
3117 Pref := Prefix (Ptype);
3120 if not Is_Entity_Name (Pref)
3121 or else Entity (Pref) = Any_Type
3126 -- We have a match if the corresponding argument is of an
3127 -- anonymous access type, and its designated type matches the
3128 -- type of the prefix of the access attribute
3130 return Ekind (Ftyp) = E_Anonymous_Access_Type
3131 and then Base_Type (Entity (Pref)) =
3132 Base_Type (Etype (Designated_Type (Ftyp)));
3134 -- Case where pragma argument is a type name
3139 if not Is_Entity_Name (Ptype)
3140 or else Entity (Ptype) = Any_Type
3145 -- We have a match if the corresponding argument is of the type
3146 -- given in the pragma (comparing base types)
3148 return Base_Type (Entity (Ptype)) = Ftyp;
3152 -- Start of processing for
3153 -- Process_Extended_Import_Export_Subprogram_Pragma
3156 Process_Extended_Import_Export_Internal_Arg (Arg_Internal);
3160 -- Loop through homonyms (overloadings) of the entity
3162 Hom_Id := Entity (Arg_Internal);
3163 while Present (Hom_Id) loop
3164 Def_Id := Get_Base_Subprogram (Hom_Id);
3166 -- We need a subprogram in the current scope
3168 if not Is_Subprogram (Def_Id)
3169 or else Scope (Def_Id) /= Current_Scope
3176 -- Pragma cannot apply to subprogram body
3178 if Is_Subprogram (Def_Id)
3179 and then Nkind (Parent (Declaration_Node (Def_Id))) =
3183 ("pragma% requires separate spec"
3184 & " and must come before body");
3187 -- Test result type if given, note that the result type
3188 -- parameter can only be present for the function cases.
3190 if Present (Arg_Result_Type)
3191 and then not Same_Base_Type (Arg_Result_Type, Def_Id)
3195 elsif Etype (Def_Id) /= Standard_Void_Type
3197 (Pname = Name_Export_Procedure
3199 Pname = Name_Import_Procedure)
3203 -- Test parameter types if given. Note that this parameter
3204 -- has not been analyzed (and must not be, since it is
3205 -- semantic nonsense), so we get it as the parser left it.
3207 elsif Present (Arg_Parameter_Types) then
3208 Check_Matching_Types : declare
3213 Formal := First_Formal (Def_Id);
3215 if Nkind (Arg_Parameter_Types) = N_Null then
3216 if Present (Formal) then
3220 -- A list of one type, e.g. (List) is parsed as
3221 -- a parenthesized expression.
3223 elsif Nkind (Arg_Parameter_Types) /= N_Aggregate
3224 and then Paren_Count (Arg_Parameter_Types) = 1
3227 or else Present (Next_Formal (Formal))
3232 Same_Base_Type (Arg_Parameter_Types, Formal);
3235 -- A list of more than one type is parsed as a aggregate
3237 elsif Nkind (Arg_Parameter_Types) = N_Aggregate
3238 and then Paren_Count (Arg_Parameter_Types) = 0
3240 Ptype := First (Expressions (Arg_Parameter_Types));
3241 while Present (Ptype) or else Present (Formal) loop
3244 or else not Same_Base_Type (Ptype, Formal)
3249 Next_Formal (Formal);
3254 -- Anything else is of the wrong form
3258 ("wrong form for Parameter_Types parameter",
3259 Arg_Parameter_Types);
3261 end Check_Matching_Types;
3264 -- Match is now False if the entry we found did not match
3265 -- either a supplied Parameter_Types or Result_Types argument
3271 -- Ambiguous case, the flag Ambiguous shows if we already
3272 -- detected this and output the initial messages.
3275 if not Ambiguous then
3277 Error_Msg_Name_1 := Pname;
3279 ("pragma% does not uniquely identify subprogram!",
3281 Error_Msg_Sloc := Sloc (Ent);
3282 Error_Msg_N ("matching subprogram #!", N);
3286 Error_Msg_Sloc := Sloc (Def_Id);
3287 Error_Msg_N ("matching subprogram #!", N);
3292 Hom_Id := Homonym (Hom_Id);
3295 -- See if we found an entry
3298 if not Ambiguous then
3299 if Is_Generic_Subprogram (Entity (Arg_Internal)) then
3301 ("pragma% cannot be given for generic subprogram");
3304 ("pragma% does not identify local subprogram");
3311 -- Import pragmas must be for imported entities
3313 if Prag_Id = Pragma_Import_Function
3315 Prag_Id = Pragma_Import_Procedure
3317 Prag_Id = Pragma_Import_Valued_Procedure
3319 if not Is_Imported (Ent) then
3321 ("pragma Import or Interface must precede pragma%");
3324 -- Here we have the Export case which can set the entity as exported
3326 -- But does not do so if the specified external name is null, since
3327 -- that is taken as a signal in DEC Ada 83 (with which we want to be
3328 -- compatible) to request no external name.
3330 elsif Nkind (Arg_External) = N_String_Literal
3331 and then String_Length (Strval (Arg_External)) = 0
3335 -- In all other cases, set entity as exported
3338 Set_Exported (Ent, Arg_Internal);
3341 -- Special processing for Valued_Procedure cases
3343 if Prag_Id = Pragma_Import_Valued_Procedure
3345 Prag_Id = Pragma_Export_Valued_Procedure
3347 Formal := First_Formal (Ent);
3350 Error_Pragma ("at least one parameter required for pragma%");
3352 elsif Ekind (Formal) /= E_Out_Parameter then
3353 Error_Pragma ("first parameter must have mode out for pragma%");
3356 Set_Is_Valued_Procedure (Ent);
3360 Set_Extended_Import_Export_External_Name (Ent, Arg_External);
3362 -- Process Result_Mechanism argument if present. We have already
3363 -- checked that this is only allowed for the function case.
3365 if Present (Arg_Result_Mechanism) then
3366 Set_Mechanism_Value (Ent, Arg_Result_Mechanism);
3369 -- Process Mechanism parameter if present. Note that this parameter
3370 -- is not analyzed, and must not be analyzed since it is semantic
3371 -- nonsense, so we get it in exactly as the parser left it.
3373 if Present (Arg_Mechanism) then
3381 -- A single mechanism association without a formal parameter
3382 -- name is parsed as a parenthesized expression. All other
3383 -- cases are parsed as aggregates, so we rewrite the single
3384 -- parameter case as an aggregate for consistency.
3386 if Nkind (Arg_Mechanism) /= N_Aggregate
3387 and then Paren_Count (Arg_Mechanism) = 1
3389 Rewrite (Arg_Mechanism,
3390 Make_Aggregate (Sloc (Arg_Mechanism),
3391 Expressions => New_List (
3392 Relocate_Node (Arg_Mechanism))));
3395 -- Case of only mechanism name given, applies to all formals
3397 if Nkind (Arg_Mechanism) /= N_Aggregate then
3398 Formal := First_Formal (Ent);
3399 while Present (Formal) loop
3400 Set_Mechanism_Value (Formal, Arg_Mechanism);
3401 Next_Formal (Formal);
3404 -- Case of list of mechanism associations given
3407 if Null_Record_Present (Arg_Mechanism) then
3409 ("inappropriate form for Mechanism parameter",
3413 -- Deal with positional ones first
3415 Formal := First_Formal (Ent);
3417 if Present (Expressions (Arg_Mechanism)) then
3418 Mname := First (Expressions (Arg_Mechanism));
3419 while Present (Mname) loop
3422 ("too many mechanism associations", Mname);
3425 Set_Mechanism_Value (Formal, Mname);
3426 Next_Formal (Formal);
3431 -- Deal with named entries
3433 if Present (Component_Associations (Arg_Mechanism)) then
3434 Massoc := First (Component_Associations (Arg_Mechanism));
3435 while Present (Massoc) loop
3436 Choice := First (Choices (Massoc));
3438 if Nkind (Choice) /= N_Identifier
3439 or else Present (Next (Choice))
3442 ("incorrect form for mechanism association",
3446 Formal := First_Formal (Ent);
3450 ("parameter name & not present", Choice);
3453 if Chars (Choice) = Chars (Formal) then
3455 (Formal, Expression (Massoc));
3457 -- Set entity on identifier for ASIS
3459 Set_Entity (Choice, Formal);
3464 Next_Formal (Formal);
3474 -- Process First_Optional_Parameter argument if present. We have
3475 -- already checked that this is only allowed for the Import case.
3477 if Present (Arg_First_Optional_Parameter) then
3478 if Nkind (Arg_First_Optional_Parameter) /= N_Identifier then
3480 ("first optional parameter must be formal parameter name",
3481 Arg_First_Optional_Parameter);
3484 Formal := First_Formal (Ent);
3488 ("specified formal parameter& not found",
3489 Arg_First_Optional_Parameter);
3492 exit when Chars (Formal) =
3493 Chars (Arg_First_Optional_Parameter);
3495 Next_Formal (Formal);
3498 Set_First_Optional_Parameter (Ent, Formal);
3500 -- Check specified and all remaining formals have right form
3502 while Present (Formal) loop
3503 if Ekind (Formal) /= E_In_Parameter then
3505 ("optional formal& is not of mode in!",
3506 Arg_First_Optional_Parameter, Formal);
3509 Dval := Default_Value (Formal);
3513 ("optional formal& does not have default value!",
3514 Arg_First_Optional_Parameter, Formal);
3516 elsif Compile_Time_Known_Value_Or_Aggr (Dval) then
3521 ("default value for optional formal& is non-static!",
3522 Arg_First_Optional_Parameter, Formal);
3526 Set_Is_Optional_Parameter (Formal);
3527 Next_Formal (Formal);
3530 end Process_Extended_Import_Export_Subprogram_Pragma;
3532 --------------------------
3533 -- Process_Generic_List --
3534 --------------------------
3536 procedure Process_Generic_List is
3541 Check_No_Identifiers;
3542 Check_At_Least_N_Arguments (1);
3545 while Present (Arg) loop
3546 Exp := Expression (Arg);
3549 if not Is_Entity_Name (Exp)
3551 (not Is_Generic_Instance (Entity (Exp))
3553 not Is_Generic_Unit (Entity (Exp)))
3556 ("pragma% argument must be name of generic unit/instance",
3562 end Process_Generic_List;
3564 ---------------------------------
3565 -- Process_Import_Or_Interface --
3566 ---------------------------------
3568 procedure Process_Import_Or_Interface is
3574 Process_Convention (C, Def_Id);
3575 Kill_Size_Check_Code (Def_Id);
3576 Note_Possible_Modification (Expression (Arg2), Sure => False);
3578 if Ekind_In (Def_Id, E_Variable, E_Constant) then
3580 -- We do not permit Import to apply to a renaming declaration
3582 if Present (Renamed_Object (Def_Id)) then
3584 ("pragma% not allowed for object renaming", Arg2);
3586 -- User initialization is not allowed for imported object, but
3587 -- the object declaration may contain a default initialization,
3588 -- that will be discarded. Note that an explicit initialization
3589 -- only counts if it comes from source, otherwise it is simply
3590 -- the code generator making an implicit initialization explicit.
3592 elsif Present (Expression (Parent (Def_Id)))
3593 and then Comes_From_Source (Expression (Parent (Def_Id)))
3595 Error_Msg_Sloc := Sloc (Def_Id);
3597 ("no initialization allowed for declaration of& #",
3598 "\imported entities cannot be initialized (RM B.1(24))",
3602 Set_Imported (Def_Id);
3603 Process_Interface_Name (Def_Id, Arg3, Arg4);
3605 -- Note that we do not set Is_Public here. That's because we
3606 -- only want to set it if there is no address clause, and we
3607 -- don't know that yet, so we delay that processing till
3610 -- pragma Import completes deferred constants
3612 if Ekind (Def_Id) = E_Constant then
3613 Set_Has_Completion (Def_Id);
3616 -- It is not possible to import a constant of an unconstrained
3617 -- array type (e.g. string) because there is no simple way to
3618 -- write a meaningful subtype for it.
3620 if Is_Array_Type (Etype (Def_Id))
3621 and then not Is_Constrained (Etype (Def_Id))
3624 ("imported constant& must have a constrained subtype",
3629 elsif Is_Subprogram (Def_Id)
3630 or else Is_Generic_Subprogram (Def_Id)
3632 -- If the name is overloaded, pragma applies to all of the
3633 -- denoted entities in the same declarative part.
3636 while Present (Hom_Id) loop
3637 Def_Id := Get_Base_Subprogram (Hom_Id);
3639 -- Ignore inherited subprograms because the pragma will
3640 -- apply to the parent operation, which is the one called.
3642 if Is_Overloadable (Def_Id)
3643 and then Present (Alias (Def_Id))
3647 -- If it is not a subprogram, it must be in an outer scope and
3648 -- pragma does not apply.
3650 elsif not Is_Subprogram (Def_Id)
3651 and then not Is_Generic_Subprogram (Def_Id)
3655 -- Verify that the homonym is in the same declarative part (not
3656 -- just the same scope).
3658 elsif Parent (Unit_Declaration_Node (Def_Id)) /= Parent (N)
3659 and then Nkind (Parent (N)) /= N_Compilation_Unit_Aux
3664 Set_Imported (Def_Id);
3666 -- Reject an Import applied to an abstract subprogram
3668 if Is_Subprogram (Def_Id)
3669 and then Is_Abstract_Subprogram (Def_Id)
3671 Error_Msg_Sloc := Sloc (Def_Id);
3673 ("cannot import abstract subprogram& declared#",
3677 -- Special processing for Convention_Intrinsic
3679 if C = Convention_Intrinsic then
3681 -- Link_Name argument not allowed for intrinsic
3684 and then Chars (Arg3) = Name_Link_Name
3689 if Present (Arg4) then
3691 ("Link_Name argument not allowed for " &
3696 Set_Is_Intrinsic_Subprogram (Def_Id);
3698 -- If no external name is present, then check that this
3699 -- is a valid intrinsic subprogram. If an external name
3700 -- is present, then this is handled by the back end.
3703 Check_Intrinsic_Subprogram (Def_Id, Expression (Arg2));
3707 -- All interfaced procedures need an external symbol created
3708 -- for them since they are always referenced from another
3711 Set_Is_Public (Def_Id);
3713 -- Verify that the subprogram does not have a completion
3714 -- through a renaming declaration. For other completions the
3715 -- pragma appears as a too late representation.
3718 Decl : constant Node_Id := Unit_Declaration_Node (Def_Id);
3722 and then Nkind (Decl) = N_Subprogram_Declaration
3723 and then Present (Corresponding_Body (Decl))
3724 and then Nkind (Unit_Declaration_Node
3725 (Corresponding_Body (Decl))) =
3726 N_Subprogram_Renaming_Declaration
3728 Error_Msg_Sloc := Sloc (Def_Id);
3730 ("cannot import&, renaming already provided for " &
3731 "declaration #", N, Def_Id);
3735 Set_Has_Completion (Def_Id);
3736 Process_Interface_Name (Def_Id, Arg3, Arg4);
3739 if Is_Compilation_Unit (Hom_Id) then
3741 -- Its possible homonyms are not affected by the pragma.
3742 -- Such homonyms might be present in the context of other
3743 -- units being compiled.
3748 Hom_Id := Homonym (Hom_Id);
3752 -- When the convention is Java or CIL, we also allow Import to be
3753 -- given for packages, generic packages, exceptions, record
3754 -- components, and access to subprograms.
3756 elsif (C = Convention_Java or else C = Convention_CIL)
3758 (Is_Package_Or_Generic_Package (Def_Id)
3759 or else Ekind (Def_Id) = E_Exception
3760 or else Ekind (Def_Id) = E_Access_Subprogram_Type
3761 or else Nkind (Parent (Def_Id)) = N_Component_Declaration)
3763 Set_Imported (Def_Id);
3764 Set_Is_Public (Def_Id);
3765 Process_Interface_Name (Def_Id, Arg3, Arg4);
3767 -- Import a CPP class
3769 elsif Is_Record_Type (Def_Id)
3770 and then C = Convention_CPP
3772 -- Types treated as CPP classes are treated as limited, but we
3773 -- don't require them to be declared this way. A warning is
3774 -- issued to encourage the user to declare them as limited.
3775 -- This is not an error, for compatibility reasons, because
3776 -- these types have been supported this way for some time.
3778 if not Is_Limited_Type (Def_Id) then
3780 ("imported 'C'P'P type should be " &
3781 "explicitly declared limited?",
3782 Get_Pragma_Arg (Arg2));
3784 ("\type will be considered limited",
3785 Get_Pragma_Arg (Arg2));
3788 Set_Is_CPP_Class (Def_Id);
3789 Set_Is_Limited_Record (Def_Id);
3791 -- Imported CPP types must not have discriminants (because C++
3792 -- classes do not have discriminants).
3794 if Has_Discriminants (Def_Id) then
3796 ("imported 'C'P'P type cannot have discriminants",
3797 First (Discriminant_Specifications
3798 (Declaration_Node (Def_Id))));
3801 -- Components of imported CPP types must not have default
3802 -- expressions because the constructor (if any) is on the
3806 Tdef : constant Node_Id :=
3807 Type_Definition (Declaration_Node (Def_Id));
3812 if Nkind (Tdef) = N_Record_Definition then
3813 Clist := Component_List (Tdef);
3816 pragma Assert (Nkind (Tdef) = N_Derived_Type_Definition);
3817 Clist := Component_List (Record_Extension_Part (Tdef));
3820 if Present (Clist) then
3821 Comp := First (Component_Items (Clist));
3822 while Present (Comp) loop
3823 if Present (Expression (Comp)) then
3825 ("component of imported 'C'P'P type cannot have" &
3826 " default expression", Expression (Comp));
3836 ("second argument of pragma% must be object or subprogram",
3840 -- If this pragma applies to a compilation unit, then the unit, which
3841 -- is a subprogram, does not require (or allow) a body. We also do
3842 -- not need to elaborate imported procedures.
3844 if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
3846 Cunit : constant Node_Id := Parent (Parent (N));
3848 Set_Body_Required (Cunit, False);
3851 end Process_Import_Or_Interface;
3853 --------------------
3854 -- Process_Inline --
3855 --------------------
3857 procedure Process_Inline (Active : Boolean) is
3863 Effective : Boolean := False;
3865 procedure Make_Inline (Subp : Entity_Id);
3866 -- Subp is the defining unit name of the subprogram declaration. Set
3867 -- the flag, as well as the flag in the corresponding body, if there
3870 procedure Set_Inline_Flags (Subp : Entity_Id);
3871 -- Sets Is_Inlined and Has_Pragma_Inline flags for Subp and also
3872 -- Has_Pragma_Inline_Always for the Inline_Always case.
3874 function Inlining_Not_Possible (Subp : Entity_Id) return Boolean;
3875 -- Returns True if it can be determined at this stage that inlining
3876 -- is not possible, for example if the body is available and contains
3877 -- exception handlers, we prevent inlining, since otherwise we can
3878 -- get undefined symbols at link time. This function also emits a
3879 -- warning if front-end inlining is enabled and the pragma appears
3882 -- ??? is business with link symbols still valid, or does it relate
3883 -- to front end ZCX which is being phased out ???
3885 ---------------------------
3886 -- Inlining_Not_Possible --
3887 ---------------------------
3889 function Inlining_Not_Possible (Subp : Entity_Id) return Boolean is
3890 Decl : constant Node_Id := Unit_Declaration_Node (Subp);
3894 if Nkind (Decl) = N_Subprogram_Body then
3895 Stats := Handled_Statement_Sequence (Decl);
3896 return Present (Exception_Handlers (Stats))
3897 or else Present (At_End_Proc (Stats));
3899 elsif Nkind (Decl) = N_Subprogram_Declaration
3900 and then Present (Corresponding_Body (Decl))
3902 if Front_End_Inlining
3903 and then Analyzed (Corresponding_Body (Decl))
3905 Error_Msg_N ("pragma appears too late, ignored?", N);
3908 -- If the subprogram is a renaming as body, the body is just a
3909 -- call to the renamed subprogram, and inlining is trivially
3913 Nkind (Unit_Declaration_Node (Corresponding_Body (Decl))) =
3914 N_Subprogram_Renaming_Declaration
3920 Handled_Statement_Sequence
3921 (Unit_Declaration_Node (Corresponding_Body (Decl)));
3924 Present (Exception_Handlers (Stats))
3925 or else Present (At_End_Proc (Stats));
3929 -- If body is not available, assume the best, the check is
3930 -- performed again when compiling enclosing package bodies.
3934 end Inlining_Not_Possible;
3940 procedure Make_Inline (Subp : Entity_Id) is
3941 Kind : constant Entity_Kind := Ekind (Subp);
3942 Inner_Subp : Entity_Id := Subp;
3945 -- Ignore if bad type, avoid cascaded error
3947 if Etype (Subp) = Any_Type then
3951 -- Ignore if all inlining is suppressed
3953 elsif Suppress_All_Inlining then
3957 -- If inlining is not possible, for now do not treat as an error
3959 elsif Inlining_Not_Possible (Subp) then
3963 -- Here we have a candidate for inlining, but we must exclude
3964 -- derived operations. Otherwise we would end up trying to inline
3965 -- a phantom declaration, and the result would be to drag in a
3966 -- body which has no direct inlining associated with it. That
3967 -- would not only be inefficient but would also result in the
3968 -- backend doing cross-unit inlining in cases where it was
3969 -- definitely inappropriate to do so.
3971 -- However, a simple Comes_From_Source test is insufficient, since
3972 -- we do want to allow inlining of generic instances which also do
3973 -- not come from source. We also need to recognize specs generated
3974 -- by the front-end for bodies that carry the pragma. Finally,
3975 -- predefined operators do not come from source but are not
3976 -- inlineable either.
3978 elsif Is_Generic_Instance (Subp)
3979 or else Nkind (Parent (Parent (Subp))) = N_Subprogram_Declaration
3983 elsif not Comes_From_Source (Subp)
3984 and then Scope (Subp) /= Standard_Standard
3990 -- The referenced entity must either be the enclosing entity, or
3991 -- an entity declared within the current open scope.
3993 if Present (Scope (Subp))
3994 and then Scope (Subp) /= Current_Scope
3995 and then Subp /= Current_Scope
3998 ("argument of% must be entity in current scope", Assoc);
4002 -- Processing for procedure, operator or function. If subprogram
4003 -- is aliased (as for an instance) indicate that the renamed
4004 -- entity (if declared in the same unit) is inlined.
4006 if Is_Subprogram (Subp) then
4007 Inner_Subp := Ultimate_Alias (Inner_Subp);
4009 if In_Same_Source_Unit (Subp, Inner_Subp) then
4010 Set_Inline_Flags (Inner_Subp);
4012 Decl := Parent (Parent (Inner_Subp));
4014 if Nkind (Decl) = N_Subprogram_Declaration
4015 and then Present (Corresponding_Body (Decl))
4017 Set_Inline_Flags (Corresponding_Body (Decl));
4019 elsif Is_Generic_Instance (Subp) then
4021 -- Indicate that the body needs to be created for
4022 -- inlining subsequent calls. The instantiation node
4023 -- follows the declaration of the wrapper package
4026 if Scope (Subp) /= Standard_Standard
4028 Need_Subprogram_Instance_Body
4029 (Next (Unit_Declaration_Node (Scope (Alias (Subp)))),
4039 -- For a generic subprogram set flag as well, for use at the point
4040 -- of instantiation, to determine whether the body should be
4043 elsif Is_Generic_Subprogram (Subp) then
4044 Set_Inline_Flags (Subp);
4047 -- Literals are by definition inlined
4049 elsif Kind = E_Enumeration_Literal then
4052 -- Anything else is an error
4056 ("expect subprogram name for pragma%", Assoc);
4060 ----------------------
4061 -- Set_Inline_Flags --
4062 ----------------------
4064 procedure Set_Inline_Flags (Subp : Entity_Id) is
4067 Set_Is_Inlined (Subp, True);
4070 if not Has_Pragma_Inline (Subp) then
4071 Set_Has_Pragma_Inline (Subp);
4075 if Prag_Id = Pragma_Inline_Always then
4076 Set_Has_Pragma_Inline_Always (Subp);
4078 end Set_Inline_Flags;
4080 -- Start of processing for Process_Inline
4083 Check_No_Identifiers;
4084 Check_At_Least_N_Arguments (1);
4087 Inline_Processing_Required := True;
4091 while Present (Assoc) loop
4092 Subp_Id := Expression (Assoc);
4096 if Is_Entity_Name (Subp_Id) then
4097 Subp := Entity (Subp_Id);
4099 if Subp = Any_Id then
4101 -- If previous error, avoid cascaded errors
4109 while Present (Homonym (Subp))
4110 and then Scope (Homonym (Subp)) = Current_Scope
4112 Make_Inline (Homonym (Subp));
4113 Subp := Homonym (Subp);
4120 ("inappropriate argument for pragma%", Assoc);
4123 and then Warn_On_Redundant_Constructs
4124 and then not Suppress_All_Inlining
4126 if Inlining_Not_Possible (Subp) then
4128 ("pragma Inline for& is ignored?", N, Entity (Subp_Id));
4131 ("pragma Inline for& is redundant?", N, Entity (Subp_Id));
4139 ----------------------------
4140 -- Process_Interface_Name --
4141 ----------------------------
4143 procedure Process_Interface_Name
4144 (Subprogram_Def : Entity_Id;
4150 String_Val : String_Id;
4152 procedure Check_Form_Of_Interface_Name
4154 Ext_Name_Case : Boolean);
4155 -- SN is a string literal node for an interface name. This routine
4156 -- performs some minimal checks that the name is reasonable. In
4157 -- particular that no spaces or other obviously incorrect characters
4158 -- appear. This is only a warning, since any characters are allowed.
4159 -- Ext_Name_Case is True for an External_Name, False for a Link_Name.
4161 ----------------------------------
4162 -- Check_Form_Of_Interface_Name --
4163 ----------------------------------
4165 procedure Check_Form_Of_Interface_Name
4167 Ext_Name_Case : Boolean)
4169 S : constant String_Id := Strval (Expr_Value_S (SN));
4170 SL : constant Nat := String_Length (S);
4175 Error_Msg_N ("interface name cannot be null string", SN);
4178 for J in 1 .. SL loop
4179 C := Get_String_Char (S, J);
4181 -- Look for dubious character and issue unconditional warning.
4182 -- Definitely dubious if not in character range.
4184 if not In_Character_Range (C)
4186 -- For all cases except CLI target,
4187 -- commas, spaces and slashes are dubious (in CLI, we use
4188 -- commas and backslashes in external names to specify
4189 -- assembly version and public key, while slashes and spaces
4190 -- can be used in names to mark nested classes and
4193 or else ((not Ext_Name_Case or else VM_Target /= CLI_Target)
4194 and then (Get_Character (C) = ','
4196 Get_Character (C) = '\'))
4197 or else (VM_Target /= CLI_Target
4198 and then (Get_Character (C) = ' '
4200 Get_Character (C) = '/'))
4203 ("?interface name contains illegal character",
4204 Sloc (SN) + Source_Ptr (J));
4207 end Check_Form_Of_Interface_Name;
4209 -- Start of processing for Process_Interface_Name
4212 if No (Link_Arg) then
4213 if No (Ext_Arg) then
4214 if VM_Target = CLI_Target
4215 and then Ekind (Subprogram_Def) = E_Package
4216 and then Nkind (Parent (Subprogram_Def)) =
4217 N_Package_Specification
4218 and then Present (Generic_Parent (Parent (Subprogram_Def)))
4223 (Generic_Parent (Parent (Subprogram_Def))));
4228 elsif Chars (Ext_Arg) = Name_Link_Name then
4230 Link_Nam := Expression (Ext_Arg);
4233 Check_Optional_Identifier (Ext_Arg, Name_External_Name);
4234 Ext_Nam := Expression (Ext_Arg);
4239 Check_Optional_Identifier (Ext_Arg, Name_External_Name);
4240 Check_Optional_Identifier (Link_Arg, Name_Link_Name);
4241 Ext_Nam := Expression (Ext_Arg);
4242 Link_Nam := Expression (Link_Arg);
4245 -- Check expressions for external name and link name are static
4247 if Present (Ext_Nam) then
4248 Check_Arg_Is_Static_Expression (Ext_Nam, Standard_String);
4249 Check_Form_Of_Interface_Name (Ext_Nam, Ext_Name_Case => True);
4251 -- Verify that external name is not the name of a local entity,
4252 -- which would hide the imported one and could lead to run-time
4253 -- surprises. The problem can only arise for entities declared in
4254 -- a package body (otherwise the external name is fully qualified
4255 -- and will not conflict).
4263 if Prag_Id = Pragma_Import then
4264 String_To_Name_Buffer (Strval (Expr_Value_S (Ext_Nam)));
4266 E := Entity_Id (Get_Name_Table_Info (Nam));
4268 if Nam /= Chars (Subprogram_Def)
4269 and then Present (E)
4270 and then not Is_Overloadable (E)
4271 and then Is_Immediately_Visible (E)
4272 and then not Is_Imported (E)
4273 and then Ekind (Scope (E)) = E_Package
4276 while Present (Par) loop
4277 if Nkind (Par) = N_Package_Body then
4278 Error_Msg_Sloc := Sloc (E);
4280 ("imported entity is hidden by & declared#",
4285 Par := Parent (Par);
4292 if Present (Link_Nam) then
4293 Check_Arg_Is_Static_Expression (Link_Nam, Standard_String);
4294 Check_Form_Of_Interface_Name (Link_Nam, Ext_Name_Case => False);
4297 -- If there is no link name, just set the external name
4299 if No (Link_Nam) then
4300 Link_Nam := Adjust_External_Name_Case (Expr_Value_S (Ext_Nam));
4302 -- For the Link_Name case, the given literal is preceded by an
4303 -- asterisk, which indicates to GCC that the given name should be
4304 -- taken literally, and in particular that no prepending of
4305 -- underlines should occur, even in systems where this is the
4311 if VM_Target = No_VM then
4312 Store_String_Char (Get_Char_Code ('*'));
4315 String_Val := Strval (Expr_Value_S (Link_Nam));
4316 Store_String_Chars (String_Val);
4318 Make_String_Literal (Sloc (Link_Nam),
4319 Strval => End_String);
4322 Set_Encoded_Interface_Name
4323 (Get_Base_Subprogram (Subprogram_Def), Link_Nam);
4325 -- We allow duplicated export names in CIL, as they are always
4326 -- enclosed in a namespace that differentiates them, and overloaded
4327 -- entities are supported by the VM.
4329 if Convention (Subprogram_Def) /= Convention_CIL then
4330 Check_Duplicated_Export_Name (Link_Nam);
4332 end Process_Interface_Name;
4334 -----------------------------------------
4335 -- Process_Interrupt_Or_Attach_Handler --
4336 -----------------------------------------
4338 procedure Process_Interrupt_Or_Attach_Handler is
4339 Arg1_X : constant Node_Id := Expression (Arg1);
4340 Handler_Proc : constant Entity_Id := Entity (Arg1_X);
4341 Proc_Scope : constant Entity_Id := Scope (Handler_Proc);
4344 Set_Is_Interrupt_Handler (Handler_Proc);
4346 -- If the pragma is not associated with a handler procedure within a
4347 -- protected type, then it must be for a nonprotected procedure for
4348 -- the AAMP target, in which case we don't associate a representation
4349 -- item with the procedure's scope.
4351 if Ekind (Proc_Scope) = E_Protected_Type then
4352 if Prag_Id = Pragma_Interrupt_Handler
4354 Prag_Id = Pragma_Attach_Handler
4356 Record_Rep_Item (Proc_Scope, N);
4359 end Process_Interrupt_Or_Attach_Handler;
4361 --------------------------------------------------
4362 -- Process_Restrictions_Or_Restriction_Warnings --
4363 --------------------------------------------------
4365 -- Note: some of the simple identifier cases were handled in par-prag,
4366 -- but it is harmless (and more straightforward) to simply handle all
4367 -- cases here, even if it means we repeat a bit of work in some cases.
4369 procedure Process_Restrictions_Or_Restriction_Warnings
4373 R_Id : Restriction_Id;
4378 procedure Check_Unit_Name (N : Node_Id);
4379 -- Checks unit name parameter for No_Dependence. Returns if it has
4380 -- an appropriate form, otherwise raises pragma argument error.
4382 ---------------------
4383 -- Check_Unit_Name --
4384 ---------------------
4386 procedure Check_Unit_Name (N : Node_Id) is
4388 if Nkind (N) = N_Selected_Component then
4389 Check_Unit_Name (Prefix (N));
4390 Check_Unit_Name (Selector_Name (N));
4392 elsif Nkind (N) = N_Identifier then
4397 ("wrong form for unit name for No_Dependence", N);
4399 end Check_Unit_Name;
4401 -- Start of processing for Process_Restrictions_Or_Restriction_Warnings
4404 Check_Ada_83_Warning;
4405 Check_At_Least_N_Arguments (1);
4406 Check_Valid_Configuration_Pragma;
4409 while Present (Arg) loop
4411 Expr := Expression (Arg);
4413 -- Case of no restriction identifier present
4415 if Id = No_Name then
4416 if Nkind (Expr) /= N_Identifier then
4418 ("invalid form for restriction", Arg);
4423 (Process_Restriction_Synonyms (Expr));
4425 if R_Id not in All_Boolean_Restrictions then
4426 Error_Msg_Name_1 := Pname;
4428 ("invalid restriction identifier&", Get_Pragma_Arg (Arg));
4430 -- Check for possible misspelling
4432 for J in Restriction_Id loop
4434 Rnm : constant String := Restriction_Id'Image (J);
4437 Name_Buffer (1 .. Rnm'Length) := Rnm;
4438 Name_Len := Rnm'Length;
4439 Set_Casing (All_Lower_Case);
4441 if Is_Bad_Spelling_Of (Chars (Expr), Name_Enter) then
4443 (Identifier_Casing (Current_Source_File));
4444 Error_Msg_String (1 .. Rnm'Length) :=
4445 Name_Buffer (1 .. Name_Len);
4446 Error_Msg_Strlen := Rnm'Length;
4447 Error_Msg_N -- CODEFIX
4448 ("\possible misspelling of ""~""",
4449 Get_Pragma_Arg (Arg));
4458 if Implementation_Restriction (R_Id) then
4459 Check_Restriction (No_Implementation_Restrictions, Arg);
4462 -- If this is a warning, then set the warning unless we already
4463 -- have a real restriction active (we never want a warning to
4464 -- override a real restriction).
4467 if not Restriction_Active (R_Id) then
4468 Set_Restriction (R_Id, N);
4469 Restriction_Warnings (R_Id) := True;
4472 -- If real restriction case, then set it and make sure that the
4473 -- restriction warning flag is off, since a real restriction
4474 -- always overrides a warning.
4477 Set_Restriction (R_Id, N);
4478 Restriction_Warnings (R_Id) := False;
4481 -- Check for obsolescent restrictions in Ada 2005 mode
4484 and then Ada_Version >= Ada_2005
4485 and then (R_Id = No_Asynchronous_Control
4487 R_Id = No_Unchecked_Deallocation
4489 R_Id = No_Unchecked_Conversion)
4491 Check_Restriction (No_Obsolescent_Features, N);
4494 -- A very special case that must be processed here: pragma
4495 -- Restrictions (No_Exceptions) turns off all run-time
4496 -- checking. This is a bit dubious in terms of the formal
4497 -- language definition, but it is what is intended by RM
4498 -- H.4(12). Restriction_Warnings never affects generated code
4499 -- so this is done only in the real restriction case.
4501 if R_Id = No_Exceptions and then not Warn then
4502 Scope_Suppress := (others => True);
4505 -- Case of No_Dependence => unit-name. Note that the parser
4506 -- already made the necessary entry in the No_Dependence table.
4508 elsif Id = Name_No_Dependence then
4509 Check_Unit_Name (Expr);
4511 -- All other cases of restriction identifier present
4514 R_Id := Get_Restriction_Id (Process_Restriction_Synonyms (Arg));
4515 Analyze_And_Resolve (Expr, Any_Integer);
4517 if R_Id not in All_Parameter_Restrictions then
4519 ("invalid restriction parameter identifier", Arg);
4521 elsif not Is_OK_Static_Expression (Expr) then
4522 Flag_Non_Static_Expr
4523 ("value must be static expression!", Expr);
4526 elsif not Is_Integer_Type (Etype (Expr))
4527 or else Expr_Value (Expr) < 0
4530 ("value must be non-negative integer", Arg);
4533 -- Restriction pragma is active
4535 Val := Expr_Value (Expr);
4537 if not UI_Is_In_Int_Range (Val) then
4539 ("pragma ignored, value too large?", Arg);
4542 -- Warning case. If the real restriction is active, then we
4543 -- ignore the request, since warning never overrides a real
4544 -- restriction. Otherwise we set the proper warning. Note that
4545 -- this circuit sets the warning again if it is already set,
4546 -- which is what we want, since the constant may have changed.
4549 if not Restriction_Active (R_Id) then
4551 (R_Id, N, Integer (UI_To_Int (Val)));
4552 Restriction_Warnings (R_Id) := True;
4555 -- Real restriction case, set restriction and make sure warning
4556 -- flag is off since real restriction always overrides warning.
4559 Set_Restriction (R_Id, N, Integer (UI_To_Int (Val)));
4560 Restriction_Warnings (R_Id) := False;
4566 end Process_Restrictions_Or_Restriction_Warnings;
4568 ---------------------------------
4569 -- Process_Suppress_Unsuppress --
4570 ---------------------------------
4572 -- Note: this procedure makes entries in the check suppress data
4573 -- structures managed by Sem. See spec of package Sem for full
4574 -- details on how we handle recording of check suppression.
4576 procedure Process_Suppress_Unsuppress (Suppress_Case : Boolean) is
4581 In_Package_Spec : constant Boolean :=
4582 Is_Package_Or_Generic_Package (Current_Scope)
4583 and then not In_Package_Body (Current_Scope);
4585 procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id);
4586 -- Used to suppress a single check on the given entity
4588 --------------------------------
4589 -- Suppress_Unsuppress_Echeck --
4590 --------------------------------
4592 procedure Suppress_Unsuppress_Echeck (E : Entity_Id; C : Check_Id) is
4594 Set_Checks_May_Be_Suppressed (E);
4596 if In_Package_Spec then
4597 Push_Global_Suppress_Stack_Entry
4600 Suppress => Suppress_Case);
4603 Push_Local_Suppress_Stack_Entry
4606 Suppress => Suppress_Case);
4609 -- If this is a first subtype, and the base type is distinct,
4610 -- then also set the suppress flags on the base type.
4612 if Is_First_Subtype (E)
4613 and then Etype (E) /= E
4615 Suppress_Unsuppress_Echeck (Etype (E), C);
4617 end Suppress_Unsuppress_Echeck;
4619 -- Start of processing for Process_Suppress_Unsuppress
4622 -- Suppress/Unsuppress can appear as a configuration pragma, or in a
4623 -- declarative part or a package spec (RM 11.5(5)).
4625 if not Is_Configuration_Pragma then
4626 Check_Is_In_Decl_Part_Or_Package_Spec;
4629 Check_At_Least_N_Arguments (1);
4630 Check_At_Most_N_Arguments (2);
4631 Check_No_Identifier (Arg1);
4632 Check_Arg_Is_Identifier (Arg1);
4634 C := Get_Check_Id (Chars (Expression (Arg1)));
4636 if C = No_Check_Id then
4638 ("argument of pragma% is not valid check name", Arg1);
4641 if not Suppress_Case
4642 and then (C = All_Checks or else C = Overflow_Check)
4644 Opt.Overflow_Checks_Unsuppressed := True;
4647 if Arg_Count = 1 then
4649 -- Make an entry in the local scope suppress table. This is the
4650 -- table that directly shows the current value of the scope
4651 -- suppress check for any check id value.
4653 if C = All_Checks then
4655 -- For All_Checks, we set all specific predefined checks with
4656 -- the exception of Elaboration_Check, which is handled
4657 -- specially because of not wanting All_Checks to have the
4658 -- effect of deactivating static elaboration order processing.
4660 for J in Scope_Suppress'Range loop
4661 if J /= Elaboration_Check then
4662 Scope_Suppress (J) := Suppress_Case;
4666 -- If not All_Checks, and predefined check, then set appropriate
4667 -- scope entry. Note that we will set Elaboration_Check if this
4668 -- is explicitly specified.
4670 elsif C in Predefined_Check_Id then
4671 Scope_Suppress (C) := Suppress_Case;
4674 -- Also make an entry in the Local_Entity_Suppress table
4676 Push_Local_Suppress_Stack_Entry
4679 Suppress => Suppress_Case);
4681 -- Case of two arguments present, where the check is suppressed for
4682 -- a specified entity (given as the second argument of the pragma)
4685 -- This is obsolescent in Ada 2005 mode
4687 if Ada_Version >= Ada_2005 then
4688 Check_Restriction (No_Obsolescent_Features, Arg2);
4691 Check_Optional_Identifier (Arg2, Name_On);
4692 E_Id := Expression (Arg2);
4695 if not Is_Entity_Name (E_Id) then
4697 ("second argument of pragma% must be entity name", Arg2);
4706 -- Enforce RM 11.5(7) which requires that for a pragma that
4707 -- appears within a package spec, the named entity must be
4708 -- within the package spec. We allow the package name itself
4709 -- to be mentioned since that makes sense, although it is not
4710 -- strictly allowed by 11.5(7).
4713 and then E /= Current_Scope
4714 and then Scope (E) /= Current_Scope
4717 ("entity in pragma% is not in package spec (RM 11.5(7))",
4721 -- Loop through homonyms. As noted below, in the case of a package
4722 -- spec, only homonyms within the package spec are considered.
4725 Suppress_Unsuppress_Echeck (E, C);
4727 if Is_Generic_Instance (E)
4728 and then Is_Subprogram (E)
4729 and then Present (Alias (E))
4731 Suppress_Unsuppress_Echeck (Alias (E), C);
4734 -- Move to next homonym
4739 -- If we are within a package specification, the pragma only
4740 -- applies to homonyms in the same scope.
4742 exit when In_Package_Spec
4743 and then Scope (E) /= Current_Scope;
4746 end Process_Suppress_Unsuppress;
4752 procedure Set_Exported (E : Entity_Id; Arg : Node_Id) is
4754 if Is_Imported (E) then
4756 ("cannot export entity& that was previously imported", Arg);
4758 elsif Present (Address_Clause (E)) then
4760 ("cannot export entity& that has an address clause", Arg);
4763 Set_Is_Exported (E);
4765 -- Generate a reference for entity explicitly, because the
4766 -- identifier may be overloaded and name resolution will not
4769 Generate_Reference (E, Arg);
4771 -- Deal with exporting non-library level entity
4773 if not Is_Library_Level_Entity (E) then
4775 -- Not allowed at all for subprograms
4777 if Is_Subprogram (E) then
4778 Error_Pragma_Arg ("local subprogram& cannot be exported", Arg);
4780 -- Otherwise set public and statically allocated
4784 Set_Is_Statically_Allocated (E);
4786 -- Warn if the corresponding W flag is set and the pragma comes
4787 -- from source. The latter may not be true e.g. on VMS where we
4788 -- expand export pragmas for exception codes associated with
4789 -- imported or exported exceptions. We do not want to generate
4790 -- a warning for something that the user did not write.
4792 if Warn_On_Export_Import
4793 and then Comes_From_Source (Arg)
4796 ("?& has been made static as a result of Export", Arg, E);
4798 ("\this usage is non-standard and non-portable", Arg);
4803 if Warn_On_Export_Import and then Is_Type (E) then
4804 Error_Msg_NE ("exporting a type has no effect?", Arg, E);
4807 if Warn_On_Export_Import and Inside_A_Generic then
4809 ("all instances of& will have the same external name?", Arg, E);
4813 ----------------------------------------------
4814 -- Set_Extended_Import_Export_External_Name --
4815 ----------------------------------------------
4817 procedure Set_Extended_Import_Export_External_Name
4818 (Internal_Ent : Entity_Id;
4819 Arg_External : Node_Id)
4821 Old_Name : constant Node_Id := Interface_Name (Internal_Ent);
4825 if No (Arg_External) then
4829 Check_Arg_Is_External_Name (Arg_External);
4831 if Nkind (Arg_External) = N_String_Literal then
4832 if String_Length (Strval (Arg_External)) = 0 then
4835 New_Name := Adjust_External_Name_Case (Arg_External);
4838 elsif Nkind (Arg_External) = N_Identifier then
4839 New_Name := Get_Default_External_Name (Arg_External);
4841 -- Check_Arg_Is_External_Name should let through only identifiers and
4842 -- string literals or static string expressions (which are folded to
4843 -- string literals).
4846 raise Program_Error;
4849 -- If we already have an external name set (by a prior normal Import
4850 -- or Export pragma), then the external names must match
4852 if Present (Interface_Name (Internal_Ent)) then
4853 Check_Matching_Internal_Names : declare
4854 S1 : constant String_Id := Strval (Old_Name);
4855 S2 : constant String_Id := Strval (New_Name);
4858 -- Called if names do not match
4864 procedure Mismatch is
4866 Error_Msg_Sloc := Sloc (Old_Name);
4868 ("external name does not match that given #",
4872 -- Start of processing for Check_Matching_Internal_Names
4875 if String_Length (S1) /= String_Length (S2) then
4879 for J in 1 .. String_Length (S1) loop
4880 if Get_String_Char (S1, J) /= Get_String_Char (S2, J) then
4885 end Check_Matching_Internal_Names;
4887 -- Otherwise set the given name
4890 Set_Encoded_Interface_Name (Internal_Ent, New_Name);
4891 Check_Duplicated_Export_Name (New_Name);
4893 end Set_Extended_Import_Export_External_Name;
4899 procedure Set_Imported (E : Entity_Id) is
4901 -- Error message if already imported or exported
4903 if Is_Exported (E) or else Is_Imported (E) then
4905 -- Error if being set Exported twice
4907 if Is_Exported (E) then
4908 Error_Msg_NE ("entity& was previously exported", N, E);
4910 -- OK if Import/Interface case
4912 elsif Import_Interface_Present (N) then
4915 -- Error if being set Imported twice
4918 Error_Msg_NE ("entity& was previously imported", N, E);
4921 Error_Msg_Name_1 := Pname;
4923 ("\(pragma% applies to all previous entities)", N);
4925 Error_Msg_Sloc := Sloc (E);
4926 Error_Msg_NE ("\import not allowed for& declared#", N, E);
4928 -- Here if not previously imported or exported, OK to import
4931 Set_Is_Imported (E);
4933 -- If the entity is an object that is not at the library level,
4934 -- then it is statically allocated. We do not worry about objects
4935 -- with address clauses in this context since they are not really
4936 -- imported in the linker sense.
4939 and then not Is_Library_Level_Entity (E)
4940 and then No (Address_Clause (E))
4942 Set_Is_Statically_Allocated (E);
4949 -------------------------
4950 -- Set_Mechanism_Value --
4951 -------------------------
4953 -- Note: the mechanism name has not been analyzed (and cannot indeed be
4954 -- analyzed, since it is semantic nonsense), so we get it in the exact
4955 -- form created by the parser.
4957 procedure Set_Mechanism_Value (Ent : Entity_Id; Mech_Name : Node_Id) is
4960 Mech_Name_Id : Name_Id;
4962 procedure Bad_Class;
4963 -- Signal bad descriptor class name
4965 procedure Bad_Mechanism;
4966 -- Signal bad mechanism name
4972 procedure Bad_Class is
4974 Error_Pragma_Arg ("unrecognized descriptor class name", Class);
4977 -------------------------
4978 -- Bad_Mechanism_Value --
4979 -------------------------
4981 procedure Bad_Mechanism is
4983 Error_Pragma_Arg ("unrecognized mechanism name", Mech_Name);
4986 -- Start of processing for Set_Mechanism_Value
4989 if Mechanism (Ent) /= Default_Mechanism then
4991 ("mechanism for & has already been set", Mech_Name, Ent);
4994 -- MECHANISM_NAME ::= value | reference | descriptor |
4997 if Nkind (Mech_Name) = N_Identifier then
4998 if Chars (Mech_Name) = Name_Value then
4999 Set_Mechanism (Ent, By_Copy);
5002 elsif Chars (Mech_Name) = Name_Reference then
5003 Set_Mechanism (Ent, By_Reference);
5006 elsif Chars (Mech_Name) = Name_Descriptor then
5007 Check_VMS (Mech_Name);
5009 -- Descriptor => Short_Descriptor if pragma was given
5011 if Short_Descriptors then
5012 Set_Mechanism (Ent, By_Short_Descriptor);
5014 Set_Mechanism (Ent, By_Descriptor);
5019 elsif Chars (Mech_Name) = Name_Short_Descriptor then
5020 Check_VMS (Mech_Name);
5021 Set_Mechanism (Ent, By_Short_Descriptor);
5024 elsif Chars (Mech_Name) = Name_Copy then
5026 ("bad mechanism name, Value assumed", Mech_Name);
5032 -- MECHANISM_NAME ::= descriptor (CLASS_NAME) |
5033 -- short_descriptor (CLASS_NAME)
5034 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
5036 -- Note: this form is parsed as an indexed component
5038 elsif Nkind (Mech_Name) = N_Indexed_Component then
5039 Class := First (Expressions (Mech_Name));
5041 if Nkind (Prefix (Mech_Name)) /= N_Identifier
5042 or else not (Chars (Prefix (Mech_Name)) = Name_Descriptor or else
5043 Chars (Prefix (Mech_Name)) = Name_Short_Descriptor)
5044 or else Present (Next (Class))
5048 Mech_Name_Id := Chars (Prefix (Mech_Name));
5050 -- Change Descriptor => Short_Descriptor if pragma was given
5052 if Mech_Name_Id = Name_Descriptor
5053 and then Short_Descriptors
5055 Mech_Name_Id := Name_Short_Descriptor;
5059 -- MECHANISM_NAME ::= descriptor (Class => CLASS_NAME) |
5060 -- short_descriptor (Class => CLASS_NAME)
5061 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
5063 -- Note: this form is parsed as a function call
5065 elsif Nkind (Mech_Name) = N_Function_Call then
5066 Param := First (Parameter_Associations (Mech_Name));
5068 if Nkind (Name (Mech_Name)) /= N_Identifier
5069 or else not (Chars (Name (Mech_Name)) = Name_Descriptor or else
5070 Chars (Name (Mech_Name)) = Name_Short_Descriptor)
5071 or else Present (Next (Param))
5072 or else No (Selector_Name (Param))
5073 or else Chars (Selector_Name (Param)) /= Name_Class
5077 Class := Explicit_Actual_Parameter (Param);
5078 Mech_Name_Id := Chars (Name (Mech_Name));
5085 -- Fall through here with Class set to descriptor class name
5087 Check_VMS (Mech_Name);
5089 if Nkind (Class) /= N_Identifier then
5092 elsif Mech_Name_Id = Name_Descriptor
5093 and then Chars (Class) = Name_UBS
5095 Set_Mechanism (Ent, By_Descriptor_UBS);
5097 elsif Mech_Name_Id = Name_Descriptor
5098 and then Chars (Class) = Name_UBSB
5100 Set_Mechanism (Ent, By_Descriptor_UBSB);
5102 elsif Mech_Name_Id = Name_Descriptor
5103 and then Chars (Class) = Name_UBA
5105 Set_Mechanism (Ent, By_Descriptor_UBA);
5107 elsif Mech_Name_Id = Name_Descriptor
5108 and then Chars (Class) = Name_S
5110 Set_Mechanism (Ent, By_Descriptor_S);
5112 elsif Mech_Name_Id = Name_Descriptor
5113 and then Chars (Class) = Name_SB
5115 Set_Mechanism (Ent, By_Descriptor_SB);
5117 elsif Mech_Name_Id = Name_Descriptor
5118 and then Chars (Class) = Name_A
5120 Set_Mechanism (Ent, By_Descriptor_A);
5122 elsif Mech_Name_Id = Name_Descriptor
5123 and then Chars (Class) = Name_NCA
5125 Set_Mechanism (Ent, By_Descriptor_NCA);
5127 elsif Mech_Name_Id = Name_Short_Descriptor
5128 and then Chars (Class) = Name_UBS
5130 Set_Mechanism (Ent, By_Short_Descriptor_UBS);
5132 elsif Mech_Name_Id = Name_Short_Descriptor
5133 and then Chars (Class) = Name_UBSB
5135 Set_Mechanism (Ent, By_Short_Descriptor_UBSB);
5137 elsif Mech_Name_Id = Name_Short_Descriptor
5138 and then Chars (Class) = Name_UBA
5140 Set_Mechanism (Ent, By_Short_Descriptor_UBA);
5142 elsif Mech_Name_Id = Name_Short_Descriptor
5143 and then Chars (Class) = Name_S
5145 Set_Mechanism (Ent, By_Short_Descriptor_S);
5147 elsif Mech_Name_Id = Name_Short_Descriptor
5148 and then Chars (Class) = Name_SB
5150 Set_Mechanism (Ent, By_Short_Descriptor_SB);
5152 elsif Mech_Name_Id = Name_Short_Descriptor
5153 and then Chars (Class) = Name_A
5155 Set_Mechanism (Ent, By_Short_Descriptor_A);
5157 elsif Mech_Name_Id = Name_Short_Descriptor
5158 and then Chars (Class) = Name_NCA
5160 Set_Mechanism (Ent, By_Short_Descriptor_NCA);
5165 end Set_Mechanism_Value;
5167 ---------------------------
5168 -- Set_Ravenscar_Profile --
5169 ---------------------------
5171 -- The tasks to be done here are
5173 -- Set required policies
5175 -- pragma Task_Dispatching_Policy (FIFO_Within_Priorities)
5176 -- pragma Locking_Policy (Ceiling_Locking)
5178 -- Set Detect_Blocking mode
5180 -- Set required restrictions (see System.Rident for detailed list)
5182 procedure Set_Ravenscar_Profile (N : Node_Id) is
5184 -- pragma Task_Dispatching_Policy (FIFO_Within_Priorities)
5186 if Task_Dispatching_Policy /= ' '
5187 and then Task_Dispatching_Policy /= 'F'
5189 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
5190 Error_Pragma ("Profile (Ravenscar) incompatible with policy#");
5192 -- Set the FIFO_Within_Priorities policy, but always preserve
5193 -- System_Location since we like the error message with the run time
5197 Task_Dispatching_Policy := 'F';
5199 if Task_Dispatching_Policy_Sloc /= System_Location then
5200 Task_Dispatching_Policy_Sloc := Loc;
5204 -- pragma Locking_Policy (Ceiling_Locking)
5206 if Locking_Policy /= ' '
5207 and then Locking_Policy /= 'C'
5209 Error_Msg_Sloc := Locking_Policy_Sloc;
5210 Error_Pragma ("Profile (Ravenscar) incompatible with policy#");
5212 -- Set the Ceiling_Locking policy, but preserve System_Location since
5213 -- we like the error message with the run time name.
5216 Locking_Policy := 'C';
5218 if Locking_Policy_Sloc /= System_Location then
5219 Locking_Policy_Sloc := Loc;
5223 -- pragma Detect_Blocking
5225 Detect_Blocking := True;
5227 -- Set the corresponding restrictions
5229 Set_Profile_Restrictions
5230 (Ravenscar, N, Warn => Treat_Restrictions_As_Warnings);
5231 end Set_Ravenscar_Profile;
5233 -- Start of processing for Analyze_Pragma
5236 -- Deal with unrecognized pragma
5238 if not Is_Pragma_Name (Pname) then
5239 if Warn_On_Unrecognized_Pragma then
5240 Error_Msg_Name_1 := Pname;
5241 Error_Msg_N ("?unrecognized pragma%!", Pragma_Identifier (N));
5243 for PN in First_Pragma_Name .. Last_Pragma_Name loop
5244 if Is_Bad_Spelling_Of (Pname, PN) then
5245 Error_Msg_Name_1 := PN;
5246 Error_Msg_N -- CODEFIX
5247 ("\?possible misspelling of %!", Pragma_Identifier (N));
5256 -- Here to start processing for recognized pragma
5258 Prag_Id := Get_Pragma_Id (Pname);
5267 if Present (Pragma_Argument_Associations (N)) then
5268 Arg1 := First (Pragma_Argument_Associations (N));
5270 if Present (Arg1) then
5271 Arg2 := Next (Arg1);
5273 if Present (Arg2) then
5274 Arg3 := Next (Arg2);
5276 if Present (Arg3) then
5277 Arg4 := Next (Arg3);
5283 -- Count number of arguments
5290 while Present (Arg_Node) loop
5291 Arg_Count := Arg_Count + 1;
5296 -- An enumeration type defines the pragmas that are supported by the
5297 -- implementation. Get_Pragma_Id (in package Prag) transforms a name
5298 -- into the corresponding enumeration value for the following case.
5306 -- pragma Abort_Defer;
5308 when Pragma_Abort_Defer =>
5310 Check_Arg_Count (0);
5312 -- The only required semantic processing is to check the
5313 -- placement. This pragma must appear at the start of the
5314 -- statement sequence of a handled sequence of statements.
5316 if Nkind (Parent (N)) /= N_Handled_Sequence_Of_Statements
5317 or else N /= First (Statements (Parent (N)))
5328 -- Note: this pragma also has some specific processing in Par.Prag
5329 -- because we want to set the Ada version mode during parsing.
5331 when Pragma_Ada_83 =>
5333 Check_Arg_Count (0);
5335 -- We really should check unconditionally for proper configuration
5336 -- pragma placement, since we really don't want mixed Ada modes
5337 -- within a single unit, and the GNAT reference manual has always
5338 -- said this was a configuration pragma, but we did not check and
5339 -- are hesitant to add the check now.
5341 -- However, we really cannot tolerate mixing Ada 2005 or Ada 2012
5342 -- with Ada 83 or Ada 95, so we must check if we are in Ada 2005
5343 -- or Ada 2012 mode.
5345 if Ada_Version >= Ada_05 then
5346 Check_Valid_Configuration_Pragma;
5349 -- Now set Ada 83 mode
5351 Ada_Version := Ada_83;
5352 Ada_Version_Explicit := Ada_Version;
5360 -- Note: this pragma also has some specific processing in Par.Prag
5361 -- because we want to set the Ada 83 version mode during parsing.
5363 when Pragma_Ada_95 =>
5365 Check_Arg_Count (0);
5367 -- We really should check unconditionally for proper configuration
5368 -- pragma placement, since we really don't want mixed Ada modes
5369 -- within a single unit, and the GNAT reference manual has always
5370 -- said this was a configuration pragma, but we did not check and
5371 -- are hesitant to add the check now.
5373 -- However, we really cannot tolerate mixing Ada 2005 with Ada 83
5374 -- or Ada 95, so we must check if we are in Ada 2005 mode.
5376 if Ada_Version >= Ada_05 then
5377 Check_Valid_Configuration_Pragma;
5380 -- Now set Ada 95 mode
5382 Ada_Version := Ada_95;
5383 Ada_Version_Explicit := Ada_Version;
5385 ---------------------
5386 -- Ada_05/Ada_2005 --
5387 ---------------------
5390 -- pragma Ada_05 (LOCAL_NAME);
5393 -- pragma Ada_2005 (LOCAL_NAME):
5395 -- Note: these pragmas also have some specific processing in Par.Prag
5396 -- because we want to set the Ada 2005 version mode during parsing.
5398 when Pragma_Ada_05 | Pragma_Ada_2005 => declare
5404 if Arg_Count = 1 then
5405 Check_Arg_Is_Local_Name (Arg1);
5406 E_Id := Expression (Arg1);
5408 if Etype (E_Id) = Any_Type then
5412 Set_Is_Ada_2005_Only (Entity (E_Id));
5415 Check_Arg_Count (0);
5417 -- For Ada_2005 we unconditionally enforce the documented
5418 -- configuration pragma placement, since we do not want to
5419 -- tolerate mixed modes in a unit involving Ada 2005. That
5420 -- would cause real difficulties for those cases where there
5421 -- are incompatibilities between Ada 95 and Ada 2005.
5423 Check_Valid_Configuration_Pragma;
5425 -- Now set Ada 2005 mode
5427 Ada_Version := Ada_05;
5428 Ada_Version_Explicit := Ada_05;
5432 ---------------------
5433 -- Ada_12/Ada_2012 --
5434 ---------------------
5437 -- pragma Ada_12 (LOCAL_NAME);
5440 -- pragma Ada_2012 (LOCAL_NAME):
5442 -- Note: these pragmas also have some specific processing in Par.Prag
5443 -- because we want to set the Ada 2012 version mode during parsing.
5445 when Pragma_Ada_12 | Pragma_Ada_2012 => declare
5451 if Arg_Count = 1 then
5452 Check_Arg_Is_Local_Name (Arg1);
5453 E_Id := Expression (Arg1);
5455 if Etype (E_Id) = Any_Type then
5459 Set_Is_Ada_2012_Only (Entity (E_Id));
5462 Check_Arg_Count (0);
5464 -- For Ada_2012 we unconditionally enforce the documented
5465 -- configuration pragma placement, since we do not want to
5466 -- tolerate mixed modes in a unit involving Ada 2012. That
5467 -- would cause real difficulties for those cases where there
5468 -- are incompatibilities between Ada 95 and Ada 2012. We could
5469 -- allow mixing of Ada 2005 and Ada 2012 but it's not worth it.
5471 Check_Valid_Configuration_Pragma;
5473 -- Now set Ada 2012 mode
5475 Ada_Version := Ada_12;
5476 Ada_Version_Explicit := Ada_12;
5480 ----------------------
5481 -- All_Calls_Remote --
5482 ----------------------
5484 -- pragma All_Calls_Remote [(library_package_NAME)];
5486 when Pragma_All_Calls_Remote => All_Calls_Remote : declare
5487 Lib_Entity : Entity_Id;
5490 Check_Ada_83_Warning;
5491 Check_Valid_Library_Unit_Pragma;
5493 if Nkind (N) = N_Null_Statement then
5497 Lib_Entity := Find_Lib_Unit_Name;
5499 -- This pragma should only apply to a RCI unit (RM E.2.3(23))
5501 if Present (Lib_Entity)
5502 and then not Debug_Flag_U
5504 if not Is_Remote_Call_Interface (Lib_Entity) then
5505 Error_Pragma ("pragma% only apply to rci unit");
5507 -- Set flag for entity of the library unit
5510 Set_Has_All_Calls_Remote (Lib_Entity);
5514 end All_Calls_Remote;
5520 -- pragma Annotate (IDENTIFIER [, IDENTIFIER {, ARG}]);
5521 -- ARG ::= NAME | EXPRESSION
5523 -- The first two arguments are by convention intended to refer to an
5524 -- external tool and a tool-specific function. These arguments are
5527 when Pragma_Annotate => Annotate : begin
5529 Check_At_Least_N_Arguments (1);
5530 Check_Arg_Is_Identifier (Arg1);
5531 Check_No_Identifiers;
5539 -- Second unanalyzed parameter is optional
5545 while Present (Arg) loop
5546 Exp := Expression (Arg);
5549 if Is_Entity_Name (Exp) then
5552 -- For string literals, we assume Standard_String as the
5553 -- type, unless the string contains wide or wide_wide
5556 elsif Nkind (Exp) = N_String_Literal then
5557 if Has_Wide_Wide_Character (Exp) then
5558 Resolve (Exp, Standard_Wide_Wide_String);
5559 elsif Has_Wide_Character (Exp) then
5560 Resolve (Exp, Standard_Wide_String);
5562 Resolve (Exp, Standard_String);
5565 elsif Is_Overloaded (Exp) then
5567 ("ambiguous argument for pragma%", Exp);
5583 -- pragma Assert ([Check =>] Boolean_EXPRESSION
5584 -- [, [Message =>] Static_String_EXPRESSION]);
5586 when Pragma_Assert => Assert : declare
5592 Check_At_Least_N_Arguments (1);
5593 Check_At_Most_N_Arguments (2);
5594 Check_Arg_Order ((Name_Check, Name_Message));
5595 Check_Optional_Identifier (Arg1, Name_Check);
5597 -- We treat pragma Assert as equivalent to:
5599 -- pragma Check (Assertion, condition [, msg]);
5601 -- So rewrite pragma in this manner, and analyze the result
5603 Expr := Get_Pragma_Arg (Arg1);
5605 Make_Pragma_Argument_Association (Loc,
5607 Make_Identifier (Loc,
5608 Chars => Name_Assertion)),
5610 Make_Pragma_Argument_Association (Sloc (Expr),
5611 Expression => Expr));
5613 if Arg_Count > 1 then
5614 Check_Optional_Identifier (Arg2, Name_Message);
5615 Analyze_And_Resolve (Get_Pragma_Arg (Arg2), Standard_String);
5616 Append_To (Newa, Relocate_Node (Arg2));
5621 Chars => Name_Check,
5622 Pragma_Argument_Associations => Newa));
5626 ----------------------
5627 -- Assertion_Policy --
5628 ----------------------
5630 -- pragma Assertion_Policy (Check | Ignore)
5632 when Pragma_Assertion_Policy => Assertion_Policy : declare
5637 Check_Valid_Configuration_Pragma;
5638 Check_Arg_Count (1);
5639 Check_No_Identifiers;
5640 Check_Arg_Is_One_Of (Arg1, Name_Check, Name_Ignore);
5642 -- We treat pragma Assertion_Policy as equivalent to:
5644 -- pragma Check_Policy (Assertion, policy)
5646 -- So rewrite the pragma in that manner and link on to the chain
5647 -- of Check_Policy pragmas, marking the pragma as analyzed.
5649 Policy := Get_Pragma_Arg (Arg1);
5653 Chars => Name_Check_Policy,
5655 Pragma_Argument_Associations => New_List (
5656 Make_Pragma_Argument_Association (Loc,
5658 Make_Identifier (Loc,
5659 Chars => Name_Assertion)),
5661 Make_Pragma_Argument_Association (Loc,
5663 Make_Identifier (Sloc (Policy),
5664 Chars => Chars (Policy))))));
5667 Set_Next_Pragma (N, Opt.Check_Policy_List);
5668 Opt.Check_Policy_List := N;
5669 end Assertion_Policy;
5671 ------------------------------
5672 -- Assume_No_Invalid_Values --
5673 ------------------------------
5675 -- pragma Assume_No_Invalid_Values (On | Off);
5677 when Pragma_Assume_No_Invalid_Values =>
5679 Check_Valid_Configuration_Pragma;
5680 Check_Arg_Count (1);
5681 Check_No_Identifiers;
5682 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
5684 if Chars (Expression (Arg1)) = Name_On then
5685 Assume_No_Invalid_Values := True;
5687 Assume_No_Invalid_Values := False;
5694 -- pragma AST_Entry (entry_IDENTIFIER);
5696 when Pragma_AST_Entry => AST_Entry : declare
5702 Check_Arg_Count (1);
5703 Check_No_Identifiers;
5704 Check_Arg_Is_Local_Name (Arg1);
5705 Ent := Entity (Expression (Arg1));
5707 -- Note: the implementation of the AST_Entry pragma could handle
5708 -- the entry family case fine, but for now we are consistent with
5709 -- the DEC rules, and do not allow the pragma, which of course
5710 -- has the effect of also forbidding the attribute.
5712 if Ekind (Ent) /= E_Entry then
5714 ("pragma% argument must be simple entry name", Arg1);
5716 elsif Is_AST_Entry (Ent) then
5718 ("duplicate % pragma for entry", Arg1);
5720 elsif Has_Homonym (Ent) then
5722 ("pragma% argument cannot specify overloaded entry", Arg1);
5726 FF : constant Entity_Id := First_Formal (Ent);
5729 if Present (FF) then
5730 if Present (Next_Formal (FF)) then
5732 ("entry for pragma% can have only one argument",
5735 elsif Parameter_Mode (FF) /= E_In_Parameter then
5737 ("entry parameter for pragma% must have mode IN",
5743 Set_Is_AST_Entry (Ent);
5751 -- pragma Asynchronous (LOCAL_NAME);
5753 when Pragma_Asynchronous => Asynchronous : declare
5761 procedure Process_Async_Pragma;
5762 -- Common processing for procedure and access-to-procedure case
5764 --------------------------
5765 -- Process_Async_Pragma --
5766 --------------------------
5768 procedure Process_Async_Pragma is
5771 Set_Is_Asynchronous (Nm);
5775 -- The formals should be of mode IN (RM E.4.1(6))
5778 while Present (S) loop
5779 Formal := Defining_Identifier (S);
5781 if Nkind (Formal) = N_Defining_Identifier
5782 and then Ekind (Formal) /= E_In_Parameter
5785 ("pragma% procedure can only have IN parameter",
5792 Set_Is_Asynchronous (Nm);
5793 end Process_Async_Pragma;
5795 -- Start of processing for pragma Asynchronous
5798 Check_Ada_83_Warning;
5799 Check_No_Identifiers;
5800 Check_Arg_Count (1);
5801 Check_Arg_Is_Local_Name (Arg1);
5803 if Debug_Flag_U then
5807 C_Ent := Cunit_Entity (Current_Sem_Unit);
5808 Analyze (Expression (Arg1));
5809 Nm := Entity (Expression (Arg1));
5811 if not Is_Remote_Call_Interface (C_Ent)
5812 and then not Is_Remote_Types (C_Ent)
5814 -- This pragma should only appear in an RCI or Remote Types
5815 -- unit (RM E.4.1(4)).
5818 ("pragma% not in Remote_Call_Interface or " &
5819 "Remote_Types unit");
5822 if Ekind (Nm) = E_Procedure
5823 and then Nkind (Parent (Nm)) = N_Procedure_Specification
5825 if not Is_Remote_Call_Interface (Nm) then
5827 ("pragma% cannot be applied on non-remote procedure",
5831 L := Parameter_Specifications (Parent (Nm));
5832 Process_Async_Pragma;
5835 elsif Ekind (Nm) = E_Function then
5837 ("pragma% cannot be applied to function", Arg1);
5839 elsif Is_Remote_Access_To_Subprogram_Type (Nm) then
5841 if Is_Record_Type (Nm) then
5843 -- A record type that is the Equivalent_Type for a remote
5844 -- access-to-subprogram type.
5846 N := Declaration_Node (Corresponding_Remote_Type (Nm));
5849 -- A non-expanded RAS type (distribution is not enabled)
5851 N := Declaration_Node (Nm);
5854 if Nkind (N) = N_Full_Type_Declaration
5855 and then Nkind (Type_Definition (N)) =
5856 N_Access_Procedure_Definition
5858 L := Parameter_Specifications (Type_Definition (N));
5859 Process_Async_Pragma;
5861 if Is_Asynchronous (Nm)
5862 and then Expander_Active
5863 and then Get_PCS_Name /= Name_No_DSA
5865 RACW_Type_Is_Asynchronous (Underlying_RACW_Type (Nm));
5870 ("pragma% cannot reference access-to-function type",
5874 -- Only other possibility is Access-to-class-wide type
5876 elsif Is_Access_Type (Nm)
5877 and then Is_Class_Wide_Type (Designated_Type (Nm))
5879 Check_First_Subtype (Arg1);
5880 Set_Is_Asynchronous (Nm);
5881 if Expander_Active then
5882 RACW_Type_Is_Asynchronous (Nm);
5886 Error_Pragma_Arg ("inappropriate argument for pragma%", Arg1);
5894 -- pragma Atomic (LOCAL_NAME);
5896 when Pragma_Atomic =>
5897 Process_Atomic_Shared_Volatile;
5899 -----------------------
5900 -- Atomic_Components --
5901 -----------------------
5903 -- pragma Atomic_Components (array_LOCAL_NAME);
5905 -- This processing is shared by Volatile_Components
5907 when Pragma_Atomic_Components |
5908 Pragma_Volatile_Components =>
5910 Atomic_Components : declare
5918 Check_Ada_83_Warning;
5919 Check_No_Identifiers;
5920 Check_Arg_Count (1);
5921 Check_Arg_Is_Local_Name (Arg1);
5922 E_Id := Expression (Arg1);
5924 if Etype (E_Id) = Any_Type then
5930 if Rep_Item_Too_Early (E, N)
5932 Rep_Item_Too_Late (E, N)
5937 D := Declaration_Node (E);
5940 if (K = N_Full_Type_Declaration and then Is_Array_Type (E))
5942 ((Ekind (E) = E_Constant or else Ekind (E) = E_Variable)
5943 and then Nkind (D) = N_Object_Declaration
5944 and then Nkind (Object_Definition (D)) =
5945 N_Constrained_Array_Definition)
5947 Ctyp := Component_Type (E);
5949 -- The flag is set on the object, or on the base type
5951 if Nkind (D) /= N_Object_Declaration then
5955 Set_Has_Volatile_Components (E);
5957 if Prag_Id = Pragma_Atomic_Components then
5958 Set_Has_Atomic_Components (E);
5960 if Is_Packed (E) then
5961 Set_Is_Packed (E, False);
5963 if not (Known_Static_Esize (Ctyp)
5964 and then Known_Static_RM_Size (Ctyp)
5965 and then Esize (Ctyp) = RM_Size (Ctyp))
5968 ("cannot pack atomic components", Arg1);
5974 Error_Pragma_Arg ("inappropriate entity for pragma%", Arg1);
5976 end Atomic_Components;
5978 --------------------
5979 -- Attach_Handler --
5980 --------------------
5982 -- pragma Attach_Handler (handler_NAME, EXPRESSION);
5984 when Pragma_Attach_Handler =>
5985 Check_Ada_83_Warning;
5986 Check_No_Identifiers;
5987 Check_Arg_Count (2);
5989 if No_Run_Time_Mode then
5990 Error_Msg_CRT ("Attach_Handler pragma", N);
5992 Check_Interrupt_Or_Attach_Handler;
5994 -- The expression that designates the attribute may
5995 -- depend on a discriminant, and is therefore a per-
5996 -- object expression, to be expanded in the init proc.
5997 -- If expansion is enabled, perform semantic checks
6000 if Expander_Active then
6002 Temp : constant Node_Id :=
6003 New_Copy_Tree (Expression (Arg2));
6005 Set_Parent (Temp, N);
6006 Preanalyze_And_Resolve (Temp, RTE (RE_Interrupt_ID));
6010 Analyze (Expression (Arg2));
6011 Resolve (Expression (Arg2), RTE (RE_Interrupt_ID));
6014 Process_Interrupt_Or_Attach_Handler;
6017 --------------------
6018 -- C_Pass_By_Copy --
6019 --------------------
6021 -- pragma C_Pass_By_Copy ([Max_Size =>] static_integer_EXPRESSION);
6023 when Pragma_C_Pass_By_Copy => C_Pass_By_Copy : declare
6029 Check_Valid_Configuration_Pragma;
6030 Check_Arg_Count (1);
6031 Check_Optional_Identifier (Arg1, "max_size");
6033 Arg := Expression (Arg1);
6034 Check_Arg_Is_Static_Expression (Arg, Any_Integer);
6036 Val := Expr_Value (Arg);
6040 ("maximum size for pragma% must be positive", Arg1);
6042 elsif UI_Is_In_Int_Range (Val) then
6043 Default_C_Record_Mechanism := UI_To_Int (Val);
6045 -- If a giant value is given, Int'Last will do well enough.
6046 -- If sometime someone complains that a record larger than
6047 -- two gigabytes is not copied, we will worry about it then!
6050 Default_C_Record_Mechanism := Mechanism_Type'Last;
6058 -- pragma Check ([Name =>] Identifier,
6059 -- [Check =>] Boolean_Expression
6060 -- [,[Message =>] String_Expression]);
6062 when Pragma_Check => Check : declare
6067 -- Set True if category of assertions referenced by Name enabled
6071 Check_At_Least_N_Arguments (2);
6072 Check_At_Most_N_Arguments (3);
6073 Check_Optional_Identifier (Arg1, Name_Name);
6074 Check_Optional_Identifier (Arg2, Name_Check);
6076 if Arg_Count = 3 then
6077 Check_Optional_Identifier (Arg3, Name_Message);
6078 Analyze_And_Resolve (Get_Pragma_Arg (Arg3), Standard_String);
6081 Check_Arg_Is_Identifier (Arg1);
6083 -- Indicate if pragma is enabled. The Original_Node reference here
6084 -- is to deal with pragma Assert rewritten as a Check pragma.
6086 Check_On := Check_Enabled (Chars (Get_Pragma_Arg (Arg1)));
6089 Set_Pragma_Enabled (N);
6090 Set_Pragma_Enabled (Original_Node (N));
6091 Set_SCO_Pragma_Enabled (Loc);
6094 -- If expansion is active and the check is not enabled then we
6095 -- rewrite the Check as:
6097 -- if False and then condition then
6101 -- The reason we do this rewriting during semantic analysis rather
6102 -- than as part of normal expansion is that we cannot analyze and
6103 -- expand the code for the boolean expression directly, or it may
6104 -- cause insertion of actions that would escape the attempt to
6105 -- suppress the check code.
6107 -- Note that the Sloc for the if statement corresponds to the
6108 -- argument condition, not the pragma itself. The reason for this
6109 -- is that we may generate a warning if the condition is False at
6110 -- compile time, and we do not want to delete this warning when we
6111 -- delete the if statement.
6113 Expr := Expression (Arg2);
6115 if Expander_Active and then not Check_On then
6116 Eloc := Sloc (Expr);
6119 Make_If_Statement (Eloc,
6121 Make_And_Then (Eloc,
6122 Left_Opnd => New_Occurrence_Of (Standard_False, Eloc),
6123 Right_Opnd => Expr),
6124 Then_Statements => New_List (
6125 Make_Null_Statement (Eloc))));
6132 Analyze_And_Resolve (Expr, Any_Boolean);
6140 -- pragma Check_Name (check_IDENTIFIER);
6142 when Pragma_Check_Name =>
6143 Check_No_Identifiers;
6145 Check_Valid_Configuration_Pragma;
6146 Check_Arg_Count (1);
6147 Check_Arg_Is_Identifier (Arg1);
6150 Nam : constant Name_Id := Chars (Expression (Arg1));
6153 for J in Check_Names.First .. Check_Names.Last loop
6154 if Check_Names.Table (J) = Nam then
6159 Check_Names.Append (Nam);
6166 -- pragma Check_Policy (
6167 -- [Name =>] IDENTIFIER,
6168 -- [Policy =>] POLICY_IDENTIFIER);
6170 -- POLICY_IDENTIFIER ::= ON | OFF | CHECK | IGNORE
6172 -- Note: this is a configuration pragma, but it is allowed to appear
6175 when Pragma_Check_Policy =>
6177 Check_Arg_Count (2);
6178 Check_Optional_Identifier (Arg1, Name_Name);
6179 Check_Optional_Identifier (Arg2, Name_Policy);
6181 (Arg2, Name_On, Name_Off, Name_Check, Name_Ignore);
6183 -- A Check_Policy pragma can appear either as a configuration
6184 -- pragma, or in a declarative part or a package spec (see RM
6185 -- 11.5(5) for rules for Suppress/Unsuppress which are also
6186 -- followed for Check_Policy).
6188 if not Is_Configuration_Pragma then
6189 Check_Is_In_Decl_Part_Or_Package_Spec;
6192 Set_Next_Pragma (N, Opt.Check_Policy_List);
6193 Opt.Check_Policy_List := N;
6195 ---------------------
6196 -- CIL_Constructor --
6197 ---------------------
6199 -- pragma CIL_Constructor ([Entity =>] LOCAL_NAME);
6201 -- Processing for this pragma is shared with Java_Constructor
6207 -- pragma Comment (static_string_EXPRESSION)
6209 -- Processing for pragma Comment shares the circuitry for pragma
6210 -- Ident. The only differences are that Ident enforces a limit of 31
6211 -- characters on its argument, and also enforces limitations on
6212 -- placement for DEC compatibility. Pragma Comment shares neither of
6213 -- these restrictions.
6219 -- pragma Common_Object (
6220 -- [Internal =>] LOCAL_NAME
6221 -- [, [External =>] EXTERNAL_SYMBOL]
6222 -- [, [Size =>] EXTERNAL_SYMBOL]);
6224 -- Processing for this pragma is shared with Psect_Object
6226 ------------------------
6227 -- Compile_Time_Error --
6228 ------------------------
6230 -- pragma Compile_Time_Error
6231 -- (boolean_EXPRESSION, static_string_EXPRESSION);
6233 when Pragma_Compile_Time_Error =>
6235 Process_Compile_Time_Warning_Or_Error;
6237 --------------------------
6238 -- Compile_Time_Warning --
6239 --------------------------
6241 -- pragma Compile_Time_Warning
6242 -- (boolean_EXPRESSION, static_string_EXPRESSION);
6244 when Pragma_Compile_Time_Warning =>
6246 Process_Compile_Time_Warning_Or_Error;
6252 when Pragma_Compiler_Unit =>
6254 Check_Arg_Count (0);
6255 Set_Is_Compiler_Unit (Get_Source_Unit (N));
6257 -----------------------------
6258 -- Complete_Representation --
6259 -----------------------------
6261 -- pragma Complete_Representation;
6263 when Pragma_Complete_Representation =>
6265 Check_Arg_Count (0);
6267 if Nkind (Parent (N)) /= N_Record_Representation_Clause then
6269 ("pragma & must appear within record representation clause");
6272 ----------------------------
6273 -- Complex_Representation --
6274 ----------------------------
6276 -- pragma Complex_Representation ([Entity =>] LOCAL_NAME);
6278 when Pragma_Complex_Representation => Complex_Representation : declare
6285 Check_Arg_Count (1);
6286 Check_Optional_Identifier (Arg1, Name_Entity);
6287 Check_Arg_Is_Local_Name (Arg1);
6288 E_Id := Expression (Arg1);
6290 if Etype (E_Id) = Any_Type then
6296 if not Is_Record_Type (E) then
6298 ("argument for pragma% must be record type", Arg1);
6301 Ent := First_Entity (E);
6304 or else No (Next_Entity (Ent))
6305 or else Present (Next_Entity (Next_Entity (Ent)))
6306 or else not Is_Floating_Point_Type (Etype (Ent))
6307 or else Etype (Ent) /= Etype (Next_Entity (Ent))
6310 ("record for pragma% must have two fields of the same "
6311 & "floating-point type", Arg1);
6314 Set_Has_Complex_Representation (Base_Type (E));
6316 -- We need to treat the type has having a non-standard
6317 -- representation, for back-end purposes, even though in
6318 -- general a complex will have the default representation
6319 -- of a record with two real components.
6321 Set_Has_Non_Standard_Rep (Base_Type (E));
6323 end Complex_Representation;
6325 -------------------------
6326 -- Component_Alignment --
6327 -------------------------
6329 -- pragma Component_Alignment (
6330 -- [Form =>] ALIGNMENT_CHOICE
6331 -- [, [Name =>] type_LOCAL_NAME]);
6333 -- ALIGNMENT_CHOICE ::=
6335 -- | Component_Size_4
6339 when Pragma_Component_Alignment => Component_AlignmentP : declare
6340 Args : Args_List (1 .. 2);
6341 Names : constant Name_List (1 .. 2) := (
6345 Form : Node_Id renames Args (1);
6346 Name : Node_Id renames Args (2);
6348 Atype : Component_Alignment_Kind;
6353 Gather_Associations (Names, Args);
6356 Error_Pragma ("missing Form argument for pragma%");
6359 Check_Arg_Is_Identifier (Form);
6361 -- Get proper alignment, note that Default = Component_Size on all
6362 -- machines we have so far, and we want to set this value rather
6363 -- than the default value to indicate that it has been explicitly
6364 -- set (and thus will not get overridden by the default component
6365 -- alignment for the current scope)
6367 if Chars (Form) = Name_Component_Size then
6368 Atype := Calign_Component_Size;
6370 elsif Chars (Form) = Name_Component_Size_4 then
6371 Atype := Calign_Component_Size_4;
6373 elsif Chars (Form) = Name_Default then
6374 Atype := Calign_Component_Size;
6376 elsif Chars (Form) = Name_Storage_Unit then
6377 Atype := Calign_Storage_Unit;
6381 ("invalid Form parameter for pragma%", Form);
6384 -- Case with no name, supplied, affects scope table entry
6388 (Scope_Stack.Last).Component_Alignment_Default := Atype;
6390 -- Case of name supplied
6393 Check_Arg_Is_Local_Name (Name);
6395 Typ := Entity (Name);
6398 or else Rep_Item_Too_Early (Typ, N)
6402 Typ := Underlying_Type (Typ);
6405 if not Is_Record_Type (Typ)
6406 and then not Is_Array_Type (Typ)
6409 ("Name parameter of pragma% must identify record or " &
6410 "array type", Name);
6413 -- An explicit Component_Alignment pragma overrides an
6414 -- implicit pragma Pack, but not an explicit one.
6416 if not Has_Pragma_Pack (Base_Type (Typ)) then
6417 Set_Is_Packed (Base_Type (Typ), False);
6418 Set_Component_Alignment (Base_Type (Typ), Atype);
6421 end Component_AlignmentP;
6427 -- pragma Controlled (first_subtype_LOCAL_NAME);
6429 when Pragma_Controlled => Controlled : declare
6433 Check_No_Identifiers;
6434 Check_Arg_Count (1);
6435 Check_Arg_Is_Local_Name (Arg1);
6436 Arg := Expression (Arg1);
6438 if not Is_Entity_Name (Arg)
6439 or else not Is_Access_Type (Entity (Arg))
6441 Error_Pragma_Arg ("pragma% requires access type", Arg1);
6443 Set_Has_Pragma_Controlled (Base_Type (Entity (Arg)));
6451 -- pragma Convention ([Convention =>] convention_IDENTIFIER,
6452 -- [Entity =>] LOCAL_NAME);
6454 when Pragma_Convention => Convention : declare
6457 pragma Warnings (Off, C);
6458 pragma Warnings (Off, E);
6460 Check_Arg_Order ((Name_Convention, Name_Entity));
6461 Check_Ada_83_Warning;
6462 Check_Arg_Count (2);
6463 Process_Convention (C, E);
6466 ---------------------------
6467 -- Convention_Identifier --
6468 ---------------------------
6470 -- pragma Convention_Identifier ([Name =>] IDENTIFIER,
6471 -- [Convention =>] convention_IDENTIFIER);
6473 when Pragma_Convention_Identifier => Convention_Identifier : declare
6479 Check_Arg_Order ((Name_Name, Name_Convention));
6480 Check_Arg_Count (2);
6481 Check_Optional_Identifier (Arg1, Name_Name);
6482 Check_Optional_Identifier (Arg2, Name_Convention);
6483 Check_Arg_Is_Identifier (Arg1);
6484 Check_Arg_Is_Identifier (Arg2);
6485 Idnam := Chars (Expression (Arg1));
6486 Cname := Chars (Expression (Arg2));
6488 if Is_Convention_Name (Cname) then
6489 Record_Convention_Identifier
6490 (Idnam, Get_Convention_Id (Cname));
6493 ("second arg for % pragma must be convention", Arg2);
6495 end Convention_Identifier;
6501 -- pragma CPP_Class ([Entity =>] local_NAME)
6503 when Pragma_CPP_Class => CPP_Class : declare
6508 if Warn_On_Obsolescent_Feature then
6510 ("'G'N'A'T pragma cpp'_class is now obsolete; replace it" &
6511 " by pragma import?", N);
6515 Check_Arg_Count (1);
6516 Check_Optional_Identifier (Arg1, Name_Entity);
6517 Check_Arg_Is_Local_Name (Arg1);
6519 Arg := Expression (Arg1);
6522 if Etype (Arg) = Any_Type then
6526 if not Is_Entity_Name (Arg)
6527 or else not Is_Type (Entity (Arg))
6529 Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
6532 Typ := Entity (Arg);
6534 if not Is_Tagged_Type (Typ) then
6535 Error_Pragma_Arg ("pragma% applicable to tagged types ", Arg1);
6538 -- Types treated as CPP classes are treated as limited, but we
6539 -- don't require them to be declared this way. A warning is issued
6540 -- to encourage the user to declare them as limited. This is not
6541 -- an error, for compatibility reasons, because these types have
6542 -- been supported this way for some time.
6544 if not Is_Limited_Type (Typ) then
6546 ("imported 'C'P'P type should be " &
6547 "explicitly declared limited?",
6548 Get_Pragma_Arg (Arg1));
6550 ("\type will be considered limited",
6551 Get_Pragma_Arg (Arg1));
6554 Set_Is_CPP_Class (Typ);
6555 Set_Is_Limited_Record (Typ);
6556 Set_Convention (Typ, Convention_CPP);
6558 -- Imported CPP types must not have discriminants (because C++
6559 -- classes do not have discriminants).
6561 if Has_Discriminants (Typ) then
6563 ("imported 'C'P'P type cannot have discriminants",
6564 First (Discriminant_Specifications
6565 (Declaration_Node (Typ))));
6568 -- Components of imported CPP types must not have default
6569 -- expressions because the constructor (if any) is in the
6572 if Is_Incomplete_Or_Private_Type (Typ)
6573 and then No (Underlying_Type (Typ))
6575 -- It should be an error to apply pragma CPP to a private
6576 -- type if the underlying type is not visible (as it is
6577 -- for any representation item). For now, for backward
6578 -- compatibility we do nothing but we cannot check components
6579 -- because they are not available at this stage. All this code
6580 -- will be removed when we cleanup this obsolete GNAT pragma???
6586 Tdef : constant Node_Id :=
6587 Type_Definition (Declaration_Node (Typ));
6592 if Nkind (Tdef) = N_Record_Definition then
6593 Clist := Component_List (Tdef);
6595 pragma Assert (Nkind (Tdef) = N_Derived_Type_Definition);
6596 Clist := Component_List (Record_Extension_Part (Tdef));
6599 if Present (Clist) then
6600 Comp := First (Component_Items (Clist));
6601 while Present (Comp) loop
6602 if Present (Expression (Comp)) then
6604 ("component of imported 'C'P'P type cannot have" &
6605 " default expression", Expression (Comp));
6615 ---------------------
6616 -- CPP_Constructor --
6617 ---------------------
6619 -- pragma CPP_Constructor ([Entity =>] LOCAL_NAME
6620 -- [, [External_Name =>] static_string_EXPRESSION ]
6621 -- [, [Link_Name =>] static_string_EXPRESSION ]);
6623 when Pragma_CPP_Constructor => CPP_Constructor : declare
6627 Tag_Typ : Entity_Id;
6631 Check_At_Least_N_Arguments (1);
6632 Check_At_Most_N_Arguments (3);
6633 Check_Optional_Identifier (Arg1, Name_Entity);
6634 Check_Arg_Is_Local_Name (Arg1);
6636 Id := Expression (Arg1);
6637 Find_Program_Unit_Name (Id);
6639 -- If we did not find the name, we are done
6641 if Etype (Id) = Any_Type then
6645 Def_Id := Entity (Id);
6647 -- Check if already defined as constructor
6649 if Is_Constructor (Def_Id) then
6651 ("?duplicate argument for pragma 'C'P'P_Constructor", Arg1);
6655 if Ekind (Def_Id) = E_Function
6656 and then (Is_CPP_Class (Etype (Def_Id))
6657 or else (Is_Class_Wide_Type (Etype (Def_Id))
6659 Is_CPP_Class (Root_Type (Etype (Def_Id)))))
6661 if Arg_Count >= 2 then
6662 Set_Imported (Def_Id);
6663 Set_Is_Public (Def_Id);
6664 Process_Interface_Name (Def_Id, Arg2, Arg3);
6667 Set_Has_Completion (Def_Id);
6668 Set_Is_Constructor (Def_Id);
6670 -- Imported C++ constructors are not dispatching primitives
6671 -- because in C++ they don't have a dispatch table slot.
6672 -- However, in Ada the constructor has the profile of a
6673 -- function that returns a tagged type and therefore it has
6674 -- been treated as a primitive operation during semantic
6675 -- analysis. We now remove it from the list of primitive
6676 -- operations of the type.
6678 if Is_Tagged_Type (Etype (Def_Id))
6679 and then not Is_Class_Wide_Type (Etype (Def_Id))
6681 pragma Assert (Is_Dispatching_Operation (Def_Id));
6682 Tag_Typ := Etype (Def_Id);
6684 Elmt := First_Elmt (Primitive_Operations (Tag_Typ));
6685 while Present (Elmt) and then Node (Elmt) /= Def_Id loop
6689 Remove_Elmt (Primitive_Operations (Tag_Typ), Elmt);
6690 Set_Is_Dispatching_Operation (Def_Id, False);
6693 -- For backward compatibility, if the constructor returns a
6694 -- class wide type, and we internally change the return type to
6695 -- the corresponding root type.
6697 if Is_Class_Wide_Type (Etype (Def_Id)) then
6698 Set_Etype (Def_Id, Root_Type (Etype (Def_Id)));
6702 ("pragma% requires function returning a 'C'P'P_Class type",
6705 end CPP_Constructor;
6711 when Pragma_CPP_Virtual => CPP_Virtual : declare
6715 if Warn_On_Obsolescent_Feature then
6717 ("'G'N'A'T pragma cpp'_virtual is now obsolete and has " &
6726 when Pragma_CPP_Vtable => CPP_Vtable : declare
6730 if Warn_On_Obsolescent_Feature then
6732 ("'G'N'A'T pragma cpp'_vtable is now obsolete and has " &
6741 -- pragma Debug ([boolean_EXPRESSION,] PROCEDURE_CALL_STATEMENT);
6743 when Pragma_Debug => Debug : declare
6751 (Boolean_Literals (Debug_Pragmas_Enabled and Expander_Active),
6754 if Arg_Count = 2 then
6757 Left_Opnd => Relocate_Node (Cond),
6758 Right_Opnd => Expression (Arg1));
6761 -- Rewrite into a conditional with an appropriate condition. We
6762 -- wrap the procedure call in a block so that overhead from e.g.
6763 -- use of the secondary stack does not generate execution overhead
6764 -- for suppressed conditions.
6766 Rewrite (N, Make_Implicit_If_Statement (N,
6768 Then_Statements => New_List (
6769 Make_Block_Statement (Loc,
6770 Handled_Statement_Sequence =>
6771 Make_Handled_Sequence_Of_Statements (Loc,
6772 Statements => New_List (
6773 Relocate_Node (Debug_Statement (N))))))));
6781 -- pragma Debug_Policy (Check | Ignore)
6783 when Pragma_Debug_Policy =>
6785 Check_Arg_Count (1);
6786 Check_Arg_Is_One_Of (Arg1, Name_Check, Name_Ignore);
6787 Debug_Pragmas_Enabled := Chars (Expression (Arg1)) = Name_Check;
6789 ---------------------
6790 -- Detect_Blocking --
6791 ---------------------
6793 -- pragma Detect_Blocking;
6795 when Pragma_Detect_Blocking =>
6797 Check_Arg_Count (0);
6798 Check_Valid_Configuration_Pragma;
6799 Detect_Blocking := True;
6805 when Pragma_Dimension =>
6807 Check_Arg_Count (4);
6808 Check_No_Identifiers;
6809 Check_Arg_Is_Local_Name (Arg1);
6811 if not Is_Type (Arg1) then
6812 Error_Pragma ("first argument for pragma% must be subtype");
6815 Check_Arg_Is_Static_Expression (Arg2, Standard_Integer);
6816 Check_Arg_Is_Static_Expression (Arg3, Standard_Integer);
6817 Check_Arg_Is_Static_Expression (Arg4, Standard_Integer);
6823 -- pragma Discard_Names [([On =>] LOCAL_NAME)];
6825 when Pragma_Discard_Names => Discard_Names : declare
6830 Check_Ada_83_Warning;
6832 -- Deal with configuration pragma case
6834 if Arg_Count = 0 and then Is_Configuration_Pragma then
6835 Global_Discard_Names := True;
6838 -- Otherwise, check correct appropriate context
6841 Check_Is_In_Decl_Part_Or_Package_Spec;
6843 if Arg_Count = 0 then
6845 -- If there is no parameter, then from now on this pragma
6846 -- applies to any enumeration, exception or tagged type
6847 -- defined in the current declarative part, and recursively
6848 -- to any nested scope.
6850 Set_Discard_Names (Current_Scope);
6854 Check_Arg_Count (1);
6855 Check_Optional_Identifier (Arg1, Name_On);
6856 Check_Arg_Is_Local_Name (Arg1);
6858 E_Id := Expression (Arg1);
6860 if Etype (E_Id) = Any_Type then
6866 if (Is_First_Subtype (E)
6868 (Is_Enumeration_Type (E) or else Is_Tagged_Type (E)))
6869 or else Ekind (E) = E_Exception
6871 Set_Discard_Names (E);
6874 ("inappropriate entity for pragma%", Arg1);
6885 -- pragma Elaborate (library_unit_NAME {, library_unit_NAME});
6887 when Pragma_Elaborate => Elaborate : declare
6892 -- Pragma must be in context items list of a compilation unit
6894 if not Is_In_Context_Clause then
6898 -- Must be at least one argument
6900 if Arg_Count = 0 then
6901 Error_Pragma ("pragma% requires at least one argument");
6904 -- In Ada 83 mode, there can be no items following it in the
6905 -- context list except other pragmas and implicit with clauses
6906 -- (e.g. those added by use of Rtsfind). In Ada 95 mode, this
6907 -- placement rule does not apply.
6909 if Ada_Version = Ada_83 and then Comes_From_Source (N) then
6911 while Present (Citem) loop
6912 if Nkind (Citem) = N_Pragma
6913 or else (Nkind (Citem) = N_With_Clause
6914 and then Implicit_With (Citem))
6919 ("(Ada 83) pragma% must be at end of context clause");
6926 -- Finally, the arguments must all be units mentioned in a with
6927 -- clause in the same context clause. Note we already checked (in
6928 -- Par.Prag) that the arguments are all identifiers or selected
6932 Outer : while Present (Arg) loop
6933 Citem := First (List_Containing (N));
6934 Inner : while Citem /= N loop
6935 if Nkind (Citem) = N_With_Clause
6936 and then Same_Name (Name (Citem), Expression (Arg))
6938 Set_Elaborate_Present (Citem, True);
6939 Set_Unit_Name (Expression (Arg), Name (Citem));
6941 -- With the pragma present, elaboration calls on
6942 -- subprograms from the named unit need no further
6943 -- checks, as long as the pragma appears in the current
6944 -- compilation unit. If the pragma appears in some unit
6945 -- in the context, there might still be a need for an
6946 -- Elaborate_All_Desirable from the current compilation
6947 -- to the named unit, so we keep the check enabled.
6949 if In_Extended_Main_Source_Unit (N) then
6950 Set_Suppress_Elaboration_Warnings
6951 (Entity (Name (Citem)));
6962 ("argument of pragma% is not with'ed unit", Arg);
6968 -- Give a warning if operating in static mode with -gnatwl
6969 -- (elaboration warnings enabled) switch set.
6971 if Elab_Warnings and not Dynamic_Elaboration_Checks then
6973 ("?use of pragma Elaborate may not be safe", N);
6975 ("?use pragma Elaborate_All instead if possible", N);
6983 -- pragma Elaborate_All (library_unit_NAME {, library_unit_NAME});
6985 when Pragma_Elaborate_All => Elaborate_All : declare
6990 Check_Ada_83_Warning;
6992 -- Pragma must be in context items list of a compilation unit
6994 if not Is_In_Context_Clause then
6998 -- Must be at least one argument
7000 if Arg_Count = 0 then
7001 Error_Pragma ("pragma% requires at least one argument");
7004 -- Note: unlike pragma Elaborate, pragma Elaborate_All does not
7005 -- have to appear at the end of the context clause, but may
7006 -- appear mixed in with other items, even in Ada 83 mode.
7008 -- Final check: the arguments must all be units mentioned in
7009 -- a with clause in the same context clause. Note that we
7010 -- already checked (in Par.Prag) that all the arguments are
7011 -- either identifiers or selected components.
7014 Outr : while Present (Arg) loop
7015 Citem := First (List_Containing (N));
7016 Innr : while Citem /= N loop
7017 if Nkind (Citem) = N_With_Clause
7018 and then Same_Name (Name (Citem), Expression (Arg))
7020 Set_Elaborate_All_Present (Citem, True);
7021 Set_Unit_Name (Expression (Arg), Name (Citem));
7023 -- Suppress warnings and elaboration checks on the named
7024 -- unit if the pragma is in the current compilation, as
7025 -- for pragma Elaborate.
7027 if In_Extended_Main_Source_Unit (N) then
7028 Set_Suppress_Elaboration_Warnings
7029 (Entity (Name (Citem)));
7038 Set_Error_Posted (N);
7040 ("argument of pragma% is not with'ed unit", Arg);
7047 --------------------
7048 -- Elaborate_Body --
7049 --------------------
7051 -- pragma Elaborate_Body [( library_unit_NAME )];
7053 when Pragma_Elaborate_Body => Elaborate_Body : declare
7054 Cunit_Node : Node_Id;
7055 Cunit_Ent : Entity_Id;
7058 Check_Ada_83_Warning;
7059 Check_Valid_Library_Unit_Pragma;
7061 if Nkind (N) = N_Null_Statement then
7065 Cunit_Node := Cunit (Current_Sem_Unit);
7066 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
7068 if Nkind_In (Unit (Cunit_Node), N_Package_Body,
7071 Error_Pragma ("pragma% must refer to a spec, not a body");
7073 Set_Body_Required (Cunit_Node, True);
7074 Set_Has_Pragma_Elaborate_Body (Cunit_Ent);
7076 -- If we are in dynamic elaboration mode, then we suppress
7077 -- elaboration warnings for the unit, since it is definitely
7078 -- fine NOT to do dynamic checks at the first level (and such
7079 -- checks will be suppressed because no elaboration boolean
7080 -- is created for Elaborate_Body packages).
7082 -- But in the static model of elaboration, Elaborate_Body is
7083 -- definitely NOT good enough to ensure elaboration safety on
7084 -- its own, since the body may WITH other units that are not
7085 -- safe from an elaboration point of view, so a client must
7086 -- still do an Elaborate_All on such units.
7088 -- Debug flag -gnatdD restores the old behavior of 3.13, where
7089 -- Elaborate_Body always suppressed elab warnings.
7091 if Dynamic_Elaboration_Checks or Debug_Flag_DD then
7092 Set_Suppress_Elaboration_Warnings (Cunit_Ent);
7097 ------------------------
7098 -- Elaboration_Checks --
7099 ------------------------
7101 -- pragma Elaboration_Checks (Static | Dynamic);
7103 when Pragma_Elaboration_Checks =>
7105 Check_Arg_Count (1);
7106 Check_Arg_Is_One_Of (Arg1, Name_Static, Name_Dynamic);
7107 Dynamic_Elaboration_Checks :=
7108 (Chars (Get_Pragma_Arg (Arg1)) = Name_Dynamic);
7114 -- pragma Eliminate (
7115 -- [Unit_Name =>] IDENTIFIER | SELECTED_COMPONENT,
7116 -- [,[Entity =>] IDENTIFIER |
7117 -- SELECTED_COMPONENT |
7119 -- [, OVERLOADING_RESOLUTION]);
7121 -- OVERLOADING_RESOLUTION ::= PARAMETER_AND_RESULT_TYPE_PROFILE |
7124 -- PARAMETER_AND_RESULT_TYPE_PROFILE ::= PROCEDURE_PROFILE |
7127 -- PROCEDURE_PROFILE ::= Parameter_Types => PARAMETER_TYPES
7129 -- FUNCTION_PROFILE ::= [Parameter_Types => PARAMETER_TYPES,]
7130 -- Result_Type => result_SUBTYPE_NAME]
7132 -- PARAMETER_TYPES ::= (SUBTYPE_NAME {, SUBTYPE_NAME})
7133 -- SUBTYPE_NAME ::= STRING_LITERAL
7135 -- SOURCE_LOCATION ::= Source_Location => SOURCE_TRACE
7136 -- SOURCE_TRACE ::= STRING_LITERAL
7138 when Pragma_Eliminate => Eliminate : declare
7139 Args : Args_List (1 .. 5);
7140 Names : constant Name_List (1 .. 5) := (
7143 Name_Parameter_Types,
7145 Name_Source_Location);
7147 Unit_Name : Node_Id renames Args (1);
7148 Entity : Node_Id renames Args (2);
7149 Parameter_Types : Node_Id renames Args (3);
7150 Result_Type : Node_Id renames Args (4);
7151 Source_Location : Node_Id renames Args (5);
7155 Check_Valid_Configuration_Pragma;
7156 Gather_Associations (Names, Args);
7158 if No (Unit_Name) then
7159 Error_Pragma ("missing Unit_Name argument for pragma%");
7163 and then (Present (Parameter_Types)
7165 Present (Result_Type)
7167 Present (Source_Location))
7169 Error_Pragma ("missing Entity argument for pragma%");
7172 if (Present (Parameter_Types)
7174 Present (Result_Type))
7176 Present (Source_Location)
7179 ("parameter profile and source location cannot " &
7180 "be used together in pragma%");
7183 Process_Eliminate_Pragma
7197 -- [ Convention =>] convention_IDENTIFIER,
7198 -- [ Entity =>] local_NAME
7199 -- [, [External_Name =>] static_string_EXPRESSION ]
7200 -- [, [Link_Name =>] static_string_EXPRESSION ]);
7202 when Pragma_Export => Export : declare
7206 pragma Warnings (Off, C);
7209 Check_Ada_83_Warning;
7215 Check_At_Least_N_Arguments (2);
7216 Check_At_Most_N_Arguments (4);
7217 Process_Convention (C, Def_Id);
7219 if Ekind (Def_Id) /= E_Constant then
7220 Note_Possible_Modification (Expression (Arg2), Sure => False);
7223 Process_Interface_Name (Def_Id, Arg3, Arg4);
7224 Set_Exported (Def_Id, Arg2);
7226 -- If the entity is a deferred constant, propagate the information
7227 -- to the full view, because gigi elaborates the full view only.
7229 if Ekind (Def_Id) = E_Constant
7230 and then Present (Full_View (Def_Id))
7233 Id2 : constant Entity_Id := Full_View (Def_Id);
7235 Set_Is_Exported (Id2, Is_Exported (Def_Id));
7236 Set_First_Rep_Item (Id2, First_Rep_Item (Def_Id));
7237 Set_Interface_Name (Id2, Einfo.Interface_Name (Def_Id));
7242 ----------------------
7243 -- Export_Exception --
7244 ----------------------
7246 -- pragma Export_Exception (
7247 -- [Internal =>] LOCAL_NAME
7248 -- [, [External =>] EXTERNAL_SYMBOL]
7249 -- [, [Form =>] Ada | VMS]
7250 -- [, [Code =>] static_integer_EXPRESSION]);
7252 when Pragma_Export_Exception => Export_Exception : declare
7253 Args : Args_List (1 .. 4);
7254 Names : constant Name_List (1 .. 4) := (
7260 Internal : Node_Id renames Args (1);
7261 External : Node_Id renames Args (2);
7262 Form : Node_Id renames Args (3);
7263 Code : Node_Id renames Args (4);
7268 if Inside_A_Generic then
7269 Error_Pragma ("pragma% cannot be used for generic entities");
7272 Gather_Associations (Names, Args);
7273 Process_Extended_Import_Export_Exception_Pragma (
7274 Arg_Internal => Internal,
7275 Arg_External => External,
7279 if not Is_VMS_Exception (Entity (Internal)) then
7280 Set_Exported (Entity (Internal), Internal);
7282 end Export_Exception;
7284 ---------------------
7285 -- Export_Function --
7286 ---------------------
7288 -- pragma Export_Function (
7289 -- [Internal =>] LOCAL_NAME
7290 -- [, [External =>] EXTERNAL_SYMBOL]
7291 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
7292 -- [, [Result_Type =>] TYPE_DESIGNATOR]
7293 -- [, [Mechanism =>] MECHANISM]
7294 -- [, [Result_Mechanism =>] MECHANISM_NAME]);
7296 -- EXTERNAL_SYMBOL ::=
7298 -- | static_string_EXPRESSION
7300 -- PARAMETER_TYPES ::=
7302 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7304 -- TYPE_DESIGNATOR ::=
7306 -- | subtype_Name ' Access
7310 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7312 -- MECHANISM_ASSOCIATION ::=
7313 -- [formal_parameter_NAME =>] MECHANISM_NAME
7315 -- MECHANISM_NAME ::=
7318 -- | Descriptor [([Class =>] CLASS_NAME)]
7320 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7322 when Pragma_Export_Function => Export_Function : declare
7323 Args : Args_List (1 .. 6);
7324 Names : constant Name_List (1 .. 6) := (
7327 Name_Parameter_Types,
7330 Name_Result_Mechanism);
7332 Internal : Node_Id renames Args (1);
7333 External : Node_Id renames Args (2);
7334 Parameter_Types : Node_Id renames Args (3);
7335 Result_Type : Node_Id renames Args (4);
7336 Mechanism : Node_Id renames Args (5);
7337 Result_Mechanism : Node_Id renames Args (6);
7341 Gather_Associations (Names, Args);
7342 Process_Extended_Import_Export_Subprogram_Pragma (
7343 Arg_Internal => Internal,
7344 Arg_External => External,
7345 Arg_Parameter_Types => Parameter_Types,
7346 Arg_Result_Type => Result_Type,
7347 Arg_Mechanism => Mechanism,
7348 Arg_Result_Mechanism => Result_Mechanism);
7349 end Export_Function;
7355 -- pragma Export_Object (
7356 -- [Internal =>] LOCAL_NAME
7357 -- [, [External =>] EXTERNAL_SYMBOL]
7358 -- [, [Size =>] EXTERNAL_SYMBOL]);
7360 -- EXTERNAL_SYMBOL ::=
7362 -- | static_string_EXPRESSION
7364 -- PARAMETER_TYPES ::=
7366 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7368 -- TYPE_DESIGNATOR ::=
7370 -- | subtype_Name ' Access
7374 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7376 -- MECHANISM_ASSOCIATION ::=
7377 -- [formal_parameter_NAME =>] MECHANISM_NAME
7379 -- MECHANISM_NAME ::=
7382 -- | Descriptor [([Class =>] CLASS_NAME)]
7384 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7386 when Pragma_Export_Object => Export_Object : declare
7387 Args : Args_List (1 .. 3);
7388 Names : constant Name_List (1 .. 3) := (
7393 Internal : Node_Id renames Args (1);
7394 External : Node_Id renames Args (2);
7395 Size : Node_Id renames Args (3);
7399 Gather_Associations (Names, Args);
7400 Process_Extended_Import_Export_Object_Pragma (
7401 Arg_Internal => Internal,
7402 Arg_External => External,
7406 ----------------------
7407 -- Export_Procedure --
7408 ----------------------
7410 -- pragma Export_Procedure (
7411 -- [Internal =>] LOCAL_NAME
7412 -- [, [External =>] EXTERNAL_SYMBOL]
7413 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
7414 -- [, [Mechanism =>] MECHANISM]);
7416 -- EXTERNAL_SYMBOL ::=
7418 -- | static_string_EXPRESSION
7420 -- PARAMETER_TYPES ::=
7422 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7424 -- TYPE_DESIGNATOR ::=
7426 -- | subtype_Name ' Access
7430 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7432 -- MECHANISM_ASSOCIATION ::=
7433 -- [formal_parameter_NAME =>] MECHANISM_NAME
7435 -- MECHANISM_NAME ::=
7438 -- | Descriptor [([Class =>] CLASS_NAME)]
7440 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7442 when Pragma_Export_Procedure => Export_Procedure : declare
7443 Args : Args_List (1 .. 4);
7444 Names : constant Name_List (1 .. 4) := (
7447 Name_Parameter_Types,
7450 Internal : Node_Id renames Args (1);
7451 External : Node_Id renames Args (2);
7452 Parameter_Types : Node_Id renames Args (3);
7453 Mechanism : Node_Id renames Args (4);
7457 Gather_Associations (Names, Args);
7458 Process_Extended_Import_Export_Subprogram_Pragma (
7459 Arg_Internal => Internal,
7460 Arg_External => External,
7461 Arg_Parameter_Types => Parameter_Types,
7462 Arg_Mechanism => Mechanism);
7463 end Export_Procedure;
7469 -- pragma Export_Value (
7470 -- [Value =>] static_integer_EXPRESSION,
7471 -- [Link_Name =>] static_string_EXPRESSION);
7473 when Pragma_Export_Value =>
7475 Check_Arg_Order ((Name_Value, Name_Link_Name));
7476 Check_Arg_Count (2);
7478 Check_Optional_Identifier (Arg1, Name_Value);
7479 Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
7481 Check_Optional_Identifier (Arg2, Name_Link_Name);
7482 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
7484 -----------------------------
7485 -- Export_Valued_Procedure --
7486 -----------------------------
7488 -- pragma Export_Valued_Procedure (
7489 -- [Internal =>] LOCAL_NAME
7490 -- [, [External =>] EXTERNAL_SYMBOL,]
7491 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
7492 -- [, [Mechanism =>] MECHANISM]);
7494 -- EXTERNAL_SYMBOL ::=
7496 -- | static_string_EXPRESSION
7498 -- PARAMETER_TYPES ::=
7500 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
7502 -- TYPE_DESIGNATOR ::=
7504 -- | subtype_Name ' Access
7508 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
7510 -- MECHANISM_ASSOCIATION ::=
7511 -- [formal_parameter_NAME =>] MECHANISM_NAME
7513 -- MECHANISM_NAME ::=
7516 -- | Descriptor [([Class =>] CLASS_NAME)]
7518 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
7520 when Pragma_Export_Valued_Procedure =>
7521 Export_Valued_Procedure : declare
7522 Args : Args_List (1 .. 4);
7523 Names : constant Name_List (1 .. 4) := (
7526 Name_Parameter_Types,
7529 Internal : Node_Id renames Args (1);
7530 External : Node_Id renames Args (2);
7531 Parameter_Types : Node_Id renames Args (3);
7532 Mechanism : Node_Id renames Args (4);
7536 Gather_Associations (Names, Args);
7537 Process_Extended_Import_Export_Subprogram_Pragma (
7538 Arg_Internal => Internal,
7539 Arg_External => External,
7540 Arg_Parameter_Types => Parameter_Types,
7541 Arg_Mechanism => Mechanism);
7542 end Export_Valued_Procedure;
7548 -- pragma Extend_System ([Name =>] Identifier);
7550 when Pragma_Extend_System => Extend_System : declare
7553 Check_Valid_Configuration_Pragma;
7554 Check_Arg_Count (1);
7555 Check_Optional_Identifier (Arg1, Name_Name);
7556 Check_Arg_Is_Identifier (Arg1);
7558 Get_Name_String (Chars (Expression (Arg1)));
7561 and then Name_Buffer (1 .. 4) = "aux_"
7563 if Present (System_Extend_Pragma_Arg) then
7564 if Chars (Expression (Arg1)) =
7565 Chars (Expression (System_Extend_Pragma_Arg))
7569 Error_Msg_Sloc := Sloc (System_Extend_Pragma_Arg);
7570 Error_Pragma ("pragma% conflicts with that #");
7574 System_Extend_Pragma_Arg := Arg1;
7576 if not GNAT_Mode then
7577 System_Extend_Unit := Arg1;
7581 Error_Pragma ("incorrect name for pragma%, must be Aux_xxx");
7585 ------------------------
7586 -- Extensions_Allowed --
7587 ------------------------
7589 -- pragma Extensions_Allowed (ON | OFF);
7591 when Pragma_Extensions_Allowed =>
7593 Check_Arg_Count (1);
7594 Check_No_Identifiers;
7595 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
7597 if Chars (Expression (Arg1)) = Name_On then
7598 Extensions_Allowed := True;
7599 Ada_Version := Ada_Version_Type'Last;
7602 Extensions_Allowed := False;
7603 Ada_Version := Ada_Version_Explicit;
7610 -- pragma External (
7611 -- [ Convention =>] convention_IDENTIFIER,
7612 -- [ Entity =>] local_NAME
7613 -- [, [External_Name =>] static_string_EXPRESSION ]
7614 -- [, [Link_Name =>] static_string_EXPRESSION ]);
7616 when Pragma_External => External : declare
7620 pragma Warnings (Off, C);
7629 Check_At_Least_N_Arguments (2);
7630 Check_At_Most_N_Arguments (4);
7631 Process_Convention (C, Def_Id);
7632 Note_Possible_Modification (Expression (Arg2), Sure => False);
7633 Process_Interface_Name (Def_Id, Arg3, Arg4);
7634 Set_Exported (Def_Id, Arg2);
7637 --------------------------
7638 -- External_Name_Casing --
7639 --------------------------
7641 -- pragma External_Name_Casing (
7642 -- UPPERCASE | LOWERCASE
7643 -- [, AS_IS | UPPERCASE | LOWERCASE]);
7645 when Pragma_External_Name_Casing => External_Name_Casing : declare
7648 Check_No_Identifiers;
7650 if Arg_Count = 2 then
7652 (Arg2, Name_As_Is, Name_Uppercase, Name_Lowercase);
7654 case Chars (Get_Pragma_Arg (Arg2)) is
7656 Opt.External_Name_Exp_Casing := As_Is;
7658 when Name_Uppercase =>
7659 Opt.External_Name_Exp_Casing := Uppercase;
7661 when Name_Lowercase =>
7662 Opt.External_Name_Exp_Casing := Lowercase;
7669 Check_Arg_Count (1);
7672 Check_Arg_Is_One_Of (Arg1, Name_Uppercase, Name_Lowercase);
7674 case Chars (Get_Pragma_Arg (Arg1)) is
7675 when Name_Uppercase =>
7676 Opt.External_Name_Imp_Casing := Uppercase;
7678 when Name_Lowercase =>
7679 Opt.External_Name_Imp_Casing := Lowercase;
7684 end External_Name_Casing;
7686 --------------------------
7687 -- Favor_Top_Level --
7688 --------------------------
7690 -- pragma Favor_Top_Level (type_NAME);
7692 when Pragma_Favor_Top_Level => Favor_Top_Level : declare
7693 Named_Entity : Entity_Id;
7697 Check_No_Identifiers;
7698 Check_Arg_Count (1);
7699 Check_Arg_Is_Local_Name (Arg1);
7700 Named_Entity := Entity (Expression (Arg1));
7702 -- If it's an access-to-subprogram type (in particular, not a
7703 -- subtype), set the flag on that type.
7705 if Is_Access_Subprogram_Type (Named_Entity) then
7706 Set_Can_Use_Internal_Rep (Named_Entity, False);
7708 -- Otherwise it's an error (name denotes the wrong sort of entity)
7712 ("access-to-subprogram type expected", Expression (Arg1));
7714 end Favor_Top_Level;
7720 -- pragma Fast_Math;
7722 when Pragma_Fast_Math =>
7724 Check_No_Identifiers;
7725 Check_Valid_Configuration_Pragma;
7728 ---------------------------
7729 -- Finalize_Storage_Only --
7730 ---------------------------
7732 -- pragma Finalize_Storage_Only (first_subtype_LOCAL_NAME);
7734 when Pragma_Finalize_Storage_Only => Finalize_Storage : declare
7735 Assoc : constant Node_Id := Arg1;
7736 Type_Id : constant Node_Id := Expression (Assoc);
7741 Check_No_Identifiers;
7742 Check_Arg_Count (1);
7743 Check_Arg_Is_Local_Name (Arg1);
7745 Find_Type (Type_Id);
7746 Typ := Entity (Type_Id);
7749 or else Rep_Item_Too_Early (Typ, N)
7753 Typ := Underlying_Type (Typ);
7756 if not Is_Controlled (Typ) then
7757 Error_Pragma ("pragma% must specify controlled type");
7760 Check_First_Subtype (Arg1);
7762 if Finalize_Storage_Only (Typ) then
7763 Error_Pragma ("duplicate pragma%, only one allowed");
7765 elsif not Rep_Item_Too_Late (Typ, N) then
7766 Set_Finalize_Storage_Only (Base_Type (Typ), True);
7768 end Finalize_Storage;
7770 --------------------------
7771 -- Float_Representation --
7772 --------------------------
7774 -- pragma Float_Representation (FLOAT_REP[, float_type_LOCAL_NAME]);
7776 -- FLOAT_REP ::= VAX_Float | IEEE_Float
7778 when Pragma_Float_Representation => Float_Representation : declare
7786 if Arg_Count = 1 then
7787 Check_Valid_Configuration_Pragma;
7789 Check_Arg_Count (2);
7790 Check_Optional_Identifier (Arg2, Name_Entity);
7791 Check_Arg_Is_Local_Name (Arg2);
7794 Check_No_Identifier (Arg1);
7795 Check_Arg_Is_One_Of (Arg1, Name_VAX_Float, Name_IEEE_Float);
7797 if not OpenVMS_On_Target then
7798 if Chars (Expression (Arg1)) = Name_VAX_Float then
7800 ("?pragma% ignored (applies only to Open'V'M'S)");
7806 -- One argument case
7808 if Arg_Count = 1 then
7809 if Chars (Expression (Arg1)) = Name_VAX_Float then
7810 if Opt.Float_Format = 'I' then
7811 Error_Pragma ("'I'E'E'E format previously specified");
7814 Opt.Float_Format := 'V';
7817 if Opt.Float_Format = 'V' then
7818 Error_Pragma ("'V'A'X format previously specified");
7821 Opt.Float_Format := 'I';
7824 Set_Standard_Fpt_Formats;
7826 -- Two argument case
7829 Argx := Get_Pragma_Arg (Arg2);
7831 if not Is_Entity_Name (Argx)
7832 or else not Is_Floating_Point_Type (Entity (Argx))
7835 ("second argument of% pragma must be floating-point type",
7839 Ent := Entity (Argx);
7840 Digs := UI_To_Int (Digits_Value (Ent));
7842 -- Two arguments, VAX_Float case
7844 if Chars (Expression (Arg1)) = Name_VAX_Float then
7846 when 6 => Set_F_Float (Ent);
7847 when 9 => Set_D_Float (Ent);
7848 when 15 => Set_G_Float (Ent);
7852 ("wrong digits value, must be 6,9 or 15", Arg2);
7855 -- Two arguments, IEEE_Float case
7859 when 6 => Set_IEEE_Short (Ent);
7860 when 15 => Set_IEEE_Long (Ent);
7864 ("wrong digits value, must be 6 or 15", Arg2);
7868 end Float_Representation;
7874 -- pragma Ident (static_string_EXPRESSION)
7876 -- Note: pragma Comment shares this processing. Pragma Comment is
7877 -- identical to Ident, except that the restriction of the argument to
7878 -- 31 characters and the placement restrictions are not enforced for
7881 when Pragma_Ident | Pragma_Comment => Ident : declare
7886 Check_Arg_Count (1);
7887 Check_No_Identifiers;
7888 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
7891 -- For pragma Ident, preserve DEC compatibility by requiring the
7892 -- pragma to appear in a declarative part or package spec.
7894 if Prag_Id = Pragma_Ident then
7895 Check_Is_In_Decl_Part_Or_Package_Spec;
7898 Str := Expr_Value_S (Expression (Arg1));
7905 GP := Parent (Parent (N));
7907 if Nkind_In (GP, N_Package_Declaration,
7908 N_Generic_Package_Declaration)
7913 -- If we have a compilation unit, then record the ident value,
7914 -- checking for improper duplication.
7916 if Nkind (GP) = N_Compilation_Unit then
7917 CS := Ident_String (Current_Sem_Unit);
7919 if Present (CS) then
7921 -- For Ident, we do not permit multiple instances
7923 if Prag_Id = Pragma_Ident then
7924 Error_Pragma ("duplicate% pragma not permitted");
7926 -- For Comment, we concatenate the string, unless we want
7927 -- to preserve the tree structure for ASIS.
7929 elsif not ASIS_Mode then
7930 Start_String (Strval (CS));
7931 Store_String_Char (' ');
7932 Store_String_Chars (Strval (Str));
7933 Set_Strval (CS, End_String);
7937 -- In VMS, the effect of IDENT is achieved by passing
7938 -- --identification=name as a --for-linker switch.
7940 if OpenVMS_On_Target then
7943 ("--for-linker=--identification=");
7944 String_To_Name_Buffer (Strval (Str));
7945 Store_String_Chars (Name_Buffer (1 .. Name_Len));
7947 -- Only the last processed IDENT is saved. The main
7948 -- purpose is so an IDENT associated with a main
7949 -- procedure will be used in preference to an IDENT
7950 -- associated with a with'd package.
7952 Replace_Linker_Option_String
7953 (End_String, "--for-linker=--identification=");
7956 Set_Ident_String (Current_Sem_Unit, Str);
7959 -- For subunits, we just ignore the Ident, since in GNAT these
7960 -- are not separate object files, and hence not separate units
7961 -- in the unit table.
7963 elsif Nkind (GP) = N_Subunit then
7966 -- Otherwise we have a misplaced pragma Ident, but we ignore
7967 -- this if we are in an instantiation, since it comes from
7968 -- a generic, and has no relevance to the instantiation.
7970 elsif Prag_Id = Pragma_Ident then
7971 if Instantiation_Location (Loc) = No_Location then
7972 Error_Pragma ("pragma% only allowed at outer level");
7978 --------------------------
7979 -- Implemented_By_Entry --
7980 --------------------------
7982 -- pragma Implemented_By_Entry (DIRECT_NAME);
7984 when Pragma_Implemented_By_Entry => Implemented_By_Entry : declare
7989 Check_Arg_Count (1);
7990 Check_No_Identifiers;
7991 Check_Arg_Is_Identifier (Arg1);
7992 Check_Arg_Is_Local_Name (Arg1);
7993 Ent := Entity (Expression (Arg1));
7995 -- Pragma Implemented_By_Entry must be applied only to protected
7996 -- synchronized or task interface primitives.
7998 if (Ekind (Ent) /= E_Function
7999 and then Ekind (Ent) /= E_Procedure)
8000 or else not Present (First_Formal (Ent))
8001 or else not Is_Concurrent_Interface (Etype (First_Formal (Ent)))
8004 ("pragma % must be applied to a concurrent interface " &
8008 if Einfo.Implemented_By_Entry (Ent)
8009 and then Warn_On_Redundant_Constructs
8011 Error_Pragma ("?duplicate pragma%!");
8013 Set_Implemented_By_Entry (Ent);
8016 end Implemented_By_Entry;
8018 -----------------------
8019 -- Implicit_Packing --
8020 -----------------------
8022 -- pragma Implicit_Packing;
8024 when Pragma_Implicit_Packing =>
8026 Check_Arg_Count (0);
8027 Implicit_Packing := True;
8034 -- [Convention =>] convention_IDENTIFIER,
8035 -- [Entity =>] local_NAME
8036 -- [, [External_Name =>] static_string_EXPRESSION ]
8037 -- [, [Link_Name =>] static_string_EXPRESSION ]);
8039 when Pragma_Import =>
8040 Check_Ada_83_Warning;
8046 Check_At_Least_N_Arguments (2);
8047 Check_At_Most_N_Arguments (4);
8048 Process_Import_Or_Interface;
8050 ----------------------
8051 -- Import_Exception --
8052 ----------------------
8054 -- pragma Import_Exception (
8055 -- [Internal =>] LOCAL_NAME
8056 -- [, [External =>] EXTERNAL_SYMBOL]
8057 -- [, [Form =>] Ada | VMS]
8058 -- [, [Code =>] static_integer_EXPRESSION]);
8060 when Pragma_Import_Exception => Import_Exception : declare
8061 Args : Args_List (1 .. 4);
8062 Names : constant Name_List (1 .. 4) := (
8068 Internal : Node_Id renames Args (1);
8069 External : Node_Id renames Args (2);
8070 Form : Node_Id renames Args (3);
8071 Code : Node_Id renames Args (4);
8075 Gather_Associations (Names, Args);
8077 if Present (External) and then Present (Code) then
8079 ("cannot give both External and Code options for pragma%");
8082 Process_Extended_Import_Export_Exception_Pragma (
8083 Arg_Internal => Internal,
8084 Arg_External => External,
8088 if not Is_VMS_Exception (Entity (Internal)) then
8089 Set_Imported (Entity (Internal));
8091 end Import_Exception;
8093 ---------------------
8094 -- Import_Function --
8095 ---------------------
8097 -- pragma Import_Function (
8098 -- [Internal =>] LOCAL_NAME,
8099 -- [, [External =>] EXTERNAL_SYMBOL]
8100 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
8101 -- [, [Result_Type =>] SUBTYPE_MARK]
8102 -- [, [Mechanism =>] MECHANISM]
8103 -- [, [Result_Mechanism =>] MECHANISM_NAME]
8104 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
8106 -- EXTERNAL_SYMBOL ::=
8108 -- | static_string_EXPRESSION
8110 -- PARAMETER_TYPES ::=
8112 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
8114 -- TYPE_DESIGNATOR ::=
8116 -- | subtype_Name ' Access
8120 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
8122 -- MECHANISM_ASSOCIATION ::=
8123 -- [formal_parameter_NAME =>] MECHANISM_NAME
8125 -- MECHANISM_NAME ::=
8128 -- | Descriptor [([Class =>] CLASS_NAME)]
8130 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
8132 when Pragma_Import_Function => Import_Function : declare
8133 Args : Args_List (1 .. 7);
8134 Names : constant Name_List (1 .. 7) := (
8137 Name_Parameter_Types,
8140 Name_Result_Mechanism,
8141 Name_First_Optional_Parameter);
8143 Internal : Node_Id renames Args (1);
8144 External : Node_Id renames Args (2);
8145 Parameter_Types : Node_Id renames Args (3);
8146 Result_Type : Node_Id renames Args (4);
8147 Mechanism : Node_Id renames Args (5);
8148 Result_Mechanism : Node_Id renames Args (6);
8149 First_Optional_Parameter : Node_Id renames Args (7);
8153 Gather_Associations (Names, Args);
8154 Process_Extended_Import_Export_Subprogram_Pragma (
8155 Arg_Internal => Internal,
8156 Arg_External => External,
8157 Arg_Parameter_Types => Parameter_Types,
8158 Arg_Result_Type => Result_Type,
8159 Arg_Mechanism => Mechanism,
8160 Arg_Result_Mechanism => Result_Mechanism,
8161 Arg_First_Optional_Parameter => First_Optional_Parameter);
8162 end Import_Function;
8168 -- pragma Import_Object (
8169 -- [Internal =>] LOCAL_NAME
8170 -- [, [External =>] EXTERNAL_SYMBOL]
8171 -- [, [Size =>] EXTERNAL_SYMBOL]);
8173 -- EXTERNAL_SYMBOL ::=
8175 -- | static_string_EXPRESSION
8177 when Pragma_Import_Object => Import_Object : declare
8178 Args : Args_List (1 .. 3);
8179 Names : constant Name_List (1 .. 3) := (
8184 Internal : Node_Id renames Args (1);
8185 External : Node_Id renames Args (2);
8186 Size : Node_Id renames Args (3);
8190 Gather_Associations (Names, Args);
8191 Process_Extended_Import_Export_Object_Pragma (
8192 Arg_Internal => Internal,
8193 Arg_External => External,
8197 ----------------------
8198 -- Import_Procedure --
8199 ----------------------
8201 -- pragma Import_Procedure (
8202 -- [Internal =>] LOCAL_NAME
8203 -- [, [External =>] EXTERNAL_SYMBOL]
8204 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
8205 -- [, [Mechanism =>] MECHANISM]
8206 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
8208 -- EXTERNAL_SYMBOL ::=
8210 -- | static_string_EXPRESSION
8212 -- PARAMETER_TYPES ::=
8214 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
8216 -- TYPE_DESIGNATOR ::=
8218 -- | subtype_Name ' Access
8222 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
8224 -- MECHANISM_ASSOCIATION ::=
8225 -- [formal_parameter_NAME =>] MECHANISM_NAME
8227 -- MECHANISM_NAME ::=
8230 -- | Descriptor [([Class =>] CLASS_NAME)]
8232 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
8234 when Pragma_Import_Procedure => Import_Procedure : declare
8235 Args : Args_List (1 .. 5);
8236 Names : constant Name_List (1 .. 5) := (
8239 Name_Parameter_Types,
8241 Name_First_Optional_Parameter);
8243 Internal : Node_Id renames Args (1);
8244 External : Node_Id renames Args (2);
8245 Parameter_Types : Node_Id renames Args (3);
8246 Mechanism : Node_Id renames Args (4);
8247 First_Optional_Parameter : Node_Id renames Args (5);
8251 Gather_Associations (Names, Args);
8252 Process_Extended_Import_Export_Subprogram_Pragma (
8253 Arg_Internal => Internal,
8254 Arg_External => External,
8255 Arg_Parameter_Types => Parameter_Types,
8256 Arg_Mechanism => Mechanism,
8257 Arg_First_Optional_Parameter => First_Optional_Parameter);
8258 end Import_Procedure;
8260 -----------------------------
8261 -- Import_Valued_Procedure --
8262 -----------------------------
8264 -- pragma Import_Valued_Procedure (
8265 -- [Internal =>] LOCAL_NAME
8266 -- [, [External =>] EXTERNAL_SYMBOL]
8267 -- [, [Parameter_Types =>] (PARAMETER_TYPES)]
8268 -- [, [Mechanism =>] MECHANISM]
8269 -- [, [First_Optional_Parameter =>] IDENTIFIER]);
8271 -- EXTERNAL_SYMBOL ::=
8273 -- | static_string_EXPRESSION
8275 -- PARAMETER_TYPES ::=
8277 -- | TYPE_DESIGNATOR @{, TYPE_DESIGNATOR@}
8279 -- TYPE_DESIGNATOR ::=
8281 -- | subtype_Name ' Access
8285 -- | (MECHANISM_ASSOCIATION @{, MECHANISM_ASSOCIATION@})
8287 -- MECHANISM_ASSOCIATION ::=
8288 -- [formal_parameter_NAME =>] MECHANISM_NAME
8290 -- MECHANISM_NAME ::=
8293 -- | Descriptor [([Class =>] CLASS_NAME)]
8295 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
8297 when Pragma_Import_Valued_Procedure =>
8298 Import_Valued_Procedure : declare
8299 Args : Args_List (1 .. 5);
8300 Names : constant Name_List (1 .. 5) := (
8303 Name_Parameter_Types,
8305 Name_First_Optional_Parameter);
8307 Internal : Node_Id renames Args (1);
8308 External : Node_Id renames Args (2);
8309 Parameter_Types : Node_Id renames Args (3);
8310 Mechanism : Node_Id renames Args (4);
8311 First_Optional_Parameter : Node_Id renames Args (5);
8315 Gather_Associations (Names, Args);
8316 Process_Extended_Import_Export_Subprogram_Pragma (
8317 Arg_Internal => Internal,
8318 Arg_External => External,
8319 Arg_Parameter_Types => Parameter_Types,
8320 Arg_Mechanism => Mechanism,
8321 Arg_First_Optional_Parameter => First_Optional_Parameter);
8322 end Import_Valued_Procedure;
8324 ------------------------
8325 -- Initialize_Scalars --
8326 ------------------------
8328 -- pragma Initialize_Scalars;
8330 when Pragma_Initialize_Scalars =>
8332 Check_Arg_Count (0);
8333 Check_Valid_Configuration_Pragma;
8334 Check_Restriction (No_Initialize_Scalars, N);
8336 -- Initialize_Scalars creates false positives in CodePeer,
8337 -- so ignore this pragma in this mode.
8339 if not Restriction_Active (No_Initialize_Scalars)
8340 and then not CodePeer_Mode
8342 Init_Or_Norm_Scalars := True;
8343 Initialize_Scalars := True;
8350 -- pragma Inline ( NAME {, NAME} );
8352 when Pragma_Inline =>
8354 -- Pragma is active if inlining option is active
8356 Process_Inline (Inline_Active);
8362 -- pragma Inline_Always ( NAME {, NAME} );
8364 when Pragma_Inline_Always =>
8367 -- Pragma always active unless in CodePeer mode, since this causes
8368 -- walk order issues.
8370 if not CodePeer_Mode then
8371 Process_Inline (True);
8374 --------------------
8375 -- Inline_Generic --
8376 --------------------
8378 -- pragma Inline_Generic (NAME {, NAME});
8380 when Pragma_Inline_Generic =>
8382 Process_Generic_List;
8384 ----------------------
8385 -- Inspection_Point --
8386 ----------------------
8388 -- pragma Inspection_Point [(object_NAME {, object_NAME})];
8390 when Pragma_Inspection_Point => Inspection_Point : declare
8395 if Arg_Count > 0 then
8398 Exp := Expression (Arg);
8401 if not Is_Entity_Name (Exp)
8402 or else not Is_Object (Entity (Exp))
8404 Error_Pragma_Arg ("object name required", Arg);
8411 end Inspection_Point;
8417 -- pragma Interface (
8418 -- [ Convention =>] convention_IDENTIFIER,
8419 -- [ Entity =>] local_NAME
8420 -- [, [External_Name =>] static_string_EXPRESSION ]
8421 -- [, [Link_Name =>] static_string_EXPRESSION ]);
8423 when Pragma_Interface =>
8430 Check_At_Least_N_Arguments (2);
8431 Check_At_Most_N_Arguments (4);
8432 Process_Import_Or_Interface;
8434 -- In Ada 2005, the permission to use Interface (a reserved word)
8435 -- as a pragma name is considered an obsolescent feature.
8437 if Ada_Version >= Ada_2005 then
8439 (No_Obsolescent_Features, Pragma_Identifier (N));
8442 --------------------
8443 -- Interface_Name --
8444 --------------------
8446 -- pragma Interface_Name (
8447 -- [ Entity =>] local_NAME
8448 -- [,[External_Name =>] static_string_EXPRESSION ]
8449 -- [,[Link_Name =>] static_string_EXPRESSION ]);
8451 when Pragma_Interface_Name => Interface_Name : declare
8460 ((Name_Entity, Name_External_Name, Name_Link_Name));
8461 Check_At_Least_N_Arguments (2);
8462 Check_At_Most_N_Arguments (3);
8463 Id := Expression (Arg1);
8466 if not Is_Entity_Name (Id) then
8468 ("first argument for pragma% must be entity name", Arg1);
8469 elsif Etype (Id) = Any_Type then
8472 Def_Id := Entity (Id);
8475 -- Special DEC-compatible processing for the object case, forces
8476 -- object to be imported.
8478 if Ekind (Def_Id) = E_Variable then
8479 Kill_Size_Check_Code (Def_Id);
8480 Note_Possible_Modification (Id, Sure => False);
8482 -- Initialization is not allowed for imported variable
8484 if Present (Expression (Parent (Def_Id)))
8485 and then Comes_From_Source (Expression (Parent (Def_Id)))
8487 Error_Msg_Sloc := Sloc (Def_Id);
8489 ("no initialization allowed for declaration of& #",
8493 -- For compatibility, support VADS usage of providing both
8494 -- pragmas Interface and Interface_Name to obtain the effect
8495 -- of a single Import pragma.
8497 if Is_Imported (Def_Id)
8498 and then Present (First_Rep_Item (Def_Id))
8499 and then Nkind (First_Rep_Item (Def_Id)) = N_Pragma
8501 Pragma_Name (First_Rep_Item (Def_Id)) = Name_Interface
8505 Set_Imported (Def_Id);
8508 Set_Is_Public (Def_Id);
8509 Process_Interface_Name (Def_Id, Arg2, Arg3);
8512 -- Otherwise must be subprogram
8514 elsif not Is_Subprogram (Def_Id) then
8516 ("argument of pragma% is not subprogram", Arg1);
8519 Check_At_Most_N_Arguments (3);
8523 -- Loop through homonyms
8526 Def_Id := Get_Base_Subprogram (Hom_Id);
8528 if Is_Imported (Def_Id) then
8529 Process_Interface_Name (Def_Id, Arg2, Arg3);
8533 Hom_Id := Homonym (Hom_Id);
8535 exit when No (Hom_Id)
8536 or else Scope (Hom_Id) /= Current_Scope;
8541 ("argument of pragma% is not imported subprogram",
8547 -----------------------
8548 -- Interrupt_Handler --
8549 -----------------------
8551 -- pragma Interrupt_Handler (handler_NAME);
8553 when Pragma_Interrupt_Handler =>
8554 Check_Ada_83_Warning;
8555 Check_Arg_Count (1);
8556 Check_No_Identifiers;
8558 if No_Run_Time_Mode then
8559 Error_Msg_CRT ("Interrupt_Handler pragma", N);
8561 Check_Interrupt_Or_Attach_Handler;
8562 Process_Interrupt_Or_Attach_Handler;
8565 ------------------------
8566 -- Interrupt_Priority --
8567 ------------------------
8569 -- pragma Interrupt_Priority [(EXPRESSION)];
8571 when Pragma_Interrupt_Priority => Interrupt_Priority : declare
8572 P : constant Node_Id := Parent (N);
8576 Check_Ada_83_Warning;
8578 if Arg_Count /= 0 then
8579 Arg := Expression (Arg1);
8580 Check_Arg_Count (1);
8581 Check_No_Identifiers;
8583 -- The expression must be analyzed in the special manner
8584 -- described in "Handling of Default and Per-Object
8585 -- Expressions" in sem.ads.
8587 Preanalyze_Spec_Expression (Arg, RTE (RE_Interrupt_Priority));
8590 if not Nkind_In (P, N_Task_Definition, N_Protected_Definition) then
8594 elsif Has_Priority_Pragma (P) then
8595 Error_Pragma ("duplicate pragma% not allowed");
8598 Set_Has_Priority_Pragma (P, True);
8599 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
8601 end Interrupt_Priority;
8603 ---------------------
8604 -- Interrupt_State --
8605 ---------------------
8607 -- pragma Interrupt_State (
8608 -- [Name =>] INTERRUPT_ID,
8609 -- [State =>] INTERRUPT_STATE);
8611 -- INTERRUPT_ID => IDENTIFIER | static_integer_EXPRESSION
8612 -- INTERRUPT_STATE => System | Runtime | User
8614 -- Note: if the interrupt id is given as an identifier, then it must
8615 -- be one of the identifiers in Ada.Interrupts.Names. Otherwise it is
8616 -- given as a static integer expression which must be in the range of
8617 -- Ada.Interrupts.Interrupt_ID.
8619 when Pragma_Interrupt_State => Interrupt_State : declare
8621 Int_Id : constant Entity_Id := RTE (RE_Interrupt_ID);
8622 -- This is the entity Ada.Interrupts.Interrupt_ID;
8624 State_Type : Character;
8625 -- Set to 's'/'r'/'u' for System/Runtime/User
8628 -- Index to entry in Interrupt_States table
8631 -- Value of interrupt
8633 Arg1X : constant Node_Id := Get_Pragma_Arg (Arg1);
8634 -- The first argument to the pragma
8636 Int_Ent : Entity_Id;
8637 -- Interrupt entity in Ada.Interrupts.Names
8641 Check_Arg_Order ((Name_Name, Name_State));
8642 Check_Arg_Count (2);
8644 Check_Optional_Identifier (Arg1, Name_Name);
8645 Check_Optional_Identifier (Arg2, Name_State);
8646 Check_Arg_Is_Identifier (Arg2);
8648 -- First argument is identifier
8650 if Nkind (Arg1X) = N_Identifier then
8652 -- Search list of names in Ada.Interrupts.Names
8654 Int_Ent := First_Entity (RTE (RE_Names));
8656 if No (Int_Ent) then
8657 Error_Pragma_Arg ("invalid interrupt name", Arg1);
8659 elsif Chars (Int_Ent) = Chars (Arg1X) then
8660 Int_Val := Expr_Value (Constant_Value (Int_Ent));
8664 Next_Entity (Int_Ent);
8667 -- First argument is not an identifier, so it must be a static
8668 -- expression of type Ada.Interrupts.Interrupt_ID.
8671 Check_Arg_Is_Static_Expression (Arg1, Any_Integer);
8672 Int_Val := Expr_Value (Arg1X);
8674 if Int_Val < Expr_Value (Type_Low_Bound (Int_Id))
8676 Int_Val > Expr_Value (Type_High_Bound (Int_Id))
8679 ("value not in range of type " &
8680 """Ada.Interrupts.Interrupt_'I'D""", Arg1);
8686 case Chars (Get_Pragma_Arg (Arg2)) is
8687 when Name_Runtime => State_Type := 'r';
8688 when Name_System => State_Type := 's';
8689 when Name_User => State_Type := 'u';
8692 Error_Pragma_Arg ("invalid interrupt state", Arg2);
8695 -- Check if entry is already stored
8697 IST_Num := Interrupt_States.First;
8699 -- If entry not found, add it
8701 if IST_Num > Interrupt_States.Last then
8702 Interrupt_States.Append
8703 ((Interrupt_Number => UI_To_Int (Int_Val),
8704 Interrupt_State => State_Type,
8705 Pragma_Loc => Loc));
8708 -- Case of entry for the same entry
8710 elsif Int_Val = Interrupt_States.Table (IST_Num).
8713 -- If state matches, done, no need to make redundant entry
8716 State_Type = Interrupt_States.Table (IST_Num).
8719 -- Otherwise if state does not match, error
8722 Interrupt_States.Table (IST_Num).Pragma_Loc;
8724 ("state conflicts with that given #", Arg2);
8728 IST_Num := IST_Num + 1;
8730 end Interrupt_State;
8732 ----------------------
8733 -- Java_Constructor --
8734 ----------------------
8736 -- pragma Java_Constructor ([Entity =>] LOCAL_NAME);
8738 -- Also handles pragma CIL_Constructor
8740 when Pragma_CIL_Constructor | Pragma_Java_Constructor =>
8741 Java_Constructor : declare
8745 Convention : Convention_Id;
8749 Check_Arg_Count (1);
8750 Check_Optional_Identifier (Arg1, Name_Entity);
8751 Check_Arg_Is_Local_Name (Arg1);
8753 Id := Expression (Arg1);
8754 Find_Program_Unit_Name (Id);
8756 -- If we did not find the name, we are done
8758 if Etype (Id) = Any_Type then
8763 when Pragma_CIL_Constructor => Convention := Convention_CIL;
8764 when Pragma_Java_Constructor => Convention := Convention_Java;
8765 when others => null;
8768 Hom_Id := Entity (Id);
8770 -- Loop through homonyms
8773 Def_Id := Get_Base_Subprogram (Hom_Id);
8775 -- The constructor is required to be a function returning an
8776 -- access type whose designated type has convention Java/CIL.
8778 if Ekind (Def_Id) = E_Function
8780 (Is_Value_Type (Etype (Def_Id))
8782 (Ekind (Etype (Def_Id)) = E_Access_Subprogram_Type
8784 Atree.Convention (Etype (Def_Id)) = Convention)
8786 (Ekind (Etype (Def_Id)) in Access_Kind
8789 (Designated_Type (Etype (Def_Id))) = Convention
8792 (Root_Type (Designated_Type (Etype (Def_Id)))) =
8795 Set_Is_Constructor (Def_Id);
8796 Set_Convention (Def_Id, Convention);
8797 Set_Is_Imported (Def_Id);
8800 if Convention = Convention_Java then
8802 ("pragma% requires function returning a " &
8803 "'Java access type", Arg1);
8805 pragma Assert (Convention = Convention_CIL);
8807 ("pragma% requires function returning a " &
8808 "'C'I'L access type", Arg1);
8812 Hom_Id := Homonym (Hom_Id);
8814 exit when No (Hom_Id) or else Scope (Hom_Id) /= Current_Scope;
8816 end Java_Constructor;
8818 ----------------------
8819 -- Java_Interface --
8820 ----------------------
8822 -- pragma Java_Interface ([Entity =>] LOCAL_NAME);
8824 when Pragma_Java_Interface => Java_Interface : declare
8830 Check_Arg_Count (1);
8831 Check_Optional_Identifier (Arg1, Name_Entity);
8832 Check_Arg_Is_Local_Name (Arg1);
8834 Arg := Expression (Arg1);
8837 if Etype (Arg) = Any_Type then
8841 if not Is_Entity_Name (Arg)
8842 or else not Is_Type (Entity (Arg))
8844 Error_Pragma_Arg ("pragma% requires a type mark", Arg1);
8847 Typ := Underlying_Type (Entity (Arg));
8849 -- For now simply check some of the semantic constraints on the
8850 -- type. This currently leaves out some restrictions on interface
8851 -- types, namely that the parent type must be java.lang.Object.Typ
8852 -- and that all primitives of the type should be declared
8855 if not Is_Tagged_Type (Typ) or else not Is_Abstract_Type (Typ) then
8856 Error_Pragma_Arg ("pragma% requires an abstract "
8857 & "tagged type", Arg1);
8859 elsif not Has_Discriminants (Typ)
8860 or else Ekind (Etype (First_Discriminant (Typ)))
8861 /= E_Anonymous_Access_Type
8863 not Is_Class_Wide_Type
8864 (Designated_Type (Etype (First_Discriminant (Typ))))
8867 ("type must have a class-wide access discriminant", Arg1);
8875 -- pragma Keep_Names ([On => ] local_NAME);
8877 when Pragma_Keep_Names => Keep_Names : declare
8882 Check_Arg_Count (1);
8883 Check_Optional_Identifier (Arg1, Name_On);
8884 Check_Arg_Is_Local_Name (Arg1);
8886 Arg := Expression (Arg1);
8889 if Etype (Arg) = Any_Type then
8893 if not Is_Entity_Name (Arg)
8894 or else Ekind (Entity (Arg)) /= E_Enumeration_Type
8897 ("pragma% requires a local enumeration type", Arg1);
8900 Set_Discard_Names (Entity (Arg), False);
8907 -- pragma License (RESTRICTED | UNRESTRICTED | GPL | MODIFIED_GPL);
8909 when Pragma_License =>
8911 Check_Arg_Count (1);
8912 Check_No_Identifiers;
8913 Check_Valid_Configuration_Pragma;
8914 Check_Arg_Is_Identifier (Arg1);
8917 Sind : constant Source_File_Index :=
8918 Source_Index (Current_Sem_Unit);
8921 case Chars (Get_Pragma_Arg (Arg1)) is
8923 Set_License (Sind, GPL);
8925 when Name_Modified_GPL =>
8926 Set_License (Sind, Modified_GPL);
8928 when Name_Restricted =>
8929 Set_License (Sind, Restricted);
8931 when Name_Unrestricted =>
8932 Set_License (Sind, Unrestricted);
8935 Error_Pragma_Arg ("invalid license name", Arg1);
8943 -- pragma Link_With (string_EXPRESSION {, string_EXPRESSION});
8945 when Pragma_Link_With => Link_With : declare
8951 if Operating_Mode = Generate_Code
8952 and then In_Extended_Main_Source_Unit (N)
8954 Check_At_Least_N_Arguments (1);
8955 Check_No_Identifiers;
8956 Check_Is_In_Decl_Part_Or_Package_Spec;
8957 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
8961 while Present (Arg) loop
8962 Check_Arg_Is_Static_Expression (Arg, Standard_String);
8964 -- Store argument, converting sequences of spaces to a
8965 -- single null character (this is one of the differences
8966 -- in processing between Link_With and Linker_Options).
8969 C : constant Char_Code := Get_Char_Code (' ');
8970 S : constant String_Id :=
8971 Strval (Expr_Value_S (Expression (Arg)));
8972 L : constant Nat := String_Length (S);
8975 procedure Skip_Spaces;
8976 -- Advance F past any spaces
8982 procedure Skip_Spaces is
8984 while F <= L and then Get_String_Char (S, F) = C loop
8989 -- Start of processing for Arg_Store
8992 Skip_Spaces; -- skip leading spaces
8994 -- Loop through characters, changing any embedded
8995 -- sequence of spaces to a single null character (this
8996 -- is how Link_With/Linker_Options differ)
8999 if Get_String_Char (S, F) = C then
9002 Store_String_Char (ASCII.NUL);
9005 Store_String_Char (Get_String_Char (S, F));
9013 if Present (Arg) then
9014 Store_String_Char (ASCII.NUL);
9018 Store_Linker_Option_String (End_String);
9026 -- pragma Linker_Alias (
9027 -- [Entity =>] LOCAL_NAME
9028 -- [Target =>] static_string_EXPRESSION);
9030 when Pragma_Linker_Alias =>
9032 Check_Arg_Order ((Name_Entity, Name_Target));
9033 Check_Arg_Count (2);
9034 Check_Optional_Identifier (Arg1, Name_Entity);
9035 Check_Optional_Identifier (Arg2, Name_Target);
9036 Check_Arg_Is_Library_Level_Local_Name (Arg1);
9037 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
9039 -- The only processing required is to link this item on to the
9040 -- list of rep items for the given entity. This is accomplished
9041 -- by the call to Rep_Item_Too_Late (when no error is detected
9042 -- and False is returned).
9044 if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
9047 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
9050 ------------------------
9051 -- Linker_Constructor --
9052 ------------------------
9054 -- pragma Linker_Constructor (procedure_LOCAL_NAME);
9056 -- Code is shared with Linker_Destructor
9058 -----------------------
9059 -- Linker_Destructor --
9060 -----------------------
9062 -- pragma Linker_Destructor (procedure_LOCAL_NAME);
9064 when Pragma_Linker_Constructor |
9065 Pragma_Linker_Destructor =>
9066 Linker_Constructor : declare
9072 Check_Arg_Count (1);
9073 Check_No_Identifiers;
9074 Check_Arg_Is_Local_Name (Arg1);
9075 Arg1_X := Expression (Arg1);
9077 Proc := Find_Unique_Parameterless_Procedure (Arg1_X, Arg1);
9079 if not Is_Library_Level_Entity (Proc) then
9081 ("argument for pragma% must be library level entity", Arg1);
9084 -- The only processing required is to link this item on to the
9085 -- list of rep items for the given entity. This is accomplished
9086 -- by the call to Rep_Item_Too_Late (when no error is detected
9087 -- and False is returned).
9089 if Rep_Item_Too_Late (Proc, N) then
9092 Set_Has_Gigi_Rep_Item (Proc);
9094 end Linker_Constructor;
9096 --------------------
9097 -- Linker_Options --
9098 --------------------
9100 -- pragma Linker_Options (string_EXPRESSION {, string_EXPRESSION});
9102 when Pragma_Linker_Options => Linker_Options : declare
9106 Check_Ada_83_Warning;
9107 Check_No_Identifiers;
9108 Check_Arg_Count (1);
9109 Check_Is_In_Decl_Part_Or_Package_Spec;
9110 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
9111 Start_String (Strval (Expr_Value_S (Expression (Arg1))));
9114 while Present (Arg) loop
9115 Check_Arg_Is_Static_Expression (Arg, Standard_String);
9116 Store_String_Char (ASCII.NUL);
9117 Store_String_Chars (Strval (Expr_Value_S (Expression (Arg))));
9121 if Operating_Mode = Generate_Code
9122 and then In_Extended_Main_Source_Unit (N)
9124 Store_Linker_Option_String (End_String);
9128 --------------------
9129 -- Linker_Section --
9130 --------------------
9132 -- pragma Linker_Section (
9133 -- [Entity =>] LOCAL_NAME
9134 -- [Section =>] static_string_EXPRESSION);
9136 when Pragma_Linker_Section =>
9138 Check_Arg_Order ((Name_Entity, Name_Section));
9139 Check_Arg_Count (2);
9140 Check_Optional_Identifier (Arg1, Name_Entity);
9141 Check_Optional_Identifier (Arg2, Name_Section);
9142 Check_Arg_Is_Library_Level_Local_Name (Arg1);
9143 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
9145 -- This pragma applies only to objects
9147 if not Is_Object (Entity (Expression (Arg1))) then
9148 Error_Pragma_Arg ("pragma% applies only to objects", Arg1);
9151 -- The only processing required is to link this item on to the
9152 -- list of rep items for the given entity. This is accomplished
9153 -- by the call to Rep_Item_Too_Late (when no error is detected
9154 -- and False is returned).
9156 if Rep_Item_Too_Late (Entity (Expression (Arg1)), N) then
9159 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
9166 -- pragma List (On | Off)
9168 -- There is nothing to do here, since we did all the processing for
9169 -- this pragma in Par.Prag (so that it works properly even in syntax
9175 --------------------
9176 -- Locking_Policy --
9177 --------------------
9179 -- pragma Locking_Policy (policy_IDENTIFIER);
9181 when Pragma_Locking_Policy => declare
9185 Check_Ada_83_Warning;
9186 Check_Arg_Count (1);
9187 Check_No_Identifiers;
9188 Check_Arg_Is_Locking_Policy (Arg1);
9189 Check_Valid_Configuration_Pragma;
9190 Get_Name_String (Chars (Expression (Arg1)));
9191 LP := Fold_Upper (Name_Buffer (1));
9193 if Locking_Policy /= ' '
9194 and then Locking_Policy /= LP
9196 Error_Msg_Sloc := Locking_Policy_Sloc;
9197 Error_Pragma ("locking policy incompatible with policy#");
9199 -- Set new policy, but always preserve System_Location since we
9200 -- like the error message with the run time name.
9203 Locking_Policy := LP;
9205 if Locking_Policy_Sloc /= System_Location then
9206 Locking_Policy_Sloc := Loc;
9215 -- pragma Long_Float (D_Float | G_Float);
9217 when Pragma_Long_Float =>
9219 Check_Valid_Configuration_Pragma;
9220 Check_Arg_Count (1);
9221 Check_No_Identifier (Arg1);
9222 Check_Arg_Is_One_Of (Arg1, Name_D_Float, Name_G_Float);
9224 if not OpenVMS_On_Target then
9225 Error_Pragma ("?pragma% ignored (applies only to Open'V'M'S)");
9230 if Chars (Expression (Arg1)) = Name_D_Float then
9231 if Opt.Float_Format_Long = 'G' then
9232 Error_Pragma ("G_Float previously specified");
9235 Opt.Float_Format_Long := 'D';
9237 -- G_Float case (this is the default, does not need overriding)
9240 if Opt.Float_Format_Long = 'D' then
9241 Error_Pragma ("D_Float previously specified");
9244 Opt.Float_Format_Long := 'G';
9247 Set_Standard_Fpt_Formats;
9249 -----------------------
9250 -- Machine_Attribute --
9251 -----------------------
9253 -- pragma Machine_Attribute (
9254 -- [Entity =>] LOCAL_NAME,
9255 -- [Attribute_Name =>] static_string_EXPRESSION
9256 -- [, [Info =>] static_EXPRESSION] );
9258 when Pragma_Machine_Attribute => Machine_Attribute : declare
9263 Check_Arg_Order ((Name_Entity, Name_Attribute_Name, Name_Info));
9265 if Arg_Count = 3 then
9266 Check_Optional_Identifier (Arg3, Name_Info);
9267 Check_Arg_Is_Static_Expression (Arg3);
9269 Check_Arg_Count (2);
9272 Check_Optional_Identifier (Arg1, Name_Entity);
9273 Check_Optional_Identifier (Arg2, Name_Attribute_Name);
9274 Check_Arg_Is_Local_Name (Arg1);
9275 Check_Arg_Is_Static_Expression (Arg2, Standard_String);
9276 Def_Id := Entity (Expression (Arg1));
9278 if Is_Access_Type (Def_Id) then
9279 Def_Id := Designated_Type (Def_Id);
9282 if Rep_Item_Too_Early (Def_Id, N) then
9286 Def_Id := Underlying_Type (Def_Id);
9288 -- The only processing required is to link this item on to the
9289 -- list of rep items for the given entity. This is accomplished
9290 -- by the call to Rep_Item_Too_Late (when no error is detected
9291 -- and False is returned).
9293 if Rep_Item_Too_Late (Def_Id, N) then
9296 Set_Has_Gigi_Rep_Item (Entity (Expression (Arg1)));
9298 end Machine_Attribute;
9305 -- (MAIN_OPTION [, MAIN_OPTION]);
9308 -- [STACK_SIZE =>] static_integer_EXPRESSION
9309 -- | [TASK_STACK_SIZE_DEFAULT =>] static_integer_EXPRESSION
9310 -- | [TIME_SLICING_ENABLED =>] static_boolean_EXPRESSION
9312 when Pragma_Main => Main : declare
9313 Args : Args_List (1 .. 3);
9314 Names : constant Name_List (1 .. 3) := (
9316 Name_Task_Stack_Size_Default,
9317 Name_Time_Slicing_Enabled);
9323 Gather_Associations (Names, Args);
9325 for J in 1 .. 2 loop
9326 if Present (Args (J)) then
9327 Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
9331 if Present (Args (3)) then
9332 Check_Arg_Is_Static_Expression (Args (3), Standard_Boolean);
9336 while Present (Nod) loop
9337 if Nkind (Nod) = N_Pragma
9338 and then Pragma_Name (Nod) = Name_Main
9340 Error_Msg_Name_1 := Pname;
9341 Error_Msg_N ("duplicate pragma% not permitted", Nod);
9352 -- pragma Main_Storage
9353 -- (MAIN_STORAGE_OPTION [, MAIN_STORAGE_OPTION]);
9355 -- MAIN_STORAGE_OPTION ::=
9356 -- [WORKING_STORAGE =>] static_SIMPLE_EXPRESSION
9357 -- | [TOP_GUARD =>] static_SIMPLE_EXPRESSION
9359 when Pragma_Main_Storage => Main_Storage : declare
9360 Args : Args_List (1 .. 2);
9361 Names : constant Name_List (1 .. 2) := (
9362 Name_Working_Storage,
9369 Gather_Associations (Names, Args);
9371 for J in 1 .. 2 loop
9372 if Present (Args (J)) then
9373 Check_Arg_Is_Static_Expression (Args (J), Any_Integer);
9377 Check_In_Main_Program;
9380 while Present (Nod) loop
9381 if Nkind (Nod) = N_Pragma
9382 and then Pragma_Name (Nod) = Name_Main_Storage
9384 Error_Msg_Name_1 := Pname;
9385 Error_Msg_N ("duplicate pragma% not permitted", Nod);
9396 -- pragma Memory_Size (NUMERIC_LITERAL)
9398 when Pragma_Memory_Size =>
9401 -- Memory size is simply ignored
9403 Check_No_Identifiers;
9404 Check_Arg_Count (1);
9405 Check_Arg_Is_Integer_Literal (Arg1);
9413 -- The only correct use of this pragma is on its own in a file, in
9414 -- which case it is specially processed (see Gnat1drv.Check_Bad_Body
9415 -- and Frontend, which use Sinput.L.Source_File_Is_Pragma_No_Body to
9416 -- check for a file containing nothing but a No_Body pragma). If we
9417 -- attempt to process it during normal semantics processing, it means
9418 -- it was misplaced.
9420 when Pragma_No_Body =>
9428 -- pragma No_Return (procedure_LOCAL_NAME {, procedure_Local_Name});
9430 when Pragma_No_Return => No_Return : declare
9438 Check_At_Least_N_Arguments (1);
9440 -- Loop through arguments of pragma
9443 while Present (Arg) loop
9444 Check_Arg_Is_Local_Name (Arg);
9445 Id := Expression (Arg);
9448 if not Is_Entity_Name (Id) then
9449 Error_Pragma_Arg ("entity name required", Arg);
9452 if Etype (Id) = Any_Type then
9456 -- Loop to find matching procedures
9461 and then Scope (E) = Current_Scope
9463 if Ekind_In (E, E_Procedure, E_Generic_Procedure) then
9466 -- Set flag on any alias as well
9468 if Is_Overloadable (E) and then Present (Alias (E)) then
9469 Set_No_Return (Alias (E));
9479 Error_Pragma_Arg ("no procedure & found for pragma%", Arg);
9490 -- pragma No_Run_Time;
9492 -- Note: this pragma is retained for backwards compatibility. See
9493 -- body of Rtsfind for full details on its handling.
9495 when Pragma_No_Run_Time =>
9497 Check_Valid_Configuration_Pragma;
9498 Check_Arg_Count (0);
9500 No_Run_Time_Mode := True;
9501 Configurable_Run_Time_Mode := True;
9503 -- Set Duration to 32 bits if word size is 32
9505 if Ttypes.System_Word_Size = 32 then
9506 Duration_32_Bits_On_Target := True;
9509 -- Set appropriate restrictions
9511 Set_Restriction (No_Finalization, N);
9512 Set_Restriction (No_Exception_Handlers, N);
9513 Set_Restriction (Max_Tasks, N, 0);
9514 Set_Restriction (No_Tasking, N);
9516 ------------------------
9517 -- No_Strict_Aliasing --
9518 ------------------------
9520 -- pragma No_Strict_Aliasing [([Entity =>] type_LOCAL_NAME)];
9522 when Pragma_No_Strict_Aliasing => No_Strict_Aliasing : declare
9527 Check_At_Most_N_Arguments (1);
9529 if Arg_Count = 0 then
9530 Check_Valid_Configuration_Pragma;
9531 Opt.No_Strict_Aliasing := True;
9534 Check_Optional_Identifier (Arg2, Name_Entity);
9535 Check_Arg_Is_Local_Name (Arg1);
9536 E_Id := Entity (Expression (Arg1));
9538 if E_Id = Any_Type then
9540 elsif No (E_Id) or else not Is_Access_Type (E_Id) then
9541 Error_Pragma_Arg ("pragma% requires access type", Arg1);
9544 Set_No_Strict_Aliasing (Implementation_Base_Type (E_Id));
9546 end No_Strict_Aliasing;
9548 -----------------------
9549 -- Normalize_Scalars --
9550 -----------------------
9552 -- pragma Normalize_Scalars;
9554 when Pragma_Normalize_Scalars =>
9555 Check_Ada_83_Warning;
9556 Check_Arg_Count (0);
9557 Check_Valid_Configuration_Pragma;
9559 -- Normalize_Scalars creates false positives in CodePeer, so
9560 -- ignore this pragma in this mode.
9562 if not CodePeer_Mode then
9563 Normalize_Scalars := True;
9564 Init_Or_Norm_Scalars := True;
9571 -- pragma Obsolescent;
9573 -- pragma Obsolescent (
9574 -- [Message =>] static_string_EXPRESSION
9575 -- [,[Version =>] Ada_05]]);
9577 -- pragma Obsolescent (
9579 -- [,[Message =>] static_string_EXPRESSION
9580 -- [,[Version =>] Ada_05]] );
9582 when Pragma_Obsolescent => Obsolescent : declare
9586 procedure Set_Obsolescent (E : Entity_Id);
9587 -- Given an entity Ent, mark it as obsolescent if appropriate
9589 ---------------------
9590 -- Set_Obsolescent --
9591 ---------------------
9593 procedure Set_Obsolescent (E : Entity_Id) is
9602 -- Entity name was given
9604 if Present (Ename) then
9606 -- If entity name matches, we are fine. Save entity in
9607 -- pragma argument, for ASIS use.
9609 if Chars (Ename) = Chars (Ent) then
9610 Set_Entity (Ename, Ent);
9611 Generate_Reference (Ent, Ename);
9613 -- If entity name does not match, only possibility is an
9614 -- enumeration literal from an enumeration type declaration.
9616 elsif Ekind (Ent) /= E_Enumeration_Type then
9618 ("pragma % entity name does not match declaration");
9621 Ent := First_Literal (E);
9625 ("pragma % entity name does not match any " &
9626 "enumeration literal");
9628 elsif Chars (Ent) = Chars (Ename) then
9629 Set_Entity (Ename, Ent);
9630 Generate_Reference (Ent, Ename);
9634 Ent := Next_Literal (Ent);
9640 -- Ent points to entity to be marked
9642 if Arg_Count >= 1 then
9644 -- Deal with static string argument
9646 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
9647 S := Strval (Expression (Arg1));
9649 for J in 1 .. String_Length (S) loop
9650 if not In_Character_Range (Get_String_Char (S, J)) then
9652 ("pragma% argument does not allow wide characters",
9657 Obsolescent_Warnings.Append
9658 ((Ent => Ent, Msg => Strval (Expression (Arg1))));
9660 -- Check for Ada_05 parameter
9662 if Arg_Count /= 1 then
9663 Check_Arg_Count (2);
9666 Argx : constant Node_Id := Get_Pragma_Arg (Arg2);
9669 Check_Arg_Is_Identifier (Argx);
9671 if Chars (Argx) /= Name_Ada_05 then
9672 Error_Msg_Name_2 := Name_Ada_05;
9674 ("only allowed argument for pragma% is %", Argx);
9677 if Ada_Version_Explicit < Ada_05
9678 or else not Warn_On_Ada_2005_Compatibility
9686 -- Set flag if pragma active
9689 Set_Is_Obsolescent (Ent);
9693 end Set_Obsolescent;
9695 -- Start of processing for pragma Obsolescent
9700 Check_At_Most_N_Arguments (3);
9702 -- See if first argument specifies an entity name
9706 (Chars (Arg1) = Name_Entity
9708 Nkind_In (Get_Pragma_Arg (Arg1), N_Character_Literal,
9712 Ename := Get_Pragma_Arg (Arg1);
9714 -- Eliminate first argument, so we can share processing
9718 Arg_Count := Arg_Count - 1;
9720 -- No Entity name argument given
9726 if Arg_Count >= 1 then
9727 Check_Optional_Identifier (Arg1, Name_Message);
9729 if Arg_Count = 2 then
9730 Check_Optional_Identifier (Arg2, Name_Version);
9734 -- Get immediately preceding declaration
9737 while Present (Decl) and then Nkind (Decl) = N_Pragma loop
9741 -- Cases where we do not follow anything other than another pragma
9745 -- First case: library level compilation unit declaration with
9746 -- the pragma immediately following the declaration.
9748 if Nkind (Parent (N)) = N_Compilation_Unit_Aux then
9750 (Defining_Entity (Unit (Parent (Parent (N)))));
9753 -- Case 2: library unit placement for package
9757 Ent : constant Entity_Id := Find_Lib_Unit_Name;
9759 if Is_Package_Or_Generic_Package (Ent) then
9760 Set_Obsolescent (Ent);
9766 -- Cases where we must follow a declaration
9769 if Nkind (Decl) not in N_Declaration
9770 and then Nkind (Decl) not in N_Later_Decl_Item
9771 and then Nkind (Decl) not in N_Generic_Declaration
9772 and then Nkind (Decl) not in N_Renaming_Declaration
9775 ("pragma% misplaced, "
9776 & "must immediately follow a declaration");
9779 Set_Obsolescent (Defining_Entity (Decl));
9789 -- pragma Optimize (Time | Space | Off);
9791 -- The actual check for optimize is done in Gigi. Note that this
9792 -- pragma does not actually change the optimization setting, it
9793 -- simply checks that it is consistent with the pragma.
9795 when Pragma_Optimize =>
9796 Check_No_Identifiers;
9797 Check_Arg_Count (1);
9798 Check_Arg_Is_One_Of (Arg1, Name_Time, Name_Space, Name_Off);
9800 ------------------------
9801 -- Optimize_Alignment --
9802 ------------------------
9804 -- pragma Optimize_Alignment (Time | Space | Off);
9806 when Pragma_Optimize_Alignment => Optimize_Alignment : begin
9808 Check_No_Identifiers;
9809 Check_Arg_Count (1);
9810 Check_Valid_Configuration_Pragma;
9813 Nam : constant Name_Id := Chars (Get_Pragma_Arg (Arg1));
9817 Opt.Optimize_Alignment := 'T';
9819 Opt.Optimize_Alignment := 'S';
9821 Opt.Optimize_Alignment := 'O';
9823 Error_Pragma_Arg ("invalid argument for pragma%", Arg1);
9827 -- Set indication that mode is set locally. If we are in fact in a
9828 -- configuration pragma file, this setting is harmless since the
9829 -- switch will get reset anyway at the start of each unit.
9831 Optimize_Alignment_Local := True;
9832 end Optimize_Alignment;
9838 -- pragma Ordered (first_enumeration_subtype_LOCAL_NAME);
9840 when Pragma_Ordered => Ordered : declare
9841 Assoc : constant Node_Id := Arg1;
9847 Check_No_Identifiers;
9848 Check_Arg_Count (1);
9849 Check_Arg_Is_Local_Name (Arg1);
9851 Type_Id := Expression (Assoc);
9852 Find_Type (Type_Id);
9853 Typ := Entity (Type_Id);
9855 if Typ = Any_Type then
9858 Typ := Underlying_Type (Typ);
9861 if not Is_Enumeration_Type (Typ) then
9862 Error_Pragma ("pragma% must specify enumeration type");
9865 Check_First_Subtype (Arg1);
9866 Set_Has_Pragma_Ordered (Base_Type (Typ));
9873 -- pragma Pack (first_subtype_LOCAL_NAME);
9875 when Pragma_Pack => Pack : declare
9876 Assoc : constant Node_Id := Arg1;
9880 Ignore : Boolean := False;
9883 Check_No_Identifiers;
9884 Check_Arg_Count (1);
9885 Check_Arg_Is_Local_Name (Arg1);
9887 Type_Id := Expression (Assoc);
9888 Find_Type (Type_Id);
9889 Typ := Entity (Type_Id);
9892 or else Rep_Item_Too_Early (Typ, N)
9896 Typ := Underlying_Type (Typ);
9899 if not Is_Array_Type (Typ) and then not Is_Record_Type (Typ) then
9900 Error_Pragma ("pragma% must specify array or record type");
9903 Check_First_Subtype (Arg1);
9905 if Has_Pragma_Pack (Typ) then
9906 Error_Pragma ("duplicate pragma%, only one allowed");
9910 elsif Is_Array_Type (Typ) then
9911 Ctyp := Component_Type (Typ);
9913 -- Ignore pack that does nothing
9915 if Known_Static_Esize (Ctyp)
9916 and then Known_Static_RM_Size (Ctyp)
9917 and then Esize (Ctyp) = RM_Size (Ctyp)
9918 and then (Esize (Ctyp) = 8 or else
9919 Esize (Ctyp) = 16 or else
9920 Esize (Ctyp) = 32 or else
9925 -- Pack not allowed for aliased/atomic components
9927 elsif Has_Aliased_Components (Base_Type (Typ)) then
9928 Error_Pragma ("cannot pack aliased components");
9930 elsif Has_Atomic_Components (Typ)
9931 or else Is_Atomic (Component_Type (Typ))
9933 Error_Pragma ("cannot pack atomic components");
9936 -- If we had an explicit component size given, then we do not
9937 -- let Pack override this given size. We also give a warning
9938 -- that Pack is being ignored unless we can tell for sure that
9939 -- the Pack would not have had any effect anyway.
9941 if Has_Component_Size_Clause (Typ) then
9942 if Known_Static_RM_Size (Component_Type (Typ))
9944 RM_Size (Component_Type (Typ)) = Component_Size (Typ)
9949 ("?pragma% ignored, explicit component size given");
9952 -- If no prior array component size given, Pack is effective
9955 if not Rep_Item_Too_Late (Typ, N) then
9957 -- In the context of static code analysis, we do not need
9958 -- complex front-end expansions related to pragma Pack,
9959 -- so disable handling of pragma Pack in this case.
9961 if CodePeer_Mode then
9964 -- For normal non-VM target, do the packing
9966 elsif VM_Target = No_VM then
9968 Set_Is_Packed (Base_Type (Typ));
9969 Set_Has_Non_Standard_Rep (Base_Type (Typ));
9972 Set_Has_Pragma_Pack (Base_Type (Typ));
9974 -- If we ignore the pack for VM_Targets, then warn about
9975 -- this, except suppress the warning in GNAT mode.
9977 elsif not GNAT_Mode then
9979 ("?pragma% ignored in this configuration");
9984 -- For record types, the pack is always effective
9986 else pragma Assert (Is_Record_Type (Typ));
9987 if not Rep_Item_Too_Late (Typ, N) then
9988 if VM_Target = No_VM then
9989 Set_Is_Packed (Base_Type (Typ));
9990 Set_Has_Pragma_Pack (Base_Type (Typ));
9991 Set_Has_Non_Standard_Rep (Base_Type (Typ));
9993 elsif not GNAT_Mode then
9994 Error_Pragma ("?pragma% ignored in this configuration");
10006 -- There is nothing to do here, since we did all the processing for
10007 -- this pragma in Par.Prag (so that it works properly even in syntax
10010 when Pragma_Page =>
10017 -- pragma Passive [(PASSIVE_FORM)];
10019 -- PASSIVE_FORM ::= Semaphore | No
10021 when Pragma_Passive =>
10024 if Nkind (Parent (N)) /= N_Task_Definition then
10025 Error_Pragma ("pragma% must be within task definition");
10028 if Arg_Count /= 0 then
10029 Check_Arg_Count (1);
10030 Check_Arg_Is_One_Of (Arg1, Name_Semaphore, Name_No);
10033 ----------------------------------
10034 -- Preelaborable_Initialization --
10035 ----------------------------------
10037 -- pragma Preelaborable_Initialization (DIRECT_NAME);
10039 when Pragma_Preelaborable_Initialization => Preelab_Init : declare
10044 Check_Arg_Count (1);
10045 Check_No_Identifiers;
10046 Check_Arg_Is_Identifier (Arg1);
10047 Check_Arg_Is_Local_Name (Arg1);
10048 Check_First_Subtype (Arg1);
10049 Ent := Entity (Expression (Arg1));
10051 if not Is_Private_Type (Ent)
10052 and then not Is_Protected_Type (Ent)
10055 ("pragma % can only be applied to private or protected type",
10059 -- Give an error if the pragma is applied to a protected type that
10060 -- does not qualify (due to having entries, or due to components
10061 -- that do not qualify).
10063 if Is_Protected_Type (Ent)
10064 and then not Has_Preelaborable_Initialization (Ent)
10067 ("protected type & does not have preelaborable " &
10068 "initialization", Ent);
10070 -- Otherwise mark the type as definitely having preelaborable
10074 Set_Known_To_Have_Preelab_Init (Ent);
10077 if Has_Pragma_Preelab_Init (Ent)
10078 and then Warn_On_Redundant_Constructs
10080 Error_Pragma ("?duplicate pragma%!");
10082 Set_Has_Pragma_Preelab_Init (Ent);
10086 --------------------
10087 -- Persistent_BSS --
10088 --------------------
10090 when Pragma_Persistent_BSS => Persistent_BSS : declare
10097 Check_At_Most_N_Arguments (1);
10099 -- Case of application to specific object (one argument)
10101 if Arg_Count = 1 then
10102 Check_Arg_Is_Library_Level_Local_Name (Arg1);
10104 if not Is_Entity_Name (Expression (Arg1))
10106 (Ekind (Entity (Expression (Arg1))) /= E_Variable
10107 and then Ekind (Entity (Expression (Arg1))) /= E_Constant)
10109 Error_Pragma_Arg ("pragma% only applies to objects", Arg1);
10112 Ent := Entity (Expression (Arg1));
10113 Decl := Parent (Ent);
10115 if Rep_Item_Too_Late (Ent, N) then
10119 if Present (Expression (Decl)) then
10121 ("object for pragma% cannot have initialization", Arg1);
10124 if not Is_Potentially_Persistent_Type (Etype (Ent)) then
10126 ("object type for pragma% is not potentially persistent",
10131 Make_Linker_Section_Pragma
10132 (Ent, Sloc (N), ".persistent.bss");
10133 Insert_After (N, Prag);
10136 -- Case of use as configuration pragma with no arguments
10139 Check_Valid_Configuration_Pragma;
10140 Persistent_BSS_Mode := True;
10142 end Persistent_BSS;
10148 -- pragma Polling (ON | OFF);
10150 when Pragma_Polling =>
10152 Check_Arg_Count (1);
10153 Check_No_Identifiers;
10154 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
10155 Polling_Required := (Chars (Expression (Arg1)) = Name_On);
10157 -------------------
10158 -- Postcondition --
10159 -------------------
10161 -- pragma Postcondition ([Check =>] Boolean_Expression
10162 -- [,[Message =>] String_Expression]);
10164 when Pragma_Postcondition => Postcondition : declare
10166 pragma Warnings (Off, In_Body);
10170 Check_At_Least_N_Arguments (1);
10171 Check_At_Most_N_Arguments (2);
10172 Check_Optional_Identifier (Arg1, Name_Check);
10174 -- All we need to do here is call the common check procedure,
10175 -- the remainder of the processing is found in Sem_Ch6/Sem_Ch7.
10177 Check_Precondition_Postcondition (In_Body);
10184 -- pragma Precondition ([Check =>] Boolean_Expression
10185 -- [,[Message =>] String_Expression]);
10187 when Pragma_Precondition => Precondition : declare
10192 Check_At_Least_N_Arguments (1);
10193 Check_At_Most_N_Arguments (2);
10194 Check_Optional_Identifier (Arg1, Name_Check);
10196 Check_Precondition_Postcondition (In_Body);
10198 -- If in spec, nothing more to do. If in body, then we convert the
10199 -- pragma to pragma Check (Precondition, cond [, msg]). Note we do
10200 -- this whether or not precondition checks are enabled. That works
10201 -- fine since pragma Check will do this check, and will also
10202 -- analyze the condition itself in the proper context.
10205 if Arg_Count = 2 then
10206 Check_Optional_Identifier (Arg3, Name_Message);
10207 Analyze_And_Resolve (Get_Pragma_Arg (Arg2), Standard_String);
10212 Chars => Name_Check,
10213 Pragma_Argument_Associations => New_List (
10214 Make_Pragma_Argument_Association (Loc,
10216 Make_Identifier (Loc,
10217 Chars => Name_Precondition)),
10219 Make_Pragma_Argument_Association (Sloc (Arg1),
10220 Expression => Relocate_Node (Get_Pragma_Arg (Arg1))))));
10222 if Arg_Count = 2 then
10223 Append_To (Pragma_Argument_Associations (N),
10224 Make_Pragma_Argument_Association (Sloc (Arg2),
10225 Expression => Relocate_Node (Get_Pragma_Arg (Arg2))));
10236 -- pragma Preelaborate [(library_unit_NAME)];
10238 -- Set the flag Is_Preelaborated of program unit name entity
10240 when Pragma_Preelaborate => Preelaborate : declare
10241 Pa : constant Node_Id := Parent (N);
10242 Pk : constant Node_Kind := Nkind (Pa);
10246 Check_Ada_83_Warning;
10247 Check_Valid_Library_Unit_Pragma;
10249 if Nkind (N) = N_Null_Statement then
10253 Ent := Find_Lib_Unit_Name;
10255 -- This filters out pragmas inside generic parent then
10256 -- show up inside instantiation
10259 and then not (Pk = N_Package_Specification
10260 and then Present (Generic_Parent (Pa)))
10262 if not Debug_Flag_U then
10263 Set_Is_Preelaborated (Ent);
10264 Set_Suppress_Elaboration_Warnings (Ent);
10269 ---------------------
10270 -- Preelaborate_05 --
10271 ---------------------
10273 -- pragma Preelaborate_05 [(library_unit_NAME)];
10275 -- This pragma is useable only in GNAT_Mode, where it is used like
10276 -- pragma Preelaborate but it is only effective in Ada 2005 mode
10277 -- (otherwise it is ignored). This is used to implement AI-362 which
10278 -- recategorizes some run-time packages in Ada 2005 mode.
10280 when Pragma_Preelaborate_05 => Preelaborate_05 : declare
10285 Check_Valid_Library_Unit_Pragma;
10287 if not GNAT_Mode then
10288 Error_Pragma ("pragma% only available in GNAT mode");
10291 if Nkind (N) = N_Null_Statement then
10295 -- This is one of the few cases where we need to test the value of
10296 -- Ada_Version_Explicit rather than Ada_Version (which is always
10297 -- set to Ada_12 in a predefined unit), we need to know the
10298 -- explicit version set to know if this pragma is active.
10300 if Ada_Version_Explicit >= Ada_05 then
10301 Ent := Find_Lib_Unit_Name;
10302 Set_Is_Preelaborated (Ent);
10303 Set_Suppress_Elaboration_Warnings (Ent);
10305 end Preelaborate_05;
10311 -- pragma Priority (EXPRESSION);
10313 when Pragma_Priority => Priority : declare
10314 P : constant Node_Id := Parent (N);
10318 Check_No_Identifiers;
10319 Check_Arg_Count (1);
10323 if Nkind (P) = N_Subprogram_Body then
10324 Check_In_Main_Program;
10326 Arg := Expression (Arg1);
10327 Analyze_And_Resolve (Arg, Standard_Integer);
10331 if not Is_Static_Expression (Arg) then
10332 Flag_Non_Static_Expr
10333 ("main subprogram priority is not static!", Arg);
10336 -- If constraint error, then we already signalled an error
10338 elsif Raises_Constraint_Error (Arg) then
10341 -- Otherwise check in range
10345 Val : constant Uint := Expr_Value (Arg);
10349 or else Val > Expr_Value (Expression
10350 (Parent (RTE (RE_Max_Priority))))
10353 ("main subprogram priority is out of range", Arg1);
10359 (Current_Sem_Unit, UI_To_Int (Expr_Value (Arg)));
10361 -- Load an arbitrary entity from System.Tasking to make sure
10362 -- this package is implicitly with'ed, since we need to have
10363 -- the tasking run-time active for the pragma Priority to have
10367 Discard : Entity_Id;
10368 pragma Warnings (Off, Discard);
10370 Discard := RTE (RE_Task_List);
10373 -- Task or Protected, must be of type Integer
10375 elsif Nkind_In (P, N_Protected_Definition, N_Task_Definition) then
10376 Arg := Expression (Arg1);
10378 -- The expression must be analyzed in the special manner
10379 -- described in "Handling of Default and Per-Object
10380 -- Expressions" in sem.ads.
10382 Preanalyze_Spec_Expression (Arg, Standard_Integer);
10384 if not Is_Static_Expression (Arg) then
10385 Check_Restriction (Static_Priorities, Arg);
10388 -- Anything else is incorrect
10394 if Has_Priority_Pragma (P) then
10395 Error_Pragma ("duplicate pragma% not allowed");
10397 Set_Has_Priority_Pragma (P, True);
10399 if Nkind_In (P, N_Protected_Definition, N_Task_Definition) then
10400 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
10401 -- exp_ch9 should use this ???
10406 -----------------------------------
10407 -- Priority_Specific_Dispatching --
10408 -----------------------------------
10410 -- pragma Priority_Specific_Dispatching (
10411 -- policy_IDENTIFIER,
10412 -- first_priority_EXPRESSION,
10413 -- last_priority_EXPRESSION);
10415 when Pragma_Priority_Specific_Dispatching =>
10416 Priority_Specific_Dispatching : declare
10417 Prio_Id : constant Entity_Id := RTE (RE_Any_Priority);
10418 -- This is the entity System.Any_Priority;
10421 Lower_Bound : Node_Id;
10422 Upper_Bound : Node_Id;
10428 Check_Arg_Count (3);
10429 Check_No_Identifiers;
10430 Check_Arg_Is_Task_Dispatching_Policy (Arg1);
10431 Check_Valid_Configuration_Pragma;
10432 Get_Name_String (Chars (Expression (Arg1)));
10433 DP := Fold_Upper (Name_Buffer (1));
10435 Lower_Bound := Expression (Arg2);
10436 Check_Arg_Is_Static_Expression (Lower_Bound, Standard_Integer);
10437 Lower_Val := Expr_Value (Lower_Bound);
10439 Upper_Bound := Expression (Arg3);
10440 Check_Arg_Is_Static_Expression (Upper_Bound, Standard_Integer);
10441 Upper_Val := Expr_Value (Upper_Bound);
10443 -- It is not allowed to use Task_Dispatching_Policy and
10444 -- Priority_Specific_Dispatching in the same partition.
10446 if Task_Dispatching_Policy /= ' ' then
10447 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
10449 ("pragma% incompatible with Task_Dispatching_Policy#");
10451 -- Check lower bound in range
10453 elsif Lower_Val < Expr_Value (Type_Low_Bound (Prio_Id))
10455 Lower_Val > Expr_Value (Type_High_Bound (Prio_Id))
10458 ("first_priority is out of range", Arg2);
10460 -- Check upper bound in range
10462 elsif Upper_Val < Expr_Value (Type_Low_Bound (Prio_Id))
10464 Upper_Val > Expr_Value (Type_High_Bound (Prio_Id))
10467 ("last_priority is out of range", Arg3);
10469 -- Check that the priority range is valid
10471 elsif Lower_Val > Upper_Val then
10473 ("last_priority_expression must be greater than" &
10474 " or equal to first_priority_expression");
10476 -- Store the new policy, but always preserve System_Location since
10477 -- we like the error message with the run-time name.
10480 -- Check overlapping in the priority ranges specified in other
10481 -- Priority_Specific_Dispatching pragmas within the same
10482 -- partition. We can only check those we know about!
10485 Specific_Dispatching.First .. Specific_Dispatching.Last
10487 if Specific_Dispatching.Table (J).First_Priority in
10488 UI_To_Int (Lower_Val) .. UI_To_Int (Upper_Val)
10489 or else Specific_Dispatching.Table (J).Last_Priority in
10490 UI_To_Int (Lower_Val) .. UI_To_Int (Upper_Val)
10493 Specific_Dispatching.Table (J).Pragma_Loc;
10495 ("priority range overlaps with "
10496 & "Priority_Specific_Dispatching#");
10500 -- The use of Priority_Specific_Dispatching is incompatible
10501 -- with Task_Dispatching_Policy.
10503 if Task_Dispatching_Policy /= ' ' then
10504 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
10506 ("Priority_Specific_Dispatching incompatible "
10507 & "with Task_Dispatching_Policy#");
10510 -- The use of Priority_Specific_Dispatching forces ceiling
10513 if Locking_Policy /= ' ' and then Locking_Policy /= 'C' then
10514 Error_Msg_Sloc := Locking_Policy_Sloc;
10516 ("Priority_Specific_Dispatching incompatible "
10517 & "with Locking_Policy#");
10519 -- Set the Ceiling_Locking policy, but preserve System_Location
10520 -- since we like the error message with the run time name.
10523 Locking_Policy := 'C';
10525 if Locking_Policy_Sloc /= System_Location then
10526 Locking_Policy_Sloc := Loc;
10530 -- Add entry in the table
10532 Specific_Dispatching.Append
10533 ((Dispatching_Policy => DP,
10534 First_Priority => UI_To_Int (Lower_Val),
10535 Last_Priority => UI_To_Int (Upper_Val),
10536 Pragma_Loc => Loc));
10538 end Priority_Specific_Dispatching;
10544 -- pragma Profile (profile_IDENTIFIER);
10546 -- profile_IDENTIFIER => Restricted | Ravenscar
10548 when Pragma_Profile =>
10550 Check_Arg_Count (1);
10551 Check_Valid_Configuration_Pragma;
10552 Check_No_Identifiers;
10555 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
10557 if Chars (Argx) = Name_Ravenscar then
10558 Set_Ravenscar_Profile (N);
10559 elsif Chars (Argx) = Name_Restricted then
10560 Set_Profile_Restrictions
10561 (Restricted, N, Warn => Treat_Restrictions_As_Warnings);
10563 Error_Pragma_Arg ("& is not a valid profile", Argx);
10567 ----------------------
10568 -- Profile_Warnings --
10569 ----------------------
10571 -- pragma Profile_Warnings (profile_IDENTIFIER);
10573 -- profile_IDENTIFIER => Restricted | Ravenscar
10575 when Pragma_Profile_Warnings =>
10577 Check_Arg_Count (1);
10578 Check_Valid_Configuration_Pragma;
10579 Check_No_Identifiers;
10582 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
10584 if Chars (Argx) = Name_Ravenscar then
10585 Set_Profile_Restrictions (Ravenscar, N, Warn => True);
10586 elsif Chars (Argx) = Name_Restricted then
10587 Set_Profile_Restrictions (Restricted, N, Warn => True);
10589 Error_Pragma_Arg ("& is not a valid profile", Argx);
10593 --------------------------
10594 -- Propagate_Exceptions --
10595 --------------------------
10597 -- pragma Propagate_Exceptions;
10599 -- Note: this pragma is obsolete and has no effect
10601 when Pragma_Propagate_Exceptions =>
10603 Check_Arg_Count (0);
10605 if In_Extended_Main_Source_Unit (N) then
10606 Propagate_Exceptions := True;
10613 -- pragma Psect_Object (
10614 -- [Internal =>] LOCAL_NAME,
10615 -- [, [External =>] EXTERNAL_SYMBOL]
10616 -- [, [Size =>] EXTERNAL_SYMBOL]);
10618 when Pragma_Psect_Object | Pragma_Common_Object =>
10619 Psect_Object : declare
10620 Args : Args_List (1 .. 3);
10621 Names : constant Name_List (1 .. 3) := (
10626 Internal : Node_Id renames Args (1);
10627 External : Node_Id renames Args (2);
10628 Size : Node_Id renames Args (3);
10630 Def_Id : Entity_Id;
10632 procedure Check_Too_Long (Arg : Node_Id);
10633 -- Posts message if the argument is an identifier with more
10634 -- than 31 characters, or a string literal with more than
10635 -- 31 characters, and we are operating under VMS
10637 --------------------
10638 -- Check_Too_Long --
10639 --------------------
10641 procedure Check_Too_Long (Arg : Node_Id) is
10642 X : constant Node_Id := Original_Node (Arg);
10645 if not Nkind_In (X, N_String_Literal, N_Identifier) then
10647 ("inappropriate argument for pragma %", Arg);
10650 if OpenVMS_On_Target then
10651 if (Nkind (X) = N_String_Literal
10652 and then String_Length (Strval (X)) > 31)
10654 (Nkind (X) = N_Identifier
10655 and then Length_Of_Name (Chars (X)) > 31)
10658 ("argument for pragma % is longer than 31 characters",
10662 end Check_Too_Long;
10664 -- Start of processing for Common_Object/Psect_Object
10668 Gather_Associations (Names, Args);
10669 Process_Extended_Import_Export_Internal_Arg (Internal);
10671 Def_Id := Entity (Internal);
10673 if not Ekind_In (Def_Id, E_Constant, E_Variable) then
10675 ("pragma% must designate an object", Internal);
10678 Check_Too_Long (Internal);
10680 if Is_Imported (Def_Id) or else Is_Exported (Def_Id) then
10682 ("cannot use pragma% for imported/exported object",
10686 if Is_Concurrent_Type (Etype (Internal)) then
10688 ("cannot specify pragma % for task/protected object",
10692 if Has_Rep_Pragma (Def_Id, Name_Common_Object)
10694 Has_Rep_Pragma (Def_Id, Name_Psect_Object)
10696 Error_Msg_N ("?duplicate Common/Psect_Object pragma", N);
10699 if Ekind (Def_Id) = E_Constant then
10701 ("cannot specify pragma % for a constant", Internal);
10704 if Is_Record_Type (Etype (Internal)) then
10710 Ent := First_Entity (Etype (Internal));
10711 while Present (Ent) loop
10712 Decl := Declaration_Node (Ent);
10714 if Ekind (Ent) = E_Component
10715 and then Nkind (Decl) = N_Component_Declaration
10716 and then Present (Expression (Decl))
10717 and then Warn_On_Export_Import
10720 ("?object for pragma % has defaults", Internal);
10730 if Present (Size) then
10731 Check_Too_Long (Size);
10734 if Present (External) then
10735 Check_Arg_Is_External_Name (External);
10736 Check_Too_Long (External);
10739 -- If all error tests pass, link pragma on to the rep item chain
10741 Record_Rep_Item (Def_Id, N);
10748 -- pragma Pure [(library_unit_NAME)];
10750 when Pragma_Pure => Pure : declare
10754 Check_Ada_83_Warning;
10755 Check_Valid_Library_Unit_Pragma;
10757 if Nkind (N) = N_Null_Statement then
10761 Ent := Find_Lib_Unit_Name;
10763 Set_Has_Pragma_Pure (Ent);
10764 Set_Suppress_Elaboration_Warnings (Ent);
10771 -- pragma Pure_05 [(library_unit_NAME)];
10773 -- This pragma is useable only in GNAT_Mode, where it is used like
10774 -- pragma Pure but it is only effective in Ada 2005 mode (otherwise
10775 -- it is ignored). It may be used after a pragma Preelaborate, in
10776 -- which case it overrides the effect of the pragma Preelaborate.
10777 -- This is used to implement AI-362 which recategorizes some run-time
10778 -- packages in Ada 2005 mode.
10780 when Pragma_Pure_05 => Pure_05 : declare
10785 Check_Valid_Library_Unit_Pragma;
10787 if not GNAT_Mode then
10788 Error_Pragma ("pragma% only available in GNAT mode");
10791 if Nkind (N) = N_Null_Statement then
10795 -- This is one of the few cases where we need to test the value of
10796 -- Ada_Version_Explicit rather than Ada_Version (which is always
10797 -- set to Ada_12 in a predefined unit), we need to know the
10798 -- explicit version set to know if this pragma is active.
10800 if Ada_Version_Explicit >= Ada_05 then
10801 Ent := Find_Lib_Unit_Name;
10802 Set_Is_Preelaborated (Ent, False);
10804 Set_Suppress_Elaboration_Warnings (Ent);
10808 -------------------
10809 -- Pure_Function --
10810 -------------------
10812 -- pragma Pure_Function ([Entity =>] function_LOCAL_NAME);
10814 when Pragma_Pure_Function => Pure_Function : declare
10817 Def_Id : Entity_Id;
10818 Effective : Boolean := False;
10822 Check_Arg_Count (1);
10823 Check_Optional_Identifier (Arg1, Name_Entity);
10824 Check_Arg_Is_Local_Name (Arg1);
10825 E_Id := Expression (Arg1);
10827 if Error_Posted (E_Id) then
10831 -- Loop through homonyms (overloadings) of referenced entity
10833 E := Entity (E_Id);
10835 if Present (E) then
10837 Def_Id := Get_Base_Subprogram (E);
10839 if not Ekind_In (Def_Id, E_Function,
10840 E_Generic_Function,
10844 ("pragma% requires a function name", Arg1);
10847 Set_Is_Pure (Def_Id);
10849 if not Has_Pragma_Pure_Function (Def_Id) then
10850 Set_Has_Pragma_Pure_Function (Def_Id);
10855 exit when No (E) or else Scope (E) /= Current_Scope;
10859 and then Warn_On_Redundant_Constructs
10862 ("pragma Pure_Function on& is redundant?",
10868 --------------------
10869 -- Queuing_Policy --
10870 --------------------
10872 -- pragma Queuing_Policy (policy_IDENTIFIER);
10874 when Pragma_Queuing_Policy => declare
10878 Check_Ada_83_Warning;
10879 Check_Arg_Count (1);
10880 Check_No_Identifiers;
10881 Check_Arg_Is_Queuing_Policy (Arg1);
10882 Check_Valid_Configuration_Pragma;
10883 Get_Name_String (Chars (Expression (Arg1)));
10884 QP := Fold_Upper (Name_Buffer (1));
10886 if Queuing_Policy /= ' '
10887 and then Queuing_Policy /= QP
10889 Error_Msg_Sloc := Queuing_Policy_Sloc;
10890 Error_Pragma ("queuing policy incompatible with policy#");
10892 -- Set new policy, but always preserve System_Location since we
10893 -- like the error message with the run time name.
10896 Queuing_Policy := QP;
10898 if Queuing_Policy_Sloc /= System_Location then
10899 Queuing_Policy_Sloc := Loc;
10904 -----------------------
10905 -- Relative_Deadline --
10906 -----------------------
10908 -- pragma Relative_Deadline (time_span_EXPRESSION);
10910 when Pragma_Relative_Deadline => Relative_Deadline : declare
10911 P : constant Node_Id := Parent (N);
10916 Check_No_Identifiers;
10917 Check_Arg_Count (1);
10919 Arg := Expression (Arg1);
10921 -- The expression must be analyzed in the special manner described
10922 -- in "Handling of Default and Per-Object Expressions" in sem.ads.
10924 Preanalyze_Spec_Expression (Arg, RTE (RE_Time_Span));
10928 if Nkind (P) = N_Subprogram_Body then
10929 Check_In_Main_Program;
10933 elsif Nkind (P) = N_Task_Definition then
10936 -- Anything else is incorrect
10942 if Has_Relative_Deadline_Pragma (P) then
10943 Error_Pragma ("duplicate pragma% not allowed");
10945 Set_Has_Relative_Deadline_Pragma (P, True);
10947 if Nkind (P) = N_Task_Definition then
10948 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
10951 end Relative_Deadline;
10953 ---------------------------
10954 -- Remote_Call_Interface --
10955 ---------------------------
10957 -- pragma Remote_Call_Interface [(library_unit_NAME)];
10959 when Pragma_Remote_Call_Interface => Remote_Call_Interface : declare
10960 Cunit_Node : Node_Id;
10961 Cunit_Ent : Entity_Id;
10965 Check_Ada_83_Warning;
10966 Check_Valid_Library_Unit_Pragma;
10968 if Nkind (N) = N_Null_Statement then
10972 Cunit_Node := Cunit (Current_Sem_Unit);
10973 K := Nkind (Unit (Cunit_Node));
10974 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
10976 if K = N_Package_Declaration
10977 or else K = N_Generic_Package_Declaration
10978 or else K = N_Subprogram_Declaration
10979 or else K = N_Generic_Subprogram_Declaration
10980 or else (K = N_Subprogram_Body
10981 and then Acts_As_Spec (Unit (Cunit_Node)))
10986 "pragma% must apply to package or subprogram declaration");
10989 Set_Is_Remote_Call_Interface (Cunit_Ent);
10990 end Remote_Call_Interface;
10996 -- pragma Remote_Types [(library_unit_NAME)];
10998 when Pragma_Remote_Types => Remote_Types : declare
10999 Cunit_Node : Node_Id;
11000 Cunit_Ent : Entity_Id;
11003 Check_Ada_83_Warning;
11004 Check_Valid_Library_Unit_Pragma;
11006 if Nkind (N) = N_Null_Statement then
11010 Cunit_Node := Cunit (Current_Sem_Unit);
11011 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
11013 if not Nkind_In (Unit (Cunit_Node), N_Package_Declaration,
11014 N_Generic_Package_Declaration)
11017 ("pragma% can only apply to a package declaration");
11020 Set_Is_Remote_Types (Cunit_Ent);
11027 -- pragma Ravenscar;
11029 when Pragma_Ravenscar =>
11031 Check_Arg_Count (0);
11032 Check_Valid_Configuration_Pragma;
11033 Set_Ravenscar_Profile (N);
11035 if Warn_On_Obsolescent_Feature then
11036 Error_Msg_N ("pragma Ravenscar is an obsolescent feature?", N);
11037 Error_Msg_N ("|use pragma Profile (Ravenscar) instead", N);
11040 -------------------------
11041 -- Restricted_Run_Time --
11042 -------------------------
11044 -- pragma Restricted_Run_Time;
11046 when Pragma_Restricted_Run_Time =>
11048 Check_Arg_Count (0);
11049 Check_Valid_Configuration_Pragma;
11050 Set_Profile_Restrictions
11051 (Restricted, N, Warn => Treat_Restrictions_As_Warnings);
11053 if Warn_On_Obsolescent_Feature then
11055 ("pragma Restricted_Run_Time is an obsolescent feature?", N);
11056 Error_Msg_N ("|use pragma Profile (Restricted) instead", N);
11063 -- pragma Restrictions (RESTRICTION {, RESTRICTION});
11066 -- restriction_IDENTIFIER
11067 -- | restriction_parameter_IDENTIFIER => EXPRESSION
11069 when Pragma_Restrictions =>
11070 Process_Restrictions_Or_Restriction_Warnings
11071 (Warn => Treat_Restrictions_As_Warnings);
11073 --------------------------
11074 -- Restriction_Warnings --
11075 --------------------------
11077 -- pragma Restriction_Warnings (RESTRICTION {, RESTRICTION});
11080 -- restriction_IDENTIFIER
11081 -- | restriction_parameter_IDENTIFIER => EXPRESSION
11083 when Pragma_Restriction_Warnings =>
11085 Process_Restrictions_Or_Restriction_Warnings (Warn => True);
11091 -- pragma Reviewable;
11093 when Pragma_Reviewable =>
11094 Check_Ada_83_Warning;
11095 Check_Arg_Count (0);
11097 -- Call dummy debugging function rv. This is done to assist front
11098 -- end debugging. By placing a Reviewable pragma in the source
11099 -- program, a breakpoint on rv catches this place in the source,
11100 -- allowing convenient stepping to the point of interest.
11104 --------------------------
11105 -- Short_Circuit_And_Or --
11106 --------------------------
11108 when Pragma_Short_Circuit_And_Or =>
11110 Check_Arg_Count (0);
11111 Check_Valid_Configuration_Pragma;
11112 Short_Circuit_And_Or := True;
11114 -------------------
11115 -- Share_Generic --
11116 -------------------
11118 -- pragma Share_Generic (NAME {, NAME});
11120 when Pragma_Share_Generic =>
11122 Process_Generic_List;
11128 -- pragma Shared (LOCAL_NAME);
11130 when Pragma_Shared =>
11132 Process_Atomic_Shared_Volatile;
11134 --------------------
11135 -- Shared_Passive --
11136 --------------------
11138 -- pragma Shared_Passive [(library_unit_NAME)];
11140 -- Set the flag Is_Shared_Passive of program unit name entity
11142 when Pragma_Shared_Passive => Shared_Passive : declare
11143 Cunit_Node : Node_Id;
11144 Cunit_Ent : Entity_Id;
11147 Check_Ada_83_Warning;
11148 Check_Valid_Library_Unit_Pragma;
11150 if Nkind (N) = N_Null_Statement then
11154 Cunit_Node := Cunit (Current_Sem_Unit);
11155 Cunit_Ent := Cunit_Entity (Current_Sem_Unit);
11157 if not Nkind_In (Unit (Cunit_Node), N_Package_Declaration,
11158 N_Generic_Package_Declaration)
11161 ("pragma% can only apply to a package declaration");
11164 Set_Is_Shared_Passive (Cunit_Ent);
11165 end Shared_Passive;
11167 -----------------------
11168 -- Short_Descriptors --
11169 -----------------------
11171 -- pragma Short_Descriptors;
11173 when Pragma_Short_Descriptors =>
11175 Check_Arg_Count (0);
11176 Check_Valid_Configuration_Pragma;
11177 Short_Descriptors := True;
11179 ----------------------
11180 -- Source_File_Name --
11181 ----------------------
11183 -- There are five forms for this pragma:
11185 -- pragma Source_File_Name (
11186 -- [UNIT_NAME =>] unit_NAME,
11187 -- BODY_FILE_NAME => STRING_LITERAL
11188 -- [, [INDEX =>] INTEGER_LITERAL]);
11190 -- pragma Source_File_Name (
11191 -- [UNIT_NAME =>] unit_NAME,
11192 -- SPEC_FILE_NAME => STRING_LITERAL
11193 -- [, [INDEX =>] INTEGER_LITERAL]);
11195 -- pragma Source_File_Name (
11196 -- BODY_FILE_NAME => STRING_LITERAL
11197 -- [, DOT_REPLACEMENT => STRING_LITERAL]
11198 -- [, CASING => CASING_SPEC]);
11200 -- pragma Source_File_Name (
11201 -- SPEC_FILE_NAME => STRING_LITERAL
11202 -- [, DOT_REPLACEMENT => STRING_LITERAL]
11203 -- [, CASING => CASING_SPEC]);
11205 -- pragma Source_File_Name (
11206 -- SUBUNIT_FILE_NAME => STRING_LITERAL
11207 -- [, DOT_REPLACEMENT => STRING_LITERAL]
11208 -- [, CASING => CASING_SPEC]);
11210 -- CASING_SPEC ::= Uppercase | Lowercase | Mixedcase
11212 -- Pragma Source_File_Name_Project (SFNP) is equivalent to pragma
11213 -- Source_File_Name (SFN), however their usage is exclusive: SFN can
11214 -- only be used when no project file is used, while SFNP can only be
11215 -- used when a project file is used.
11217 -- No processing here. Processing was completed during parsing, since
11218 -- we need to have file names set as early as possible. Units are
11219 -- loaded well before semantic processing starts.
11221 -- The only processing we defer to this point is the check for
11222 -- correct placement.
11224 when Pragma_Source_File_Name =>
11226 Check_Valid_Configuration_Pragma;
11228 ------------------------------
11229 -- Source_File_Name_Project --
11230 ------------------------------
11232 -- See Source_File_Name for syntax
11234 -- No processing here. Processing was completed during parsing, since
11235 -- we need to have file names set as early as possible. Units are
11236 -- loaded well before semantic processing starts.
11238 -- The only processing we defer to this point is the check for
11239 -- correct placement.
11241 when Pragma_Source_File_Name_Project =>
11243 Check_Valid_Configuration_Pragma;
11245 -- Check that a pragma Source_File_Name_Project is used only in a
11246 -- configuration pragmas file.
11248 -- Pragmas Source_File_Name_Project should only be generated by
11249 -- the Project Manager in configuration pragmas files.
11251 -- This is really an ugly test. It seems to depend on some
11252 -- accidental and undocumented property. At the very least it
11253 -- needs to be documented, but it would be better to have a
11254 -- clean way of testing if we are in a configuration file???
11256 if Present (Parent (N)) then
11258 ("pragma% can only appear in a configuration pragmas file");
11261 ----------------------
11262 -- Source_Reference --
11263 ----------------------
11265 -- pragma Source_Reference (INTEGER_LITERAL [, STRING_LITERAL]);
11267 -- Nothing to do, all processing completed in Par.Prag, since we need
11268 -- the information for possible parser messages that are output.
11270 when Pragma_Source_Reference =>
11273 --------------------------------
11274 -- Static_Elaboration_Desired --
11275 --------------------------------
11277 -- pragma Static_Elaboration_Desired (DIRECT_NAME);
11279 when Pragma_Static_Elaboration_Desired =>
11281 Check_At_Most_N_Arguments (1);
11283 if Is_Compilation_Unit (Current_Scope)
11284 and then Ekind (Current_Scope) = E_Package
11286 Set_Static_Elaboration_Desired (Current_Scope, True);
11288 Error_Pragma ("pragma% must apply to a library-level package");
11295 -- pragma Storage_Size (EXPRESSION);
11297 when Pragma_Storage_Size => Storage_Size : declare
11298 P : constant Node_Id := Parent (N);
11302 Check_No_Identifiers;
11303 Check_Arg_Count (1);
11305 -- The expression must be analyzed in the special manner described
11306 -- in "Handling of Default Expressions" in sem.ads.
11308 Arg := Expression (Arg1);
11309 Preanalyze_Spec_Expression (Arg, Any_Integer);
11311 if not Is_Static_Expression (Arg) then
11312 Check_Restriction (Static_Storage_Size, Arg);
11315 if Nkind (P) /= N_Task_Definition then
11320 if Has_Storage_Size_Pragma (P) then
11321 Error_Pragma ("duplicate pragma% not allowed");
11323 Set_Has_Storage_Size_Pragma (P, True);
11326 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
11327 -- ??? exp_ch9 should use this!
11335 -- pragma Storage_Unit (NUMERIC_LITERAL);
11337 -- Only permitted argument is System'Storage_Unit value
11339 when Pragma_Storage_Unit =>
11340 Check_No_Identifiers;
11341 Check_Arg_Count (1);
11342 Check_Arg_Is_Integer_Literal (Arg1);
11344 if Intval (Expression (Arg1)) /=
11345 UI_From_Int (Ttypes.System_Storage_Unit)
11347 Error_Msg_Uint_1 := UI_From_Int (Ttypes.System_Storage_Unit);
11349 ("the only allowed argument for pragma% is ^", Arg1);
11352 --------------------
11353 -- Stream_Convert --
11354 --------------------
11356 -- pragma Stream_Convert (
11357 -- [Entity =>] type_LOCAL_NAME,
11358 -- [Read =>] function_NAME,
11359 -- [Write =>] function NAME);
11361 when Pragma_Stream_Convert => Stream_Convert : declare
11363 procedure Check_OK_Stream_Convert_Function (Arg : Node_Id);
11364 -- Check that the given argument is the name of a local function
11365 -- of one argument that is not overloaded earlier in the current
11366 -- local scope. A check is also made that the argument is a
11367 -- function with one parameter.
11369 --------------------------------------
11370 -- Check_OK_Stream_Convert_Function --
11371 --------------------------------------
11373 procedure Check_OK_Stream_Convert_Function (Arg : Node_Id) is
11377 Check_Arg_Is_Local_Name (Arg);
11378 Ent := Entity (Expression (Arg));
11380 if Has_Homonym (Ent) then
11382 ("argument for pragma% may not be overloaded", Arg);
11385 if Ekind (Ent) /= E_Function
11386 or else No (First_Formal (Ent))
11387 or else Present (Next_Formal (First_Formal (Ent)))
11390 ("argument for pragma% must be" &
11391 " function of one argument", Arg);
11393 end Check_OK_Stream_Convert_Function;
11395 -- Start of processing for Stream_Convert
11399 Check_Arg_Order ((Name_Entity, Name_Read, Name_Write));
11400 Check_Arg_Count (3);
11401 Check_Optional_Identifier (Arg1, Name_Entity);
11402 Check_Optional_Identifier (Arg2, Name_Read);
11403 Check_Optional_Identifier (Arg3, Name_Write);
11404 Check_Arg_Is_Local_Name (Arg1);
11405 Check_OK_Stream_Convert_Function (Arg2);
11406 Check_OK_Stream_Convert_Function (Arg3);
11409 Typ : constant Entity_Id :=
11410 Underlying_Type (Entity (Expression (Arg1)));
11411 Read : constant Entity_Id := Entity (Expression (Arg2));
11412 Write : constant Entity_Id := Entity (Expression (Arg3));
11415 Check_First_Subtype (Arg1);
11417 -- Check for too early or too late. Note that we don't enforce
11418 -- the rule about primitive operations in this case, since, as
11419 -- is the case for explicit stream attributes themselves, these
11420 -- restrictions are not appropriate. Note that the chaining of
11421 -- the pragma by Rep_Item_Too_Late is actually the critical
11422 -- processing done for this pragma.
11424 if Rep_Item_Too_Early (Typ, N)
11426 Rep_Item_Too_Late (Typ, N, FOnly => True)
11431 -- Return if previous error
11433 if Etype (Typ) = Any_Type
11435 Etype (Read) = Any_Type
11437 Etype (Write) = Any_Type
11444 if Underlying_Type (Etype (Read)) /= Typ then
11446 ("incorrect return type for function&", Arg2);
11449 if Underlying_Type (Etype (First_Formal (Write))) /= Typ then
11451 ("incorrect parameter type for function&", Arg3);
11454 if Underlying_Type (Etype (First_Formal (Read))) /=
11455 Underlying_Type (Etype (Write))
11458 ("result type of & does not match Read parameter type",
11462 end Stream_Convert;
11464 -------------------------
11465 -- Style_Checks (GNAT) --
11466 -------------------------
11468 -- pragma Style_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
11470 -- This is processed by the parser since some of the style checks
11471 -- take place during source scanning and parsing. This means that
11472 -- we don't need to issue error messages here.
11474 when Pragma_Style_Checks => Style_Checks : declare
11475 A : constant Node_Id := Expression (Arg1);
11481 Check_No_Identifiers;
11483 -- Two argument form
11485 if Arg_Count = 2 then
11486 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
11493 E_Id := Expression (Arg2);
11496 if not Is_Entity_Name (E_Id) then
11498 ("second argument of pragma% must be entity name",
11502 E := Entity (E_Id);
11508 Set_Suppress_Style_Checks (E,
11509 (Chars (Expression (Arg1)) = Name_Off));
11510 exit when No (Homonym (E));
11516 -- One argument form
11519 Check_Arg_Count (1);
11521 if Nkind (A) = N_String_Literal then
11525 Slen : constant Natural := Natural (String_Length (S));
11526 Options : String (1 .. Slen);
11532 C := Get_String_Char (S, Int (J));
11533 exit when not In_Character_Range (C);
11534 Options (J) := Get_Character (C);
11536 -- If at end of string, set options. As per discussion
11537 -- above, no need to check for errors, since we issued
11538 -- them in the parser.
11541 Set_Style_Check_Options (Options);
11549 elsif Nkind (A) = N_Identifier then
11550 if Chars (A) = Name_All_Checks then
11552 Set_GNAT_Style_Check_Options;
11554 Set_Default_Style_Check_Options;
11557 elsif Chars (A) = Name_On then
11558 Style_Check := True;
11560 elsif Chars (A) = Name_Off then
11561 Style_Check := False;
11571 -- pragma Subtitle ([Subtitle =>] STRING_LITERAL);
11573 when Pragma_Subtitle =>
11575 Check_Arg_Count (1);
11576 Check_Optional_Identifier (Arg1, Name_Subtitle);
11577 Check_Arg_Is_Static_Expression (Arg1, Standard_String);
11584 -- pragma Suppress (IDENTIFIER [, [On =>] NAME]);
11586 when Pragma_Suppress =>
11587 Process_Suppress_Unsuppress (True);
11593 -- pragma Suppress_All;
11595 -- The only check made here is that the pragma appears in the proper
11596 -- place, i.e. following a compilation unit. If indeed it appears in
11597 -- this context, then the parser has already inserted an equivalent
11598 -- pragma Suppress (All_Checks) to get the required effect.
11600 when Pragma_Suppress_All =>
11602 Check_Arg_Count (0);
11604 if Nkind (Parent (N)) /= N_Compilation_Unit_Aux
11605 or else not Is_List_Member (N)
11606 or else List_Containing (N) /= Pragmas_After (Parent (N))
11609 ("misplaced pragma%, must follow compilation unit");
11612 -------------------------
11613 -- Suppress_Debug_Info --
11614 -------------------------
11616 -- pragma Suppress_Debug_Info ([Entity =>] LOCAL_NAME);
11618 when Pragma_Suppress_Debug_Info =>
11620 Check_Arg_Count (1);
11621 Check_Optional_Identifier (Arg1, Name_Entity);
11622 Check_Arg_Is_Local_Name (Arg1);
11623 Set_Debug_Info_Off (Entity (Get_Pragma_Arg (Arg1)));
11625 ----------------------------------
11626 -- Suppress_Exception_Locations --
11627 ----------------------------------
11629 -- pragma Suppress_Exception_Locations;
11631 when Pragma_Suppress_Exception_Locations =>
11633 Check_Arg_Count (0);
11634 Check_Valid_Configuration_Pragma;
11635 Exception_Locations_Suppressed := True;
11637 -----------------------------
11638 -- Suppress_Initialization --
11639 -----------------------------
11641 -- pragma Suppress_Initialization ([Entity =>] type_Name);
11643 when Pragma_Suppress_Initialization => Suppress_Init : declare
11649 Check_Arg_Count (1);
11650 Check_Optional_Identifier (Arg1, Name_Entity);
11651 Check_Arg_Is_Local_Name (Arg1);
11653 E_Id := Expression (Arg1);
11655 if Etype (E_Id) = Any_Type then
11659 E := Entity (E_Id);
11661 if Is_Type (E) then
11662 if Is_Incomplete_Or_Private_Type (E) then
11663 if No (Full_View (Base_Type (E))) then
11665 ("argument of pragma% cannot be an incomplete type",
11668 Set_Suppress_Init_Proc (Full_View (Base_Type (E)));
11671 Set_Suppress_Init_Proc (Base_Type (E));
11676 ("pragma% requires argument that is a type name", Arg1);
11684 -- pragma System_Name (DIRECT_NAME);
11686 -- Syntax check: one argument, which must be the identifier GNAT or
11687 -- the identifier GCC, no other identifiers are acceptable.
11689 when Pragma_System_Name =>
11691 Check_No_Identifiers;
11692 Check_Arg_Count (1);
11693 Check_Arg_Is_One_Of (Arg1, Name_Gcc, Name_Gnat);
11695 -----------------------------
11696 -- Task_Dispatching_Policy --
11697 -----------------------------
11699 -- pragma Task_Dispatching_Policy (policy_IDENTIFIER);
11701 when Pragma_Task_Dispatching_Policy => declare
11705 Check_Ada_83_Warning;
11706 Check_Arg_Count (1);
11707 Check_No_Identifiers;
11708 Check_Arg_Is_Task_Dispatching_Policy (Arg1);
11709 Check_Valid_Configuration_Pragma;
11710 Get_Name_String (Chars (Expression (Arg1)));
11711 DP := Fold_Upper (Name_Buffer (1));
11713 if Task_Dispatching_Policy /= ' '
11714 and then Task_Dispatching_Policy /= DP
11716 Error_Msg_Sloc := Task_Dispatching_Policy_Sloc;
11718 ("task dispatching policy incompatible with policy#");
11720 -- Set new policy, but always preserve System_Location since we
11721 -- like the error message with the run time name.
11724 Task_Dispatching_Policy := DP;
11726 if Task_Dispatching_Policy_Sloc /= System_Location then
11727 Task_Dispatching_Policy_Sloc := Loc;
11736 -- pragma Task_Info (EXPRESSION);
11738 when Pragma_Task_Info => Task_Info : declare
11739 P : constant Node_Id := Parent (N);
11744 if Nkind (P) /= N_Task_Definition then
11745 Error_Pragma ("pragma% must appear in task definition");
11748 Check_No_Identifiers;
11749 Check_Arg_Count (1);
11751 Analyze_And_Resolve (Expression (Arg1), RTE (RE_Task_Info_Type));
11753 if Etype (Expression (Arg1)) = Any_Type then
11757 if Has_Task_Info_Pragma (P) then
11758 Error_Pragma ("duplicate pragma% not allowed");
11760 Set_Has_Task_Info_Pragma (P, True);
11768 -- pragma Task_Name (string_EXPRESSION);
11770 when Pragma_Task_Name => Task_Name : declare
11771 P : constant Node_Id := Parent (N);
11775 Check_No_Identifiers;
11776 Check_Arg_Count (1);
11778 Arg := Expression (Arg1);
11780 -- The expression is used in the call to Create_Task, and must be
11781 -- expanded there, not in the context of the current spec. It must
11782 -- however be analyzed to capture global references, in case it
11783 -- appears in a generic context.
11785 Preanalyze_And_Resolve (Arg, Standard_String);
11787 if Nkind (P) /= N_Task_Definition then
11791 if Has_Task_Name_Pragma (P) then
11792 Error_Pragma ("duplicate pragma% not allowed");
11794 Set_Has_Task_Name_Pragma (P, True);
11795 Record_Rep_Item (Defining_Identifier (Parent (P)), N);
11803 -- pragma Task_Storage (
11804 -- [Task_Type =>] LOCAL_NAME,
11805 -- [Top_Guard =>] static_integer_EXPRESSION);
11807 when Pragma_Task_Storage => Task_Storage : declare
11808 Args : Args_List (1 .. 2);
11809 Names : constant Name_List (1 .. 2) := (
11813 Task_Type : Node_Id renames Args (1);
11814 Top_Guard : Node_Id renames Args (2);
11820 Gather_Associations (Names, Args);
11822 if No (Task_Type) then
11824 ("missing task_type argument for pragma%");
11827 Check_Arg_Is_Local_Name (Task_Type);
11829 Ent := Entity (Task_Type);
11831 if not Is_Task_Type (Ent) then
11833 ("argument for pragma% must be task type", Task_Type);
11836 if No (Top_Guard) then
11838 ("pragma% takes two arguments", Task_Type);
11840 Check_Arg_Is_Static_Expression (Top_Guard, Any_Integer);
11843 Check_First_Subtype (Task_Type);
11845 if Rep_Item_Too_Late (Ent, N) then
11850 --------------------------
11851 -- Thread_Local_Storage --
11852 --------------------------
11854 -- pragma Thread_Local_Storage ([Entity =>] LOCAL_NAME);
11856 when Pragma_Thread_Local_Storage => Thread_Local_Storage : declare
11862 Check_Arg_Count (1);
11863 Check_Optional_Identifier (Arg1, Name_Entity);
11864 Check_Arg_Is_Library_Level_Local_Name (Arg1);
11866 Id := Expression (Arg1);
11869 if not Is_Entity_Name (Id)
11870 or else Ekind (Entity (Id)) /= E_Variable
11872 Error_Pragma_Arg ("local variable name required", Arg1);
11877 if Rep_Item_Too_Early (E, N)
11878 or else Rep_Item_Too_Late (E, N)
11883 Set_Has_Pragma_Thread_Local_Storage (E);
11884 Set_Has_Gigi_Rep_Item (E);
11885 end Thread_Local_Storage;
11891 -- pragma Time_Slice (static_duration_EXPRESSION);
11893 when Pragma_Time_Slice => Time_Slice : declare
11899 Check_Arg_Count (1);
11900 Check_No_Identifiers;
11901 Check_In_Main_Program;
11902 Check_Arg_Is_Static_Expression (Arg1, Standard_Duration);
11904 if not Error_Posted (Arg1) then
11906 while Present (Nod) loop
11907 if Nkind (Nod) = N_Pragma
11908 and then Pragma_Name (Nod) = Name_Time_Slice
11910 Error_Msg_Name_1 := Pname;
11911 Error_Msg_N ("duplicate pragma% not permitted", Nod);
11918 -- Process only if in main unit
11920 if Get_Source_Unit (Loc) = Main_Unit then
11921 Opt.Time_Slice_Set := True;
11922 Val := Expr_Value_R (Expression (Arg1));
11924 if Val <= Ureal_0 then
11925 Opt.Time_Slice_Value := 0;
11927 elsif Val > UR_From_Uint (UI_From_Int (1000)) then
11928 Opt.Time_Slice_Value := 1_000_000_000;
11931 Opt.Time_Slice_Value :=
11932 UI_To_Int (UR_To_Uint (Val * UI_From_Int (1_000_000)));
11941 -- pragma Title (TITLING_OPTION [, TITLING OPTION]);
11943 -- TITLING_OPTION ::=
11944 -- [Title =>] STRING_LITERAL
11945 -- | [Subtitle =>] STRING_LITERAL
11947 when Pragma_Title => Title : declare
11948 Args : Args_List (1 .. 2);
11949 Names : constant Name_List (1 .. 2) := (
11955 Gather_Associations (Names, Args);
11958 for J in 1 .. 2 loop
11959 if Present (Args (J)) then
11960 Check_Arg_Is_Static_Expression (Args (J), Standard_String);
11965 ---------------------
11966 -- Unchecked_Union --
11967 ---------------------
11969 -- pragma Unchecked_Union (first_subtype_LOCAL_NAME)
11971 when Pragma_Unchecked_Union => Unchecked_Union : declare
11972 Assoc : constant Node_Id := Arg1;
11973 Type_Id : constant Node_Id := Expression (Assoc);
11984 Check_No_Identifiers;
11985 Check_Arg_Count (1);
11986 Check_Arg_Is_Local_Name (Arg1);
11988 Find_Type (Type_Id);
11989 Typ := Entity (Type_Id);
11992 or else Rep_Item_Too_Early (Typ, N)
11996 Typ := Underlying_Type (Typ);
11999 if Rep_Item_Too_Late (Typ, N) then
12003 Check_First_Subtype (Arg1);
12005 -- Note remaining cases are references to a type in the current
12006 -- declarative part. If we find an error, we post the error on
12007 -- the relevant type declaration at an appropriate point.
12009 if not Is_Record_Type (Typ) then
12010 Error_Msg_N ("Unchecked_Union must be record type", Typ);
12013 elsif Is_Tagged_Type (Typ) then
12014 Error_Msg_N ("Unchecked_Union must not be tagged", Typ);
12017 elsif Is_Limited_Type (Typ) then
12019 ("Unchecked_Union must not be limited record type", Typ);
12020 Explain_Limited_Type (Typ, Typ);
12024 if not Has_Discriminants (Typ) then
12026 ("Unchecked_Union must have one discriminant", Typ);
12030 Discr := First_Discriminant (Typ);
12031 while Present (Discr) loop
12032 if No (Discriminant_Default_Value (Discr)) then
12034 ("Unchecked_Union discriminant must have default value",
12037 Next_Discriminant (Discr);
12040 Tdef := Type_Definition (Declaration_Node (Typ));
12041 Clist := Component_List (Tdef);
12043 Comp := First (Component_Items (Clist));
12044 while Present (Comp) loop
12045 Check_Component (Comp, Typ);
12049 if No (Clist) or else No (Variant_Part (Clist)) then
12051 ("Unchecked_Union must have variant part",
12056 Vpart := Variant_Part (Clist);
12058 Variant := First (Variants (Vpart));
12059 while Present (Variant) loop
12060 Check_Variant (Variant, Typ);
12065 Set_Is_Unchecked_Union (Typ, True);
12066 Set_Convention (Typ, Convention_C);
12068 Set_Has_Unchecked_Union (Base_Type (Typ), True);
12069 Set_Is_Unchecked_Union (Base_Type (Typ), True);
12070 end Unchecked_Union;
12072 ------------------------
12073 -- Unimplemented_Unit --
12074 ------------------------
12076 -- pragma Unimplemented_Unit;
12078 -- Note: this only gives an error if we are generating code, or if
12079 -- we are in a generic library unit (where the pragma appears in the
12080 -- body, not in the spec).
12082 when Pragma_Unimplemented_Unit => Unimplemented_Unit : declare
12083 Cunitent : constant Entity_Id :=
12084 Cunit_Entity (Get_Source_Unit (Loc));
12085 Ent_Kind : constant Entity_Kind :=
12090 Check_Arg_Count (0);
12092 if Operating_Mode = Generate_Code
12093 or else Ent_Kind = E_Generic_Function
12094 or else Ent_Kind = E_Generic_Procedure
12095 or else Ent_Kind = E_Generic_Package
12097 Get_Name_String (Chars (Cunitent));
12098 Set_Casing (Mixed_Case);
12099 Write_Str (Name_Buffer (1 .. Name_Len));
12100 Write_Str (" is not supported in this configuration");
12102 raise Unrecoverable_Error;
12104 end Unimplemented_Unit;
12106 ------------------------
12107 -- Universal_Aliasing --
12108 ------------------------
12110 -- pragma Universal_Aliasing [([Entity =>] type_LOCAL_NAME)];
12112 when Pragma_Universal_Aliasing => Universal_Alias : declare
12117 Check_Arg_Count (1);
12118 Check_Optional_Identifier (Arg2, Name_Entity);
12119 Check_Arg_Is_Local_Name (Arg1);
12120 E_Id := Entity (Expression (Arg1));
12122 if E_Id = Any_Type then
12124 elsif No (E_Id) or else not Is_Type (E_Id) then
12125 Error_Pragma_Arg ("pragma% requires type", Arg1);
12128 Set_Universal_Aliasing (Implementation_Base_Type (E_Id));
12129 end Universal_Alias;
12131 --------------------
12132 -- Universal_Data --
12133 --------------------
12135 -- pragma Universal_Data [(library_unit_NAME)];
12137 when Pragma_Universal_Data =>
12140 -- If this is a configuration pragma, then set the universal
12141 -- addressing option, otherwise confirm that the pragma satisfies
12142 -- the requirements of library unit pragma placement and leave it
12143 -- to the GNAAMP back end to detect the pragma (avoids transitive
12144 -- setting of the option due to withed units).
12146 if Is_Configuration_Pragma then
12147 Universal_Addressing_On_AAMP := True;
12149 Check_Valid_Library_Unit_Pragma;
12152 if not AAMP_On_Target then
12153 Error_Pragma ("?pragma% ignored (applies only to AAMP)");
12160 -- pragma Unmodified (local_Name {, local_Name});
12162 when Pragma_Unmodified => Unmodified : declare
12163 Arg_Node : Node_Id;
12164 Arg_Expr : Node_Id;
12165 Arg_Ent : Entity_Id;
12169 Check_At_Least_N_Arguments (1);
12171 -- Loop through arguments
12174 while Present (Arg_Node) loop
12175 Check_No_Identifier (Arg_Node);
12177 -- Note: the analyze call done by Check_Arg_Is_Local_Name will
12178 -- in fact generate reference, so that the entity will have a
12179 -- reference, which will inhibit any warnings about it not
12180 -- being referenced, and also properly show up in the ali file
12181 -- as a reference. But this reference is recorded before the
12182 -- Has_Pragma_Unreferenced flag is set, so that no warning is
12183 -- generated for this reference.
12185 Check_Arg_Is_Local_Name (Arg_Node);
12186 Arg_Expr := Get_Pragma_Arg (Arg_Node);
12188 if Is_Entity_Name (Arg_Expr) then
12189 Arg_Ent := Entity (Arg_Expr);
12191 if not Is_Assignable (Arg_Ent) then
12193 ("pragma% can only be applied to a variable",
12196 Set_Has_Pragma_Unmodified (Arg_Ent);
12208 -- pragma Unreferenced (local_Name {, local_Name});
12210 -- or when used in a context clause:
12212 -- pragma Unreferenced (library_unit_NAME {, library_unit_NAME}
12214 when Pragma_Unreferenced => Unreferenced : declare
12215 Arg_Node : Node_Id;
12216 Arg_Expr : Node_Id;
12217 Arg_Ent : Entity_Id;
12222 Check_At_Least_N_Arguments (1);
12224 -- Check case of appearing within context clause
12226 if Is_In_Context_Clause then
12228 -- The arguments must all be units mentioned in a with clause
12229 -- in the same context clause. Note we already checked (in
12230 -- Par.Prag) that the arguments are either identifiers or
12231 -- selected components.
12234 while Present (Arg_Node) loop
12235 Citem := First (List_Containing (N));
12236 while Citem /= N loop
12237 if Nkind (Citem) = N_With_Clause
12238 and then Same_Name (Name (Citem), Expression (Arg_Node))
12240 Set_Has_Pragma_Unreferenced
12243 (Library_Unit (Citem))));
12244 Set_Unit_Name (Expression (Arg_Node), Name (Citem));
12253 ("argument of pragma% is not with'ed unit", Arg_Node);
12259 -- Case of not in list of context items
12263 while Present (Arg_Node) loop
12264 Check_No_Identifier (Arg_Node);
12266 -- Note: the analyze call done by Check_Arg_Is_Local_Name
12267 -- will in fact generate reference, so that the entity will
12268 -- have a reference, which will inhibit any warnings about
12269 -- it not being referenced, and also properly show up in the
12270 -- ali file as a reference. But this reference is recorded
12271 -- before the Has_Pragma_Unreferenced flag is set, so that
12272 -- no warning is generated for this reference.
12274 Check_Arg_Is_Local_Name (Arg_Node);
12275 Arg_Expr := Get_Pragma_Arg (Arg_Node);
12277 if Is_Entity_Name (Arg_Expr) then
12278 Arg_Ent := Entity (Arg_Expr);
12280 -- If the entity is overloaded, the pragma applies to the
12281 -- most recent overloading, as documented. In this case,
12282 -- name resolution does not generate a reference, so it
12283 -- must be done here explicitly.
12285 if Is_Overloaded (Arg_Expr) then
12286 Generate_Reference (Arg_Ent, N);
12289 Set_Has_Pragma_Unreferenced (Arg_Ent);
12297 --------------------------
12298 -- Unreferenced_Objects --
12299 --------------------------
12301 -- pragma Unreferenced_Objects (local_Name {, local_Name});
12303 when Pragma_Unreferenced_Objects => Unreferenced_Objects : declare
12304 Arg_Node : Node_Id;
12305 Arg_Expr : Node_Id;
12309 Check_At_Least_N_Arguments (1);
12312 while Present (Arg_Node) loop
12313 Check_No_Identifier (Arg_Node);
12314 Check_Arg_Is_Local_Name (Arg_Node);
12315 Arg_Expr := Get_Pragma_Arg (Arg_Node);
12317 if not Is_Entity_Name (Arg_Expr)
12318 or else not Is_Type (Entity (Arg_Expr))
12321 ("argument for pragma% must be type or subtype", Arg_Node);
12324 Set_Has_Pragma_Unreferenced_Objects (Entity (Arg_Expr));
12327 end Unreferenced_Objects;
12329 ------------------------------
12330 -- Unreserve_All_Interrupts --
12331 ------------------------------
12333 -- pragma Unreserve_All_Interrupts;
12335 when Pragma_Unreserve_All_Interrupts =>
12337 Check_Arg_Count (0);
12339 if In_Extended_Main_Code_Unit (Main_Unit_Entity) then
12340 Unreserve_All_Interrupts := True;
12347 -- pragma Unsuppress (IDENTIFIER [, [On =>] NAME]);
12349 when Pragma_Unsuppress =>
12351 Process_Suppress_Unsuppress (False);
12353 -------------------
12354 -- Use_VADS_Size --
12355 -------------------
12357 -- pragma Use_VADS_Size;
12359 when Pragma_Use_VADS_Size =>
12361 Check_Arg_Count (0);
12362 Check_Valid_Configuration_Pragma;
12363 Use_VADS_Size := True;
12365 ---------------------
12366 -- Validity_Checks --
12367 ---------------------
12369 -- pragma Validity_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
12371 when Pragma_Validity_Checks => Validity_Checks : declare
12372 A : constant Node_Id := Expression (Arg1);
12378 Check_Arg_Count (1);
12379 Check_No_Identifiers;
12381 if Nkind (A) = N_String_Literal then
12385 Slen : constant Natural := Natural (String_Length (S));
12386 Options : String (1 .. Slen);
12392 C := Get_String_Char (S, Int (J));
12393 exit when not In_Character_Range (C);
12394 Options (J) := Get_Character (C);
12397 Set_Validity_Check_Options (Options);
12405 elsif Nkind (A) = N_Identifier then
12407 if Chars (A) = Name_All_Checks then
12408 Set_Validity_Check_Options ("a");
12410 elsif Chars (A) = Name_On then
12411 Validity_Checks_On := True;
12413 elsif Chars (A) = Name_Off then
12414 Validity_Checks_On := False;
12418 end Validity_Checks;
12424 -- pragma Volatile (LOCAL_NAME);
12426 when Pragma_Volatile =>
12427 Process_Atomic_Shared_Volatile;
12429 -------------------------
12430 -- Volatile_Components --
12431 -------------------------
12433 -- pragma Volatile_Components (array_LOCAL_NAME);
12435 -- Volatile is handled by the same circuit as Atomic_Components
12441 -- pragma Warnings (On | Off);
12442 -- pragma Warnings (On | Off, LOCAL_NAME);
12443 -- pragma Warnings (static_string_EXPRESSION);
12444 -- pragma Warnings (On | Off, STRING_LITERAL);
12446 when Pragma_Warnings => Warnings : begin
12448 Check_At_Least_N_Arguments (1);
12449 Check_No_Identifiers;
12451 -- If debug flag -gnatd.i is set, pragma is ignored
12453 if Debug_Flag_Dot_I then
12457 -- Process various forms of the pragma
12460 Argx : constant Node_Id := Get_Pragma_Arg (Arg1);
12463 -- One argument case
12465 if Arg_Count = 1 then
12467 -- On/Off one argument case was processed by parser
12469 if Nkind (Argx) = N_Identifier
12471 (Chars (Argx) = Name_On
12473 Chars (Argx) = Name_Off)
12477 -- One argument case must be ON/OFF or static string expr
12479 elsif not Is_Static_String_Expression (Arg1) then
12481 ("argument of pragma% must be On/Off or " &
12482 "static string expression", Arg1);
12484 -- One argument string expression case
12488 Lit : constant Node_Id := Expr_Value_S (Argx);
12489 Str : constant String_Id := Strval (Lit);
12490 Len : constant Nat := String_Length (Str);
12498 while J <= Len loop
12499 C := Get_String_Char (Str, J);
12500 OK := In_Character_Range (C);
12503 Chr := Get_Character (C);
12507 if J < Len and then Chr = '.' then
12509 C := Get_String_Char (Str, J);
12510 Chr := Get_Character (C);
12512 if not Set_Dot_Warning_Switch (Chr) then
12514 ("invalid warning switch character " &
12521 OK := Set_Warning_Switch (Chr);
12527 ("invalid warning switch character " & Chr,
12536 -- Two or more arguments (must be two)
12539 Check_Arg_Is_One_Of (Arg1, Name_On, Name_Off);
12540 Check_At_Most_N_Arguments (2);
12548 E_Id := Expression (Arg2);
12551 -- In the expansion of an inlined body, a reference to
12552 -- the formal may be wrapped in a conversion if the
12553 -- actual is a conversion. Retrieve the real entity name.
12555 if (In_Instance_Body
12556 or else In_Inlined_Body)
12557 and then Nkind (E_Id) = N_Unchecked_Type_Conversion
12559 E_Id := Expression (E_Id);
12562 -- Entity name case
12564 if Is_Entity_Name (E_Id) then
12565 E := Entity (E_Id);
12572 (E, (Chars (Expression (Arg1)) = Name_Off));
12574 if Chars (Expression (Arg1)) = Name_Off
12575 and then Warn_On_Warnings_Off
12577 Warnings_Off_Pragmas.Append ((N, E));
12580 if Is_Enumeration_Type (E) then
12584 Lit := First_Literal (E);
12585 while Present (Lit) loop
12586 Set_Warnings_Off (Lit);
12587 Next_Literal (Lit);
12592 exit when No (Homonym (E));
12597 -- Error if not entity or static string literal case
12599 elsif not Is_Static_String_Expression (Arg2) then
12601 ("second argument of pragma% must be entity " &
12602 "name or static string expression", Arg2);
12604 -- String literal case
12607 String_To_Name_Buffer
12608 (Strval (Expr_Value_S (Expression (Arg2))));
12610 -- Note on configuration pragma case: If this is a
12611 -- configuration pragma, then for an OFF pragma, we
12612 -- just set Config True in the call, which is all
12613 -- that needs to be done. For the case of ON, this
12614 -- is normally an error, unless it is canceling the
12615 -- effect of a previous OFF pragma in the same file.
12616 -- In any other case, an error will be signalled (ON
12617 -- with no matching OFF).
12619 if Chars (Argx) = Name_Off then
12620 Set_Specific_Warning_Off
12621 (Loc, Name_Buffer (1 .. Name_Len),
12622 Config => Is_Configuration_Pragma);
12624 elsif Chars (Argx) = Name_On then
12625 Set_Specific_Warning_On
12626 (Loc, Name_Buffer (1 .. Name_Len), Err);
12630 ("?pragma Warnings On with no " &
12631 "matching Warnings Off",
12641 -------------------
12642 -- Weak_External --
12643 -------------------
12645 -- pragma Weak_External ([Entity =>] LOCAL_NAME);
12647 when Pragma_Weak_External => Weak_External : declare
12652 Check_Arg_Count (1);
12653 Check_Optional_Identifier (Arg1, Name_Entity);
12654 Check_Arg_Is_Library_Level_Local_Name (Arg1);
12655 Ent := Entity (Expression (Arg1));
12657 if Rep_Item_Too_Early (Ent, N) then
12660 Ent := Underlying_Type (Ent);
12663 -- The only processing required is to link this item on to the
12664 -- list of rep items for the given entity. This is accomplished
12665 -- by the call to Rep_Item_Too_Late (when no error is detected
12666 -- and False is returned).
12668 if Rep_Item_Too_Late (Ent, N) then
12671 Set_Has_Gigi_Rep_Item (Ent);
12675 -----------------------------
12676 -- Wide_Character_Encoding --
12677 -----------------------------
12679 -- pragma Wide_Character_Encoding (IDENTIFIER);
12681 when Pragma_Wide_Character_Encoding =>
12684 -- Nothing to do, handled in parser. Note that we do not enforce
12685 -- configuration pragma placement, this pragma can appear at any
12686 -- place in the source, allowing mixed encodings within a single
12691 --------------------
12692 -- Unknown_Pragma --
12693 --------------------
12695 -- Should be impossible, since the case of an unknown pragma is
12696 -- separately processed before the case statement is entered.
12698 when Unknown_Pragma =>
12699 raise Program_Error;
12702 -- AI05-0144: detect dangerous order dependence. Disabled for now,
12703 -- until AI is formally approved.
12705 -- Check_Order_Dependence;
12708 when Pragma_Exit => null;
12709 end Analyze_Pragma;
12711 -------------------
12712 -- Check_Enabled --
12713 -------------------
12715 function Check_Enabled (Nam : Name_Id) return Boolean is
12719 PP := Opt.Check_Policy_List;
12722 return Assertions_Enabled;
12725 Nam = Chars (Expression (First (Pragma_Argument_Associations (PP))))
12728 Chars (Expression (Last (Pragma_Argument_Associations (PP))))
12730 when Name_On | Name_Check =>
12732 when Name_Off | Name_Ignore =>
12735 raise Program_Error;
12739 PP := Next_Pragma (PP);
12744 ---------------------------------
12745 -- Delay_Config_Pragma_Analyze --
12746 ---------------------------------
12748 function Delay_Config_Pragma_Analyze (N : Node_Id) return Boolean is
12750 return Pragma_Name (N) = Name_Interrupt_State
12752 Pragma_Name (N) = Name_Priority_Specific_Dispatching;
12753 end Delay_Config_Pragma_Analyze;
12755 -------------------------
12756 -- Get_Base_Subprogram --
12757 -------------------------
12759 function Get_Base_Subprogram (Def_Id : Entity_Id) return Entity_Id is
12760 Result : Entity_Id;
12763 -- Follow subprogram renaming chain
12766 while Is_Subprogram (Result)
12768 (Is_Generic_Instance (Result)
12769 or else Nkind (Parent (Declaration_Node (Result))) =
12770 N_Subprogram_Renaming_Declaration)
12771 and then Present (Alias (Result))
12773 Result := Alias (Result);
12777 end Get_Base_Subprogram;
12779 --------------------
12780 -- Get_Pragma_Arg --
12781 --------------------
12783 function Get_Pragma_Arg (Arg : Node_Id) return Node_Id is
12785 if Nkind (Arg) = N_Pragma_Argument_Association then
12786 return Expression (Arg);
12790 end Get_Pragma_Arg;
12796 procedure Initialize is
12801 -----------------------------
12802 -- Is_Config_Static_String --
12803 -----------------------------
12805 function Is_Config_Static_String (Arg : Node_Id) return Boolean is
12807 function Add_Config_Static_String (Arg : Node_Id) return Boolean;
12808 -- This is an internal recursive function that is just like the outer
12809 -- function except that it adds the string to the name buffer rather
12810 -- than placing the string in the name buffer.
12812 ------------------------------
12813 -- Add_Config_Static_String --
12814 ------------------------------
12816 function Add_Config_Static_String (Arg : Node_Id) return Boolean is
12823 if Nkind (N) = N_Op_Concat then
12824 if Add_Config_Static_String (Left_Opnd (N)) then
12825 N := Right_Opnd (N);
12831 if Nkind (N) /= N_String_Literal then
12832 Error_Msg_N ("string literal expected for pragma argument", N);
12836 for J in 1 .. String_Length (Strval (N)) loop
12837 C := Get_String_Char (Strval (N), J);
12839 if not In_Character_Range (C) then
12841 ("string literal contains invalid wide character",
12842 Sloc (N) + 1 + Source_Ptr (J));
12846 Add_Char_To_Name_Buffer (Get_Character (C));
12851 end Add_Config_Static_String;
12853 -- Start of processing for Is_Config_Static_String
12858 return Add_Config_Static_String (Arg);
12859 end Is_Config_Static_String;
12861 -----------------------------------------
12862 -- Is_Non_Significant_Pragma_Reference --
12863 -----------------------------------------
12865 -- This function makes use of the following static table which indicates
12866 -- whether a given pragma is significant.
12868 -- -1 indicates that references in any argument position are significant
12869 -- 0 indicates that appearence in any argument is not significant
12870 -- +n indicates that appearence as argument n is significant, but all
12871 -- other arguments are not significant
12872 -- 99 special processing required (e.g. for pragma Check)
12874 Sig_Flags : constant array (Pragma_Id) of Int :=
12875 (Pragma_AST_Entry => -1,
12876 Pragma_Abort_Defer => -1,
12877 Pragma_Ada_83 => -1,
12878 Pragma_Ada_95 => -1,
12879 Pragma_Ada_05 => -1,
12880 Pragma_Ada_2005 => -1,
12881 Pragma_Ada_12 => -1,
12882 Pragma_Ada_2012 => -1,
12883 Pragma_All_Calls_Remote => -1,
12884 Pragma_Annotate => -1,
12885 Pragma_Assert => -1,
12886 Pragma_Assertion_Policy => 0,
12887 Pragma_Assume_No_Invalid_Values => 0,
12888 Pragma_Asynchronous => -1,
12889 Pragma_Atomic => 0,
12890 Pragma_Atomic_Components => 0,
12891 Pragma_Attach_Handler => -1,
12892 Pragma_Check => 99,
12893 Pragma_Check_Name => 0,
12894 Pragma_Check_Policy => 0,
12895 Pragma_CIL_Constructor => -1,
12896 Pragma_CPP_Class => 0,
12897 Pragma_CPP_Constructor => 0,
12898 Pragma_CPP_Virtual => 0,
12899 Pragma_CPP_Vtable => 0,
12900 Pragma_C_Pass_By_Copy => 0,
12901 Pragma_Comment => 0,
12902 Pragma_Common_Object => -1,
12903 Pragma_Compile_Time_Error => -1,
12904 Pragma_Compile_Time_Warning => -1,
12905 Pragma_Compiler_Unit => 0,
12906 Pragma_Complete_Representation => 0,
12907 Pragma_Complex_Representation => 0,
12908 Pragma_Component_Alignment => -1,
12909 Pragma_Controlled => 0,
12910 Pragma_Convention => 0,
12911 Pragma_Convention_Identifier => 0,
12912 Pragma_Debug => -1,
12913 Pragma_Debug_Policy => 0,
12914 Pragma_Detect_Blocking => -1,
12915 Pragma_Dimension => -1,
12916 Pragma_Discard_Names => 0,
12917 Pragma_Elaborate => -1,
12918 Pragma_Elaborate_All => -1,
12919 Pragma_Elaborate_Body => -1,
12920 Pragma_Elaboration_Checks => -1,
12921 Pragma_Eliminate => -1,
12922 Pragma_Export => -1,
12923 Pragma_Export_Exception => -1,
12924 Pragma_Export_Function => -1,
12925 Pragma_Export_Object => -1,
12926 Pragma_Export_Procedure => -1,
12927 Pragma_Export_Value => -1,
12928 Pragma_Export_Valued_Procedure => -1,
12929 Pragma_Extend_System => -1,
12930 Pragma_Extensions_Allowed => -1,
12931 Pragma_External => -1,
12932 Pragma_Favor_Top_Level => -1,
12933 Pragma_External_Name_Casing => -1,
12934 Pragma_Fast_Math => -1,
12935 Pragma_Finalize_Storage_Only => 0,
12936 Pragma_Float_Representation => 0,
12937 Pragma_Ident => -1,
12938 Pragma_Implemented_By_Entry => -1,
12939 Pragma_Implicit_Packing => 0,
12940 Pragma_Import => +2,
12941 Pragma_Import_Exception => 0,
12942 Pragma_Import_Function => 0,
12943 Pragma_Import_Object => 0,
12944 Pragma_Import_Procedure => 0,
12945 Pragma_Import_Valued_Procedure => 0,
12946 Pragma_Initialize_Scalars => -1,
12947 Pragma_Inline => 0,
12948 Pragma_Inline_Always => 0,
12949 Pragma_Inline_Generic => 0,
12950 Pragma_Inspection_Point => -1,
12951 Pragma_Interface => +2,
12952 Pragma_Interface_Name => +2,
12953 Pragma_Interrupt_Handler => -1,
12954 Pragma_Interrupt_Priority => -1,
12955 Pragma_Interrupt_State => -1,
12956 Pragma_Java_Constructor => -1,
12957 Pragma_Java_Interface => -1,
12958 Pragma_Keep_Names => 0,
12959 Pragma_License => -1,
12960 Pragma_Link_With => -1,
12961 Pragma_Linker_Alias => -1,
12962 Pragma_Linker_Constructor => -1,
12963 Pragma_Linker_Destructor => -1,
12964 Pragma_Linker_Options => -1,
12965 Pragma_Linker_Section => -1,
12967 Pragma_Locking_Policy => -1,
12968 Pragma_Long_Float => -1,
12969 Pragma_Machine_Attribute => -1,
12971 Pragma_Main_Storage => -1,
12972 Pragma_Memory_Size => -1,
12973 Pragma_No_Return => 0,
12974 Pragma_No_Body => 0,
12975 Pragma_No_Run_Time => -1,
12976 Pragma_No_Strict_Aliasing => -1,
12977 Pragma_Normalize_Scalars => -1,
12978 Pragma_Obsolescent => 0,
12979 Pragma_Optimize => -1,
12980 Pragma_Optimize_Alignment => -1,
12981 Pragma_Ordered => 0,
12984 Pragma_Passive => -1,
12985 Pragma_Preelaborable_Initialization => -1,
12986 Pragma_Polling => -1,
12987 Pragma_Persistent_BSS => 0,
12988 Pragma_Postcondition => -1,
12989 Pragma_Precondition => -1,
12990 Pragma_Preelaborate => -1,
12991 Pragma_Preelaborate_05 => -1,
12992 Pragma_Priority => -1,
12993 Pragma_Priority_Specific_Dispatching => -1,
12994 Pragma_Profile => 0,
12995 Pragma_Profile_Warnings => 0,
12996 Pragma_Propagate_Exceptions => -1,
12997 Pragma_Psect_Object => -1,
12999 Pragma_Pure_05 => -1,
13000 Pragma_Pure_Function => -1,
13001 Pragma_Queuing_Policy => -1,
13002 Pragma_Ravenscar => -1,
13003 Pragma_Relative_Deadline => -1,
13004 Pragma_Remote_Call_Interface => -1,
13005 Pragma_Remote_Types => -1,
13006 Pragma_Restricted_Run_Time => -1,
13007 Pragma_Restriction_Warnings => -1,
13008 Pragma_Restrictions => -1,
13009 Pragma_Reviewable => -1,
13010 Pragma_Short_Circuit_And_Or => -1,
13011 Pragma_Share_Generic => -1,
13012 Pragma_Shared => -1,
13013 Pragma_Shared_Passive => -1,
13014 Pragma_Short_Descriptors => 0,
13015 Pragma_Source_File_Name => -1,
13016 Pragma_Source_File_Name_Project => -1,
13017 Pragma_Source_Reference => -1,
13018 Pragma_Storage_Size => -1,
13019 Pragma_Storage_Unit => -1,
13020 Pragma_Static_Elaboration_Desired => -1,
13021 Pragma_Stream_Convert => -1,
13022 Pragma_Style_Checks => -1,
13023 Pragma_Subtitle => -1,
13024 Pragma_Suppress => 0,
13025 Pragma_Suppress_Exception_Locations => 0,
13026 Pragma_Suppress_All => -1,
13027 Pragma_Suppress_Debug_Info => 0,
13028 Pragma_Suppress_Initialization => 0,
13029 Pragma_System_Name => -1,
13030 Pragma_Task_Dispatching_Policy => -1,
13031 Pragma_Task_Info => -1,
13032 Pragma_Task_Name => -1,
13033 Pragma_Task_Storage => 0,
13034 Pragma_Thread_Local_Storage => 0,
13035 Pragma_Time_Slice => -1,
13036 Pragma_Title => -1,
13037 Pragma_Unchecked_Union => 0,
13038 Pragma_Unimplemented_Unit => -1,
13039 Pragma_Universal_Aliasing => -1,
13040 Pragma_Universal_Data => -1,
13041 Pragma_Unmodified => -1,
13042 Pragma_Unreferenced => -1,
13043 Pragma_Unreferenced_Objects => -1,
13044 Pragma_Unreserve_All_Interrupts => -1,
13045 Pragma_Unsuppress => 0,
13046 Pragma_Use_VADS_Size => -1,
13047 Pragma_Validity_Checks => -1,
13048 Pragma_Volatile => 0,
13049 Pragma_Volatile_Components => 0,
13050 Pragma_Warnings => -1,
13051 Pragma_Weak_External => -1,
13052 Pragma_Wide_Character_Encoding => 0,
13053 Unknown_Pragma => 0);
13055 function Is_Non_Significant_Pragma_Reference (N : Node_Id) return Boolean is
13064 if Nkind (P) /= N_Pragma_Argument_Association then
13068 Id := Get_Pragma_Id (Parent (P));
13069 C := Sig_Flags (Id);
13081 -- For pragma Check, the first argument is not significant,
13082 -- the second and the third (if present) arguments are
13085 when Pragma_Check =>
13087 P = First (Pragma_Argument_Associations (Parent (P)));
13090 raise Program_Error;
13094 A := First (Pragma_Argument_Associations (Parent (P)));
13095 for J in 1 .. C - 1 loop
13103 return A = P; -- is this wrong way round ???
13106 end Is_Non_Significant_Pragma_Reference;
13108 ------------------------------
13109 -- Is_Pragma_String_Literal --
13110 ------------------------------
13112 -- This function returns true if the corresponding pragma argument is a
13113 -- static string expression. These are the only cases in which string
13114 -- literals can appear as pragma arguments. We also allow a string literal
13115 -- as the first argument to pragma Assert (although it will of course
13116 -- always generate a type error).
13118 function Is_Pragma_String_Literal (Par : Node_Id) return Boolean is
13119 Pragn : constant Node_Id := Parent (Par);
13120 Assoc : constant List_Id := Pragma_Argument_Associations (Pragn);
13121 Pname : constant Name_Id := Pragma_Name (Pragn);
13127 N := First (Assoc);
13134 if Pname = Name_Assert then
13137 elsif Pname = Name_Export then
13140 elsif Pname = Name_Ident then
13143 elsif Pname = Name_Import then
13146 elsif Pname = Name_Interface_Name then
13149 elsif Pname = Name_Linker_Alias then
13152 elsif Pname = Name_Linker_Section then
13155 elsif Pname = Name_Machine_Attribute then
13158 elsif Pname = Name_Source_File_Name then
13161 elsif Pname = Name_Source_Reference then
13164 elsif Pname = Name_Title then
13167 elsif Pname = Name_Subtitle then
13173 end Is_Pragma_String_Literal;
13175 --------------------------------------
13176 -- Process_Compilation_Unit_Pragmas --
13177 --------------------------------------
13179 procedure Process_Compilation_Unit_Pragmas (N : Node_Id) is
13181 -- A special check for pragma Suppress_All, a very strange DEC pragma,
13182 -- strange because it comes at the end of the unit. If we have a pragma
13183 -- Suppress_All in the Pragmas_After of the current unit, then we insert
13184 -- a pragma Suppress (All_Checks) at the start of the context clause to
13185 -- ensure the correct processing.
13188 PA : constant List_Id := Pragmas_After (Aux_Decls_Node (N));
13192 if Present (PA) then
13194 while Present (P) loop
13195 if Pragma_Name (P) = Name_Suppress_All then
13196 Prepend_To (Context_Items (N),
13197 Make_Pragma (Sloc (P),
13198 Chars => Name_Suppress,
13199 Pragma_Argument_Associations => New_List (
13200 Make_Pragma_Argument_Association (Sloc (P),
13202 Make_Identifier (Sloc (P),
13203 Chars => Name_All_Checks)))));
13211 end Process_Compilation_Unit_Pragmas;
13222 --------------------------------
13223 -- Set_Encoded_Interface_Name --
13224 --------------------------------
13226 procedure Set_Encoded_Interface_Name (E : Entity_Id; S : Node_Id) is
13227 Str : constant String_Id := Strval (S);
13228 Len : constant Int := String_Length (Str);
13233 Hex : constant array (0 .. 15) of Character := "0123456789abcdef";
13236 -- Stores encoded value of character code CC. The encoding we use an
13237 -- underscore followed by four lower case hex digits.
13243 procedure Encode is
13245 Store_String_Char (Get_Char_Code ('_'));
13247 (Get_Char_Code (Hex (Integer (CC / 2 ** 12))));
13249 (Get_Char_Code (Hex (Integer (CC / 2 ** 8 and 16#0F#))));
13251 (Get_Char_Code (Hex (Integer (CC / 2 ** 4 and 16#0F#))));
13253 (Get_Char_Code (Hex (Integer (CC and 16#0F#))));
13256 -- Start of processing for Set_Encoded_Interface_Name
13259 -- If first character is asterisk, this is a link name, and we leave it
13260 -- completely unmodified. We also ignore null strings (the latter case
13261 -- happens only in error cases) and no encoding should occur for Java or
13262 -- AAMP interface names.
13265 or else Get_String_Char (Str, 1) = Get_Char_Code ('*')
13266 or else VM_Target /= No_VM
13267 or else AAMP_On_Target
13269 Set_Interface_Name (E, S);
13274 CC := Get_String_Char (Str, J);
13276 exit when not In_Character_Range (CC);
13278 C := Get_Character (CC);
13280 exit when C /= '_' and then C /= '$'
13281 and then C not in '0' .. '9'
13282 and then C not in 'a' .. 'z'
13283 and then C not in 'A' .. 'Z';
13286 Set_Interface_Name (E, S);
13294 -- Here we need to encode. The encoding we use as follows:
13295 -- three underscores + four hex digits (lower case)
13299 for J in 1 .. String_Length (Str) loop
13300 CC := Get_String_Char (Str, J);
13302 if not In_Character_Range (CC) then
13305 C := Get_Character (CC);
13307 if C = '_' or else C = '$'
13308 or else C in '0' .. '9'
13309 or else C in 'a' .. 'z'
13310 or else C in 'A' .. 'Z'
13312 Store_String_Char (CC);
13319 Set_Interface_Name (E,
13320 Make_String_Literal (Sloc (S),
13321 Strval => End_String));
13323 end Set_Encoded_Interface_Name;
13325 -------------------
13326 -- Set_Unit_Name --
13327 -------------------
13329 procedure Set_Unit_Name (N : Node_Id; With_Item : Node_Id) is
13334 if Nkind (N) = N_Identifier
13335 and then Nkind (With_Item) = N_Identifier
13337 Set_Entity (N, Entity (With_Item));
13339 elsif Nkind (N) = N_Selected_Component then
13340 Change_Selected_Component_To_Expanded_Name (N);
13341 Set_Entity (N, Entity (With_Item));
13342 Set_Entity (Selector_Name (N), Entity (N));
13344 Pref := Prefix (N);
13345 Scop := Scope (Entity (N));
13346 while Nkind (Pref) = N_Selected_Component loop
13347 Change_Selected_Component_To_Expanded_Name (Pref);
13348 Set_Entity (Selector_Name (Pref), Scop);
13349 Set_Entity (Pref, Scop);
13350 Pref := Prefix (Pref);
13351 Scop := Scope (Scop);
13354 Set_Entity (Pref, Scop);