1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2015, 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 -- Generally the parser checks the basic syntax of pragmas, but does not
27 -- do specialized syntax checks for individual pragmas, these are deferred
28 -- to semantic analysis time (see unit Sem_Prag). There are some pragmas
29 -- which require recognition and either partial or complete processing
30 -- during parsing, and this unit performs this required processing.
32 with Fname.UF; use Fname.UF;
33 with Osint; use Osint;
34 with Rident; use Rident;
35 with Restrict; use Restrict;
36 with Stringt; use Stringt;
37 with Stylesw; use Stylesw;
38 with Uintp; use Uintp;
39 with Uname; use Uname;
41 with System.WCh_Con; use System.WCh_Con;
45 function Prag (Pragma_Node : Node_Id; Semi : Source_Ptr) return Node_Id is
46 Prag_Name : constant Name_Id := Pragma_Name (Pragma_Node);
47 Prag_Id : constant Pragma_Id := Get_Pragma_Id (Prag_Name);
48 Pragma_Sloc : constant Source_Ptr := Sloc (Pragma_Node);
52 -----------------------
53 -- Local Subprograms --
54 -----------------------
56 procedure Add_List_Pragma_Entry (PT : List_Pragma_Type; Loc : Source_Ptr);
57 -- Make a new entry in the List_Pragmas table if this entry is not already
58 -- in the table (it will always be the last one if there is a duplication
59 -- resulting from the use of Save/Restore_Scan_State).
61 function Arg1 return Node_Id;
62 function Arg2 return Node_Id;
63 function Arg3 return Node_Id;
64 -- Obtain specified Pragma_Argument_Association. It is allowable to call
65 -- the routine for the argument one past the last present argument, but
66 -- that is the only case in which a non-present argument can be referenced.
68 procedure Check_Arg_Count (Required : Int);
69 -- Check argument count for pragma = Required. If not give error and raise
72 procedure Check_Arg_Is_String_Literal (Arg : Node_Id);
73 -- Check the expression of the specified argument to make sure that it
74 -- is a string literal. If not give error and raise Error_Resync.
76 procedure Check_Arg_Is_On_Or_Off (Arg : Node_Id);
77 -- Check the expression of the specified argument to make sure that it
78 -- is an identifier which is either ON or OFF, and if not, then issue
79 -- an error message and raise Error_Resync.
81 procedure Check_No_Identifier (Arg : Node_Id);
82 -- Checks that the given argument does not have an identifier. If
83 -- an identifier is present, then an error message is issued, and
84 -- Error_Resync is raised.
86 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id);
87 -- Checks if the given argument has an identifier, and if so, requires
88 -- it to match the given identifier name. If there is a non-matching
89 -- identifier, then an error message is given and Error_Resync raised.
91 procedure Check_Required_Identifier (Arg : Node_Id; Id : Name_Id);
92 -- Same as Check_Optional_Identifier, except that the name is required
93 -- to be present and to match the given Id value.
95 procedure Process_Restrictions_Or_Restriction_Warnings;
96 -- Common processing for Restrictions and Restriction_Warnings pragmas.
97 -- For the most part, restrictions need not be processed at parse time,
98 -- since they only affect semantic processing. This routine handles the
99 -- exceptions as follows
101 -- No_Obsolescent_Features must be processed at parse time, since there
102 -- are some obsolescent features (e.g. character replacements) which are
103 -- handled at parse time.
105 -- SPARK must be processed at parse time, since this restriction controls
106 -- whether the scanner recognizes a spark HIDE directive formatted as an
107 -- Ada comment (and generates a Tok_SPARK_Hide token for the directive).
109 -- No_Dependence must be processed at parse time, since otherwise it gets
112 -- Note that we don't need to do full error checking for badly formed cases
113 -- of restrictions, since these will be caught during semantic analysis.
115 ---------------------------
116 -- Add_List_Pragma_Entry --
117 ---------------------------
119 procedure Add_List_Pragma_Entry (PT : List_Pragma_Type; Loc : Source_Ptr) is
121 if List_Pragmas.Last < List_Pragmas.First
122 or else (List_Pragmas.Table (List_Pragmas.Last)) /= ((PT, Loc))
124 List_Pragmas.Append ((PT, Loc));
126 end Add_List_Pragma_Entry;
132 function Arg1 return Node_Id is
134 return First (Pragma_Argument_Associations (Pragma_Node));
141 function Arg2 return Node_Id is
150 function Arg3 return Node_Id is
155 ---------------------
156 -- Check_Arg_Count --
157 ---------------------
159 procedure Check_Arg_Count (Required : Int) is
161 if Arg_Count /= Required then
162 Error_Msg ("wrong number of arguments for pragma%", Pragma_Sloc);
167 ----------------------------
168 -- Check_Arg_Is_On_Or_Off --
169 ----------------------------
171 procedure Check_Arg_Is_On_Or_Off (Arg : Node_Id) is
172 Argx : constant Node_Id := Expression (Arg);
175 if Nkind (Expression (Arg)) /= N_Identifier
176 or else not Nam_In (Chars (Argx), Name_On, Name_Off)
178 Error_Msg_Name_2 := Name_On;
179 Error_Msg_Name_3 := Name_Off;
181 Error_Msg ("argument for pragma% must be% or%", Sloc (Argx));
184 end Check_Arg_Is_On_Or_Off;
186 ---------------------------------
187 -- Check_Arg_Is_String_Literal --
188 ---------------------------------
190 procedure Check_Arg_Is_String_Literal (Arg : Node_Id) is
192 if Nkind (Expression (Arg)) /= N_String_Literal then
194 ("argument for pragma% must be string literal",
195 Sloc (Expression (Arg)));
198 end Check_Arg_Is_String_Literal;
200 -------------------------
201 -- Check_No_Identifier --
202 -------------------------
204 procedure Check_No_Identifier (Arg : Node_Id) is
206 if Chars (Arg) /= No_Name then
207 Error_Msg_N ("pragma% does not permit named arguments", Arg);
210 end Check_No_Identifier;
212 -------------------------------
213 -- Check_Optional_Identifier --
214 -------------------------------
216 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id) is
218 if Present (Arg) and then Chars (Arg) /= No_Name then
219 if Chars (Arg) /= Id then
220 Error_Msg_Name_2 := Id;
221 Error_Msg_N ("pragma% argument expects identifier%", Arg);
224 end Check_Optional_Identifier;
226 -------------------------------
227 -- Check_Required_Identifier --
228 -------------------------------
230 procedure Check_Required_Identifier (Arg : Node_Id; Id : Name_Id) is
232 if Chars (Arg) /= Id then
233 Error_Msg_Name_2 := Id;
234 Error_Msg_N ("pragma% argument must have identifier%", Arg);
236 end Check_Required_Identifier;
238 --------------------------------------------------
239 -- Process_Restrictions_Or_Restriction_Warnings --
240 --------------------------------------------------
242 procedure Process_Restrictions_Or_Restriction_Warnings is
249 while Present (Arg) loop
251 Expr := Expression (Arg);
253 if Id = No_Name and then Nkind (Expr) = N_Identifier then
255 when Name_No_Obsolescent_Features =>
256 Set_Restriction (No_Obsolescent_Features, Pragma_Node);
257 Restriction_Warnings (No_Obsolescent_Features) :=
258 Prag_Id = Pragma_Restriction_Warnings;
260 when Name_SPARK | Name_SPARK_05 =>
261 Set_Restriction (SPARK_05, Pragma_Node);
262 Restriction_Warnings (SPARK_05) :=
263 Prag_Id = Pragma_Restriction_Warnings;
269 elsif Id = Name_No_Dependence then
270 Set_Restriction_No_Dependence
272 Warn => Prag_Id = Pragma_Restriction_Warnings
273 or else Treat_Restrictions_As_Warnings);
278 end Process_Restrictions_Or_Restriction_Warnings;
280 -- Start of processing for Prag
283 Error_Msg_Name_1 := Prag_Name;
285 -- Ignore unrecognized pragma. We let Sem post the warning for this, since
286 -- it is a semantic error, not a syntactic one (we have already checked
287 -- the syntax for the unrecognized pragma as required by (RM 2.8(11)).
289 if Prag_Id = Unknown_Pragma then
293 -- Ignore pragma previously flagged by Ignore_Pragma
295 if Get_Name_Table_Boolean3 (Prag_Name) then
299 -- Count number of arguments. This loop also checks if any of the arguments
300 -- are Error, indicating a syntax error as they were parsed. If so, we
301 -- simply return, because we get into trouble with cascaded errors if we
302 -- try to perform our error checks on junk arguments.
306 if Present (Pragma_Argument_Associations (Pragma_Node)) then
308 while Arg_Node /= Empty loop
309 Arg_Count := Arg_Count + 1;
311 if Expression (Arg_Node) = Error then
319 -- Remaining processing is pragma dependent
327 -- This pragma must be processed at parse time, since we want to set
328 -- the Ada version properly at parse time to recognize the appropriate
329 -- Ada version syntax.
331 when Pragma_Ada_83 =>
332 Ada_Version := Ada_83;
333 Ada_Version_Explicit := Ada_83;
334 Ada_Version_Pragma := Pragma_Node;
340 -- This pragma must be processed at parse time, since we want to set
341 -- the Ada version properly at parse time to recognize the appropriate
342 -- Ada version syntax.
344 when Pragma_Ada_95 =>
345 Ada_Version := Ada_95;
346 Ada_Version_Explicit := Ada_95;
347 Ada_Version_Pragma := Pragma_Node;
349 ---------------------
350 -- Ada_05/Ada_2005 --
351 ---------------------
353 -- These pragmas must be processed at parse time, since we want to set
354 -- the Ada version properly at parse time to recognize the appropriate
355 -- Ada version syntax. However, it is only the zero argument form that
356 -- must be processed at parse time.
358 when Pragma_Ada_05 | Pragma_Ada_2005 =>
359 if Arg_Count = 0 then
360 Ada_Version := Ada_2005;
361 Ada_Version_Explicit := Ada_2005;
362 Ada_Version_Pragma := Pragma_Node;
365 ---------------------
366 -- Ada_12/Ada_2012 --
367 ---------------------
369 -- These pragmas must be processed at parse time, since we want to set
370 -- the Ada version properly at parse time to recognize the appropriate
371 -- Ada version syntax. However, it is only the zero argument form that
372 -- must be processed at parse time.
374 when Pragma_Ada_12 | Pragma_Ada_2012 =>
375 if Arg_Count = 0 then
376 Ada_Version := Ada_2012;
377 Ada_Version_Explicit := Ada_2012;
378 Ada_Version_Pragma := Pragma_Node;
381 ---------------------------
382 -- Compiler_Unit_Warning --
383 ---------------------------
385 -- This pragma must be processed at parse time, since the resulting
386 -- status may be tested during the parsing of the program.
388 when Pragma_Compiler_Unit | Pragma_Compiler_Unit_Warning =>
391 -- Only recognized in main unit
393 if Current_Source_Unit = Main_Unit then
394 Compiler_Unit := True;
401 -- pragma Debug ([boolean_EXPRESSION,] PROCEDURE_CALL_STATEMENT);
404 Check_No_Identifier (Arg1);
406 if Arg_Count = 2 then
407 Check_No_Identifier (Arg2);
412 -------------------------------
413 -- Extensions_Allowed (GNAT) --
414 -------------------------------
416 -- pragma Extensions_Allowed (Off | On)
418 -- The processing for pragma Extensions_Allowed must be done at
419 -- parse time, since extensions mode may affect what is accepted.
421 when Pragma_Extensions_Allowed =>
423 Check_No_Identifier (Arg1);
424 Check_Arg_Is_On_Or_Off (Arg1);
426 if Chars (Expression (Arg1)) = Name_On then
427 Extensions_Allowed := True;
428 Ada_Version := Ada_2012;
430 Extensions_Allowed := False;
431 Ada_Version := Ada_Version_Explicit;
438 -- Processing for this pragma must be done at parse time, since we want
439 -- be able to ignore pragmas that are otherwise processed at parse time.
441 when Pragma_Ignore_Pragma => Ignore_Pragma : declare
446 Check_No_Identifier (Arg1);
447 A := Expression (Arg1);
449 if Nkind (A) /= N_Identifier then
450 Error_Msg ("incorrect argument for pragma %", Sloc (A));
452 Set_Name_Table_Boolean3 (Chars (A), True);
460 -- pragma List (Off | On)
462 -- The processing for pragma List must be done at parse time, since a
463 -- listing can be generated in parse only mode.
467 Check_No_Identifier (Arg1);
468 Check_Arg_Is_On_Or_Off (Arg1);
470 -- We unconditionally make a List_On entry for the pragma, so that
471 -- in the List (Off) case, the pragma will print even in a region
472 -- of code with listing turned off (this is required).
474 Add_List_Pragma_Entry (List_On, Sloc (Pragma_Node));
476 -- Now generate the list off entry for pragma List (Off)
478 if Chars (Expression (Arg1)) = Name_Off then
479 Add_List_Pragma_Entry (List_Off, Semi);
488 -- Processing for this pragma must be done at parse time, since a
489 -- listing can be generated in parse only mode with semantics off.
493 Add_List_Pragma_Entry (Page, Semi);
499 -- pragma Restrictions (RESTRICTION {, RESTRICTION});
502 -- restriction_IDENTIFIER
503 -- | restriction_parameter_IDENTIFIER => EXPRESSION
505 -- We process the case of No_Obsolescent_Features, since this has
506 -- a syntactic effect that we need to detect at parse time (the use
507 -- of replacement characters such as colon for pound sign).
509 when Pragma_Restrictions =>
510 Process_Restrictions_Or_Restriction_Warnings;
512 --------------------------
513 -- Restriction_Warnings --
514 --------------------------
516 -- pragma Restriction_Warnings (RESTRICTION {, RESTRICTION});
519 -- restriction_IDENTIFIER
520 -- | restriction_parameter_IDENTIFIER => EXPRESSION
522 -- See above comment for pragma Restrictions
524 when Pragma_Restriction_Warnings =>
525 Process_Restrictions_Or_Restriction_Warnings;
527 ----------------------------------------------------------
528 -- Source_File_Name and Source_File_Name_Project (GNAT) --
529 ----------------------------------------------------------
531 -- These two pragmas have the same syntax and semantics.
532 -- There are five forms of these pragmas:
534 -- pragma Source_File_Name[_Project] (
535 -- [UNIT_NAME =>] unit_NAME,
536 -- BODY_FILE_NAME => STRING_LITERAL
537 -- [, [INDEX =>] INTEGER_LITERAL]);
539 -- pragma Source_File_Name[_Project] (
540 -- [UNIT_NAME =>] unit_NAME,
541 -- SPEC_FILE_NAME => STRING_LITERAL
542 -- [, [INDEX =>] INTEGER_LITERAL]);
544 -- pragma Source_File_Name[_Project] (
545 -- BODY_FILE_NAME => STRING_LITERAL
546 -- [, DOT_REPLACEMENT => STRING_LITERAL]
547 -- [, CASING => CASING_SPEC]);
549 -- pragma Source_File_Name[_Project] (
550 -- SPEC_FILE_NAME => STRING_LITERAL
551 -- [, DOT_REPLACEMENT => STRING_LITERAL]
552 -- [, CASING => CASING_SPEC]);
554 -- pragma Source_File_Name[_Project] (
555 -- SUBUNIT_FILE_NAME => STRING_LITERAL
556 -- [, DOT_REPLACEMENT => STRING_LITERAL]
557 -- [, CASING => CASING_SPEC]);
559 -- CASING_SPEC ::= Uppercase | Lowercase | Mixedcase
561 -- Pragma Source_File_Name_Project (SFNP) is equivalent to pragma
562 -- Source_File_Name (SFN), however their usage is exclusive:
563 -- SFN can only be used when no project file is used, while
564 -- SFNP can only be used when a project file is used.
566 -- The Project Manager produces a configuration pragmas file that
567 -- is communicated to the compiler with -gnatec switch. This file
568 -- contains only SFNP pragmas (at least two for the default naming
569 -- scheme. As this configuration pragmas file is always the first
570 -- processed by the compiler, it prevents the use of pragmas SFN in
571 -- other config files when a project file is in use.
573 -- Note: we process this during parsing, since we need to have the
574 -- source file names set well before the semantic analysis starts,
575 -- since we load the spec and with'ed packages before analysis.
577 when Pragma_Source_File_Name | Pragma_Source_File_Name_Project =>
578 Source_File_Name : declare
579 Unam : Unit_Name_Type;
589 function Get_Fname (Arg : Node_Id) return File_Name_Type;
590 -- Process file name from unit name form of pragma
592 function Get_String_Argument (Arg : Node_Id) return String_Ptr;
593 -- Process string literal value from argument
595 procedure Process_Casing (Arg : Node_Id);
596 -- Process Casing argument of pattern form of pragma
598 procedure Process_Dot_Replacement (Arg : Node_Id);
599 -- Process Dot_Replacement argument of pattern form of pragma
605 function Get_Fname (Arg : Node_Id) return File_Name_Type is
607 String_To_Name_Buffer (Strval (Expression (Arg)));
609 for J in 1 .. Name_Len loop
610 if Is_Directory_Separator (Name_Buffer (J)) then
612 ("directory separator character not allowed",
613 Sloc (Expression (Arg)) + Source_Ptr (J));
620 -------------------------
621 -- Get_String_Argument --
622 -------------------------
624 function Get_String_Argument (Arg : Node_Id) return String_Ptr is
628 if Nkind (Expression (Arg)) /= N_String_Literal
630 Nkind (Expression (Arg)) /= N_Operator_Symbol
633 ("argument for pragma% must be string literal", Arg);
637 Str := Strval (Expression (Arg));
639 -- Check string has no wide chars
641 for J in 1 .. String_Length (Str) loop
642 if Get_String_Char (Str, J) > 255 then
644 ("wide character not allowed in pattern for pragma%",
645 Sloc (Expression (Arg2)) + Text_Ptr (J) - 1);
651 String_To_Name_Buffer (Str);
652 return new String'(Name_Buffer (1 .. Name_Len));
653 end Get_String_Argument;
659 procedure Process_Casing (Arg : Node_Id) is
660 Expr : constant Node_Id := Expression (Arg);
663 Check_Required_Identifier (Arg, Name_Casing);
665 if Nkind (Expr) = N_Identifier then
666 if Chars (Expr) = Name_Lowercase then
667 Cas := All_Lower_Case;
669 elsif Chars (Expr) = Name_Uppercase then
670 Cas := All_Upper_Case;
672 elsif Chars (Expr) = Name_Mixedcase then
679 ("Casing argument for pragma% must be " &
680 "one of Mixedcase, Lowercase, Uppercase",
684 -----------------------------
685 -- Process_Dot_Replacement --
686 -----------------------------
688 procedure Process_Dot_Replacement (Arg : Node_Id) is
690 Check_Required_Identifier (Arg, Name_Dot_Replacement);
691 Dot := Get_String_Argument (Arg);
692 end Process_Dot_Replacement;
694 -- Start of processing for Source_File_Name and
695 -- Source_File_Name_Project pragmas.
698 if Prag_Id = Pragma_Source_File_Name then
699 if Project_File_In_Use = In_Use then
701 ("pragma Source_File_Name cannot be used " &
702 "with a project file", Pragma_Sloc);
705 Project_File_In_Use := Not_In_Use;
709 if Project_File_In_Use = Not_In_Use then
711 ("pragma Source_File_Name_Project should only be used " &
712 "with a project file", Pragma_Sloc);
714 Project_File_In_Use := In_Use;
718 -- We permit from 1 to 3 arguments
720 if Arg_Count not in 1 .. 3 then
724 Expr1 := Expression (Arg1);
726 -- If first argument is identifier or selected component, then
727 -- we have the specific file case of the Source_File_Name pragma,
728 -- and the first argument is a unit name.
730 if Nkind (Expr1) = N_Identifier
732 (Nkind (Expr1) = N_Selected_Component
734 Nkind (Selector_Name (Expr1)) = N_Identifier)
736 if Nkind (Expr1) = N_Identifier
737 and then Chars (Expr1) = Name_System
740 ("pragma Source_File_Name may not be used for System",
745 -- Process index argument if present
747 if Arg_Count = 3 then
748 Expr := Expression (Arg3);
750 if Nkind (Expr) /= N_Integer_Literal
751 or else not UI_Is_In_Int_Range (Intval (Expr))
752 or else Intval (Expr) > 999
753 or else Intval (Expr) <= 0
756 ("pragma% index must be integer literal" &
757 " in range 1 .. 999", Sloc (Expr));
760 Index := UI_To_Int (Intval (Expr));
763 -- No index argument present
770 Check_Optional_Identifier (Arg1, Name_Unit_Name);
771 Unam := Get_Unit_Name (Expr1);
773 Check_Arg_Is_String_Literal (Arg2);
775 if Chars (Arg2) = Name_Spec_File_Name then
777 (Get_Spec_Name (Unam), Get_Fname (Arg2), Index);
779 elsif Chars (Arg2) = Name_Body_File_Name then
781 (Unam, Get_Fname (Arg2), Index);
785 ("pragma% argument has incorrect identifier", Arg2);
789 -- If the first argument is not an identifier, then we must have
790 -- the pattern form of the pragma, and the first argument must be
791 -- the pattern string with an appropriate name.
794 if Chars (Arg1) = Name_Spec_File_Name then
797 elsif Chars (Arg1) = Name_Body_File_Name then
800 elsif Chars (Arg1) = Name_Subunit_File_Name then
803 elsif Chars (Arg1) = Name_Unit_Name then
805 ("Unit_Name parameter for pragma% must be an identifier",
811 ("pragma% argument has incorrect identifier", Arg1);
815 Pat := Get_String_Argument (Arg1);
817 -- Check pattern has exactly one asterisk
820 for J in Pat'Range loop
821 if Pat (J) = '*' then
828 ("file name pattern must have exactly one * character",
833 -- Set defaults for Casing and Dot_Separator parameters
835 Cas := All_Lower_Case;
836 Dot := new String'(".");
838 -- Process second and third arguments if present
840 if Arg_Count > 1 then
841 if Chars (Arg2) = Name_Casing then
842 Process_Casing (Arg2);
844 if Arg_Count = 3 then
845 Process_Dot_Replacement (Arg3);
849 Process_Dot_Replacement (Arg2);
851 if Arg_Count = 3 then
852 Process_Casing (Arg3);
857 Set_File_Name_Pattern (Pat, Typ, Dot, Cas);
859 end Source_File_Name;
861 -----------------------------
862 -- Source_Reference (GNAT) --
863 -----------------------------
865 -- pragma Source_Reference
866 -- (INTEGER_LITERAL [, STRING_LITERAL] );
868 -- Processing for this pragma must be done at parse time, since error
869 -- messages needing the proper line numbers can be generated in parse
870 -- only mode with semantic checking turned off, and indeed we usually
871 -- turn off semantic checking anyway if any parse errors are found.
873 when Pragma_Source_Reference => Source_Reference : declare
874 Fname : File_Name_Type;
877 if Arg_Count /= 1 then
879 Check_No_Identifier (Arg2);
882 -- Check that this is first line of file. We skip this test if
883 -- we are in syntax check only mode, since we may be dealing with
884 -- multiple compilation units.
886 if Get_Physical_Line_Number (Pragma_Sloc) /= 1
887 and then Num_SRef_Pragmas (Current_Source_File) = 0
888 and then Operating_Mode /= Check_Syntax
891 ("first % pragma must be first line of file", Pragma_Sloc);
895 Check_No_Identifier (Arg1);
897 if Arg_Count = 1 then
898 if Num_SRef_Pragmas (Current_Source_File) = 0 then
900 ("file name required for first % pragma in file",
910 Check_Arg_Is_String_Literal (Arg2);
911 String_To_Name_Buffer (Strval (Expression (Arg2)));
914 if Num_SRef_Pragmas (Current_Source_File) > 0 then
915 if Fname /= Full_Ref_Name (Current_Source_File) then
917 ("file name must be same in all % pragmas", Pragma_Sloc);
923 if Nkind (Expression (Arg1)) /= N_Integer_Literal then
925 ("argument for pragma% must be integer literal",
926 Sloc (Expression (Arg1)));
929 -- OK, this source reference pragma is effective, however, we
930 -- ignore it if it is not in the first unit in the multiple unit
931 -- case. This is because the only purpose in this case is to
932 -- provide source pragmas for subsequent use by gnatchop.
935 if Num_Library_Units = 1 then
936 Register_Source_Ref_Pragma
938 Strip_Directory (Fname),
939 UI_To_Int (Intval (Expression (Arg1))),
940 Get_Physical_Line_Number (Pragma_Sloc) + 1);
943 end Source_Reference;
945 -------------------------
946 -- Style_Checks (GNAT) --
947 -------------------------
949 -- pragma Style_Checks (On | Off | ALL_CHECKS | STRING_LITERAL);
951 -- This is processed by the parser since some of the style
952 -- checks take place during source scanning and parsing.
954 when Pragma_Style_Checks => Style_Checks : declare
958 OK : Boolean := True;
961 -- Two argument case is only for semantics
963 if Arg_Count = 2 then
968 Check_No_Identifier (Arg1);
969 A := Expression (Arg1);
971 if Nkind (A) = N_String_Literal then
975 Slen : constant Natural := Natural (String_Length (S));
976 Options : String (1 .. Slen);
983 C := Get_String_Char (S, Int (J));
985 if not In_Character_Range (C) then
991 Options (J) := Get_Character (C);
995 if not Ignore_Style_Checks_Pragmas then
996 Set_Style_Check_Options (Options, OK, Ptr);
1008 (Style_Msg_Buf (1 .. Style_Msg_Len),
1009 Sloc (Expression (Arg1)) + Source_Ptr (Ptr));
1014 elsif Nkind (A) /= N_Identifier then
1017 elsif Chars (A) = Name_All_Checks then
1018 if not Ignore_Style_Checks_Pragmas then
1020 Stylesw.Set_GNAT_Style_Check_Options;
1022 Stylesw.Set_Default_Style_Check_Options;
1026 elsif Chars (A) = Name_On then
1027 if not Ignore_Style_Checks_Pragmas then
1028 Style_Check := True;
1031 elsif Chars (A) = Name_Off then
1032 if not Ignore_Style_Checks_Pragmas then
1033 Style_Check := False;
1041 Error_Msg ("incorrect argument for pragma%", Sloc (A));
1047 -------------------------
1048 -- Suppress_All (GNAT) --
1049 -------------------------
1051 -- pragma Suppress_All
1053 -- This is a rather odd pragma, because other compilers allow it in
1054 -- strange places. DEC allows it at the end of units, and Rational
1055 -- allows it as a program unit pragma, when it would be more natural
1056 -- if it were a configuration pragma.
1058 -- Since the reason we provide this pragma is for compatibility with
1059 -- these other compilers, we want to accommodate these strange placement
1060 -- rules, and the easiest thing is simply to allow it anywhere in a
1061 -- unit. If this pragma appears anywhere within a unit, then the effect
1062 -- is as though a pragma Suppress (All_Checks) had appeared as the first
1063 -- line of the current file, i.e. as the first configuration pragma in
1064 -- the current unit.
1066 -- To get this effect, we set the flag Has_Pragma_Suppress_All in the
1067 -- compilation unit node for the current source file then in the last
1068 -- stage of parsing a file, if this flag is set, we materialize the
1069 -- Suppress (All_Checks) pragma, marked as not coming from Source.
1071 when Pragma_Suppress_All =>
1072 Set_Has_Pragma_Suppress_All (Cunit (Current_Source_Unit));
1074 ---------------------
1075 -- Warnings (GNAT) --
1076 ---------------------
1078 -- pragma Warnings ([TOOL_NAME,] DETAILS [, REASON]);
1080 -- DETAILS ::= On | Off
1081 -- DETAILS ::= On | Off, local_NAME
1082 -- DETAILS ::= static_string_EXPRESSION
1083 -- DETAILS ::= On | Off, static_string_EXPRESSION
1085 -- TOOL_NAME ::= GNAT | GNATProve
1087 -- REASON ::= Reason => STRING_LITERAL {& STRING_LITERAL}
1089 -- Note: If the first argument matches an allowed tool name, it is
1090 -- always considered to be a tool name, even if there is a string
1091 -- variable of that name.
1093 -- The one argument ON/OFF case is processed by the parser, since it may
1094 -- control parser warnings as well as semantic warnings, and in any case
1095 -- we want to be absolutely sure that the range in the warnings table is
1096 -- set well before any semantic analysis is performed. Note that we
1097 -- ignore this pragma if debug flag -gnatd.i is set.
1099 -- Also note that the "one argument" case may have two or three
1100 -- arguments if the first one is a tool name, and/or the last one is a
1103 when Pragma_Warnings => Warnings : declare
1104 function First_Arg_Is_Matching_Tool_Name return Boolean;
1105 -- Returns True if the first argument is a tool name matching the
1106 -- current tool being run.
1108 function Last_Arg return Node_Id;
1109 -- Returns the last argument
1111 function Last_Arg_Is_Reason return Boolean;
1112 -- Returns True if the last argument is a reason argument
1114 function Get_Reason return String_Id;
1115 -- Analyzes Reason argument and returns corresponding String_Id
1116 -- value, or null if there is no Reason argument, or if the
1117 -- argument is not of the required form.
1119 -------------------------------------
1120 -- First_Arg_Is_Matching_Tool_Name --
1121 -------------------------------------
1123 function First_Arg_Is_Matching_Tool_Name return Boolean is
1125 return Nkind (Arg1) = N_Identifier
1127 -- Return True if the tool name is GNAT, and we're not in
1128 -- GNATprove or CodePeer or ASIS mode...
1130 and then ((Chars (Arg1) = Name_Gnat
1132 (CodePeer_Mode or GNATprove_Mode or ASIS_Mode))
1134 -- or if the tool name is GNATprove, and we're in GNATprove
1138 (Chars (Arg1) = Name_Gnatprove
1139 and then GNATprove_Mode));
1140 end First_Arg_Is_Matching_Tool_Name;
1146 function Get_Reason return String_Id is
1147 Arg : constant Node_Id := Last_Arg;
1149 if Last_Arg_Is_Reason then
1151 Get_Reason_String (Expression (Arg));
1154 return Null_String_Id;
1162 function Last_Arg return Node_Id is
1166 if Arg_Count = 1 then
1168 elsif Arg_Count = 2 then
1170 elsif Arg_Count = 3 then
1172 elsif Arg_Count = 4 then
1173 Last_Arg := Next (Arg3);
1175 -- Illegal case, error issued in semantic analysis
1184 ------------------------
1185 -- Last_Arg_Is_Reason --
1186 ------------------------
1188 function Last_Arg_Is_Reason return Boolean is
1189 Arg : constant Node_Id := Last_Arg;
1191 return Nkind (Arg) in N_Has_Chars
1192 and then Chars (Arg) = Name_Reason;
1193 end Last_Arg_Is_Reason;
1195 The_Arg : Node_Id; -- On/Off argument
1198 -- Start of processing for Warnings
1201 if not Debug_Flag_Dot_I
1202 and then (Arg_Count = 1
1203 or else (Arg_Count = 2
1204 and then (First_Arg_Is_Matching_Tool_Name
1206 Last_Arg_Is_Reason))
1207 or else (Arg_Count = 3
1208 and then First_Arg_Is_Matching_Tool_Name
1209 and then Last_Arg_Is_Reason))
1211 if First_Arg_Is_Matching_Tool_Name then
1217 Check_No_Identifier (The_Arg);
1218 Argx := Expression (The_Arg);
1220 if Nkind (Argx) = N_Identifier then
1221 if Chars (Argx) = Name_On then
1222 Set_Warnings_Mode_On (Pragma_Sloc);
1223 elsif Chars (Argx) = Name_Off then
1224 Set_Warnings_Mode_Off (Pragma_Sloc, Get_Reason);
1230 -----------------------------
1231 -- Wide_Character_Encoding --
1232 -----------------------------
1234 -- pragma Wide_Character_Encoding (IDENTIFIER | CHARACTER_LITERAL);
1236 -- This is processed by the parser, since the scanner is affected
1238 when Pragma_Wide_Character_Encoding => Wide_Character_Encoding : declare
1242 Check_Arg_Count (1);
1243 Check_No_Identifier (Arg1);
1244 A := Expression (Arg1);
1246 if Nkind (A) = N_Identifier then
1247 Get_Name_String (Chars (A));
1248 Wide_Character_Encoding_Method :=
1249 Get_WC_Encoding_Method (Name_Buffer (1 .. Name_Len));
1251 elsif Nkind (A) = N_Character_Literal then
1253 R : constant Char_Code :=
1254 Char_Code (UI_To_Int (Char_Literal_Value (A)));
1256 if In_Character_Range (R) then
1257 Wide_Character_Encoding_Method :=
1258 Get_WC_Encoding_Method (Get_Character (R));
1260 raise Constraint_Error;
1265 raise Constraint_Error;
1268 Upper_Half_Encoding :=
1269 Wide_Character_Encoding_Method in
1270 WC_Upper_Half_Encoding_Method;
1273 when Constraint_Error =>
1274 Error_Msg_N ("invalid argument for pragma%", Arg1);
1275 end Wide_Character_Encoding;
1277 -----------------------
1278 -- All Other Pragmas --
1279 -----------------------
1281 -- For all other pragmas, checking and processing is handled
1282 -- entirely in Sem_Prag, and no further checking is done by Par.
1284 when Pragma_Abort_Defer |
1285 Pragma_Abstract_State |
1286 Pragma_Async_Readers |
1287 Pragma_Async_Writers |
1288 Pragma_Assertion_Policy |
1290 Pragma_Assume_No_Invalid_Values |
1291 Pragma_All_Calls_Remote |
1292 Pragma_Allow_Integer_Address |
1295 Pragma_Assert_And_Cut |
1296 Pragma_Asynchronous |
1298 Pragma_Atomic_Components |
1299 Pragma_Attach_Handler |
1300 Pragma_Attribute_Definition |
1302 Pragma_Check_Float_Overflow |
1304 Pragma_Check_Policy |
1305 Pragma_CIL_Constructor |
1306 Pragma_Compile_Time_Error |
1307 Pragma_Compile_Time_Warning |
1308 Pragma_Contract_Cases |
1309 Pragma_Convention_Identifier |
1311 Pragma_CPP_Constructor |
1312 Pragma_CPP_Virtual |
1315 Pragma_C_Pass_By_Copy |
1317 Pragma_Common_Object |
1318 Pragma_Complete_Representation |
1319 Pragma_Complex_Representation |
1320 Pragma_Component_Alignment |
1323 Pragma_Debug_Policy |
1325 Pragma_Detect_Blocking |
1326 Pragma_Default_Initial_Condition |
1327 Pragma_Default_Scalar_Storage_Order |
1328 Pragma_Default_Storage_Pool |
1329 Pragma_Disable_Atomic_Synchronization |
1330 Pragma_Discard_Names |
1331 Pragma_Dispatching_Domain |
1332 Pragma_Effective_Reads |
1333 Pragma_Effective_Writes |
1336 Pragma_Elaborate_All |
1337 Pragma_Elaborate_Body |
1338 Pragma_Elaboration_Checks |
1339 Pragma_Enable_Atomic_Synchronization |
1341 Pragma_Export_Function |
1342 Pragma_Export_Object |
1343 Pragma_Export_Procedure |
1344 Pragma_Export_Value |
1345 Pragma_Export_Valued_Procedure |
1346 Pragma_Extend_System |
1347 Pragma_Extensions_Visible |
1349 Pragma_External_Name_Casing |
1350 Pragma_Favor_Top_Level |
1352 Pragma_Finalize_Storage_Only |
1356 Pragma_Implementation_Defined |
1357 Pragma_Implemented |
1358 Pragma_Implicit_Packing |
1360 Pragma_Import_Function |
1361 Pragma_Import_Object |
1362 Pragma_Import_Procedure |
1363 Pragma_Import_Valued_Procedure |
1364 Pragma_Independent |
1365 Pragma_Independent_Components |
1366 Pragma_Initial_Condition |
1367 Pragma_Initialize_Scalars |
1368 Pragma_Initializes |
1370 Pragma_Inline_Always |
1371 Pragma_Inline_Generic |
1372 Pragma_Inspection_Point |
1374 Pragma_Interface_Name |
1375 Pragma_Interrupt_Handler |
1376 Pragma_Interrupt_State |
1377 Pragma_Interrupt_Priority |
1379 Pragma_Java_Constructor |
1380 Pragma_Java_Interface |
1384 Pragma_Linker_Alias |
1385 Pragma_Linker_Constructor |
1386 Pragma_Linker_Destructor |
1387 Pragma_Linker_Options |
1388 Pragma_Linker_Section |
1390 Pragma_Locking_Policy |
1391 Pragma_Loop_Invariant |
1392 Pragma_Loop_Optimize |
1393 Pragma_Loop_Variant |
1394 Pragma_Machine_Attribute |
1396 Pragma_Main_Storage |
1397 Pragma_Memory_Size |
1399 Pragma_No_Elaboration_Code_All |
1402 Pragma_No_Run_Time |
1403 Pragma_No_Strict_Aliasing |
1404 Pragma_No_Tagged_Streams |
1405 Pragma_Normalize_Scalars |
1406 Pragma_Obsolescent |
1409 Pragma_Optimize_Alignment |
1410 Pragma_Overflow_Mode |
1411 Pragma_Overriding_Renamings |
1414 Pragma_Partition_Elaboration_Policy |
1416 Pragma_Preelaborable_Initialization |
1418 Pragma_Prefix_Exception_Messages |
1419 Pragma_Persistent_BSS |
1421 Pragma_Postcondition |
1424 Pragma_Precondition |
1426 Pragma_Preelaborate |
1429 Pragma_Priority_Specific_Dispatching |
1431 Pragma_Profile_Warnings |
1432 Pragma_Propagate_Exceptions |
1433 Pragma_Provide_Shift_Operators |
1434 Pragma_Psect_Object |
1436 Pragma_Pure_Function |
1437 Pragma_Queuing_Policy |
1438 Pragma_Refined_Depends |
1439 Pragma_Refined_Global |
1440 Pragma_Refined_Post |
1441 Pragma_Refined_State |
1442 Pragma_Relative_Deadline |
1443 Pragma_Remote_Access_Type |
1444 Pragma_Remote_Call_Interface |
1445 Pragma_Remote_Types |
1446 Pragma_Restricted_Run_Time |
1450 Pragma_Share_Generic |
1452 Pragma_Shared_Passive |
1453 Pragma_Short_Circuit_And_Or |
1454 Pragma_Short_Descriptors |
1455 Pragma_Simple_Storage_Pool_Type |
1457 Pragma_Storage_Size |
1458 Pragma_Storage_Unit |
1459 Pragma_Static_Elaboration_Desired |
1460 Pragma_Stream_Convert |
1463 Pragma_Suppress_Debug_Info |
1464 Pragma_Suppress_Exception_Locations |
1465 Pragma_Suppress_Initialization |
1466 Pragma_System_Name |
1467 Pragma_Task_Dispatching_Policy |
1470 Pragma_Task_Storage |
1472 Pragma_Thread_Local_Storage |
1475 Pragma_Type_Invariant |
1476 Pragma_Type_Invariant_Class |
1477 Pragma_Unchecked_Union |
1478 Pragma_Unevaluated_Use_Of_Old |
1479 Pragma_Unimplemented_Unit |
1480 Pragma_Universal_Aliasing |
1481 Pragma_Universal_Data |
1483 Pragma_Unreferenced |
1484 Pragma_Unreferenced_Objects |
1485 Pragma_Unreserve_All_Interrupts |
1487 Pragma_Use_VADS_Size |
1489 Pragma_Volatile_Components |
1490 Pragma_Volatile_Full_Access |
1491 Pragma_Warning_As_Error |
1492 Pragma_Weak_External |
1493 Pragma_Validity_Checks =>
1496 --------------------
1497 -- Unknown_Pragma --
1498 --------------------
1500 -- Should be impossible, since we excluded this case earlier on
1502 when Unknown_Pragma =>
1503 raise Program_Error;
1509 --------------------
1510 -- Error Handling --
1511 --------------------
1514 when Error_Resync =>