1------------------------------------------------------------------------------ 2-- -- 3-- GNAT COMPILER COMPONENTS -- 4-- -- 5-- P A R . P R A G -- 6-- -- 7-- B o d y -- 8-- -- 9-- Copyright (C) 1992-2013, Free Software Foundation, Inc. -- 10-- -- 11-- GNAT is free software; you can redistribute it and/or modify it under -- 12-- terms of the GNU General Public License as published by the Free Soft- -- 13-- ware Foundation; either version 3, or (at your option) any later ver- -- 14-- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- 15-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -- 16-- or FITNESS FOR A PARTICULAR PURPOSE. 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. -- 20-- -- 21-- GNAT was originally developed by the GNAT team at New York University. -- 22-- Extensive contributions were provided by Ada Core Technologies Inc. -- 23-- -- 24------------------------------------------------------------------------------ 25 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. 31 32with Fname.UF; use Fname.UF; 33with Osint; use Osint; 34with Rident; use Rident; 35with Restrict; use Restrict; 36with Stringt; use Stringt; 37with Stylesw; use Stylesw; 38with Uintp; use Uintp; 39with Uname; use Uname; 40 41with System.WCh_Con; use System.WCh_Con; 42 43separate (Par) 44 45function 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); 49 Arg_Count : Nat; 50 Arg_Node : Node_Id; 51 52 ----------------------- 53 -- Local Subprograms -- 54 ----------------------- 55 56 function Arg1 return Node_Id; 57 function Arg2 return Node_Id; 58 function Arg3 return Node_Id; 59 -- Obtain specified Pragma_Argument_Association. It is allowable to call 60 -- the routine for the argument one past the last present argument, but 61 -- that is the only case in which a non-present argument can be referenced. 62 63 procedure Check_Arg_Count (Required : Int); 64 -- Check argument count for pragma = Required. If not give error and raise 65 -- Error_Resync. 66 67 procedure Check_Arg_Is_String_Literal (Arg : Node_Id); 68 -- Check the expression of the specified argument to make sure that it 69 -- is a string literal. If not give error and raise Error_Resync. 70 71 procedure Check_Arg_Is_On_Or_Off (Arg : Node_Id); 72 -- Check the expression of the specified argument to make sure that it 73 -- is an identifier which is either ON or OFF, and if not, then issue 74 -- an error message and raise Error_Resync. 75 76 procedure Check_No_Identifier (Arg : Node_Id); 77 -- Checks that the given argument does not have an identifier. If 78 -- an identifier is present, then an error message is issued, and 79 -- Error_Resync is raised. 80 81 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id); 82 -- Checks if the given argument has an identifier, and if so, requires 83 -- it to match the given identifier name. If there is a non-matching 84 -- identifier, then an error message is given and Error_Resync raised. 85 86 procedure Check_Required_Identifier (Arg : Node_Id; Id : Name_Id); 87 -- Same as Check_Optional_Identifier, except that the name is required 88 -- to be present and to match the given Id value. 89 90 procedure Process_Restrictions_Or_Restriction_Warnings; 91 -- Common processing for Restrictions and Restriction_Warnings pragmas. 92 -- For the most part, restrictions need not be processed at parse time, 93 -- since they only affect semantic processing. This routine handles the 94 -- exceptions as follows 95 -- 96 -- No_Obsolescent_Features must be processed at parse time, since there 97 -- are some obsolescent features (e.g. character replacements) which are 98 -- handled at parse time. 99 -- 100 -- SPARK must be processed at parse time, since this restriction controls 101 -- whether the scanner recognizes a spark HIDE directive formatted as an 102 -- Ada comment (and generates a Tok_SPARK_Hide token for the directive). 103 -- 104 -- No_Dependence must be processed at parse time, since otherwise it gets 105 -- handled too late. 106 -- 107 -- Note that we don't need to do full error checking for badly formed cases 108 -- of restrictions, since these will be caught during semantic analysis. 109 110 ---------- 111 -- Arg1 -- 112 ---------- 113 114 function Arg1 return Node_Id is 115 begin 116 return First (Pragma_Argument_Associations (Pragma_Node)); 117 end Arg1; 118 119 ---------- 120 -- Arg2 -- 121 ---------- 122 123 function Arg2 return Node_Id is 124 begin 125 return Next (Arg1); 126 end Arg2; 127 128 ---------- 129 -- Arg3 -- 130 ---------- 131 132 function Arg3 return Node_Id is 133 begin 134 return Next (Arg2); 135 end Arg3; 136 137 --------------------- 138 -- Check_Arg_Count -- 139 --------------------- 140 141 procedure Check_Arg_Count (Required : Int) is 142 begin 143 if Arg_Count /= Required then 144 Error_Msg ("wrong number of arguments for pragma%", Pragma_Sloc); 145 raise Error_Resync; 146 end if; 147 end Check_Arg_Count; 148 149 ---------------------------- 150 -- Check_Arg_Is_On_Or_Off -- 151 ---------------------------- 152 153 procedure Check_Arg_Is_On_Or_Off (Arg : Node_Id) is 154 Argx : constant Node_Id := Expression (Arg); 155 156 begin 157 if Nkind (Expression (Arg)) /= N_Identifier 158 or else (Chars (Argx) /= Name_On 159 and then 160 Chars (Argx) /= Name_Off) 161 then 162 Error_Msg_Name_2 := Name_On; 163 Error_Msg_Name_3 := Name_Off; 164 165 Error_Msg ("argument for pragma% must be% or%", Sloc (Argx)); 166 raise Error_Resync; 167 end if; 168 end Check_Arg_Is_On_Or_Off; 169 170 --------------------------------- 171 -- Check_Arg_Is_String_Literal -- 172 --------------------------------- 173 174 procedure Check_Arg_Is_String_Literal (Arg : Node_Id) is 175 begin 176 if Nkind (Expression (Arg)) /= N_String_Literal then 177 Error_Msg 178 ("argument for pragma% must be string literal", 179 Sloc (Expression (Arg))); 180 raise Error_Resync; 181 end if; 182 end Check_Arg_Is_String_Literal; 183 184 ------------------------- 185 -- Check_No_Identifier -- 186 ------------------------- 187 188 procedure Check_No_Identifier (Arg : Node_Id) is 189 begin 190 if Chars (Arg) /= No_Name then 191 Error_Msg_N ("pragma% does not permit named arguments", Arg); 192 raise Error_Resync; 193 end if; 194 end Check_No_Identifier; 195 196 ------------------------------- 197 -- Check_Optional_Identifier -- 198 ------------------------------- 199 200 procedure Check_Optional_Identifier (Arg : Node_Id; Id : Name_Id) is 201 begin 202 if Present (Arg) and then Chars (Arg) /= No_Name then 203 if Chars (Arg) /= Id then 204 Error_Msg_Name_2 := Id; 205 Error_Msg_N ("pragma% argument expects identifier%", Arg); 206 end if; 207 end if; 208 end Check_Optional_Identifier; 209 210 ------------------------------- 211 -- Check_Required_Identifier -- 212 ------------------------------- 213 214 procedure Check_Required_Identifier (Arg : Node_Id; Id : Name_Id) is 215 begin 216 if Chars (Arg) /= Id then 217 Error_Msg_Name_2 := Id; 218 Error_Msg_N ("pragma% argument must have identifier%", Arg); 219 end if; 220 end Check_Required_Identifier; 221 222 -------------------------------------------------- 223 -- Process_Restrictions_Or_Restriction_Warnings -- 224 -------------------------------------------------- 225 226 procedure Process_Restrictions_Or_Restriction_Warnings is 227 Arg : Node_Id; 228 Id : Name_Id; 229 Expr : Node_Id; 230 231 begin 232 Arg := Arg1; 233 while Present (Arg) loop 234 Id := Chars (Arg); 235 Expr := Expression (Arg); 236 237 if Id = No_Name 238 and then Nkind (Expr) = N_Identifier 239 then 240 case Get_Restriction_Id (Chars (Expr)) is 241 when No_Obsolescent_Features => 242 Set_Restriction (No_Obsolescent_Features, Pragma_Node); 243 Restriction_Warnings (No_Obsolescent_Features) := 244 Prag_Id = Pragma_Restriction_Warnings; 245 246 when SPARK => 247 Set_Restriction (SPARK, Pragma_Node); 248 Restriction_Warnings (SPARK) := 249 Prag_Id = Pragma_Restriction_Warnings; 250 251 when others => 252 null; 253 end case; 254 255 elsif Id = Name_No_Dependence then 256 Set_Restriction_No_Dependence 257 (Unit => Expr, 258 Warn => Prag_Id = Pragma_Restriction_Warnings 259 or else Treat_Restrictions_As_Warnings); 260 end if; 261 262 Next (Arg); 263 end loop; 264 end Process_Restrictions_Or_Restriction_Warnings; 265 266-- Start of processing for Prag 267 268begin 269 Error_Msg_Name_1 := Prag_Name; 270 271 -- Ignore unrecognized pragma. We let Sem post the warning for this, since 272 -- it is a semantic error, not a syntactic one (we have already checked 273 -- the syntax for the unrecognized pragma as required by (RM 2.8(11)). 274 275 if Prag_Id = Unknown_Pragma then 276 return Pragma_Node; 277 end if; 278 279 -- Count number of arguments. This loop also checks if any of the arguments 280 -- are Error, indicating a syntax error as they were parsed. If so, we 281 -- simply return, because we get into trouble with cascaded errors if we 282 -- try to perform our error checks on junk arguments. 283 284 Arg_Count := 0; 285 286 if Present (Pragma_Argument_Associations (Pragma_Node)) then 287 Arg_Node := Arg1; 288 while Arg_Node /= Empty loop 289 Arg_Count := Arg_Count + 1; 290 291 if Expression (Arg_Node) = Error then 292 return Error; 293 end if; 294 295 Next (Arg_Node); 296 end loop; 297 end if; 298 299 -- Remaining processing is pragma dependent 300 301 case Prag_Id is 302 303 ------------ 304 -- Ada_83 -- 305 ------------ 306 307 -- This pragma must be processed at parse time, since we want to set 308 -- the Ada version properly at parse time to recognize the appropriate 309 -- Ada version syntax. 310 311 when Pragma_Ada_83 => 312 Ada_Version := Ada_83; 313 Ada_Version_Explicit := Ada_83; 314 315 ------------ 316 -- Ada_95 -- 317 ------------ 318 319 -- This pragma must be processed at parse time, since we want to set 320 -- the Ada version properly at parse time to recognize the appropriate 321 -- Ada version syntax. 322 323 when Pragma_Ada_95 => 324 Ada_Version := Ada_95; 325 Ada_Version_Explicit := Ada_95; 326 327 --------------------- 328 -- Ada_05/Ada_2005 -- 329 --------------------- 330 331 -- These pragmas must be processed at parse time, since we want to set 332 -- the Ada version properly at parse time to recognize the appropriate 333 -- Ada version syntax. However, it is only the zero argument form that 334 -- must be processed at parse time. 335 336 when Pragma_Ada_05 | Pragma_Ada_2005 => 337 if Arg_Count = 0 then 338 Ada_Version := Ada_2005; 339 Ada_Version_Explicit := Ada_2005; 340 end if; 341 342 --------------------- 343 -- Ada_12/Ada_2012 -- 344 --------------------- 345 346 -- These pragmas must be processed at parse time, since we want to set 347 -- the Ada version properly at parse time to recognize the appropriate 348 -- Ada version syntax. However, it is only the zero argument form that 349 -- must be processed at parse time. 350 351 when Pragma_Ada_12 | Pragma_Ada_2012 => 352 if Arg_Count = 0 then 353 Ada_Version := Ada_2012; 354 Ada_Version_Explicit := Ada_2012; 355 end if; 356 357 ----------- 358 -- Debug -- 359 ----------- 360 361 -- pragma Debug ([boolean_EXPRESSION,] PROCEDURE_CALL_STATEMENT); 362 363 when Pragma_Debug => 364 Check_No_Identifier (Arg1); 365 366 if Arg_Count = 2 then 367 Check_No_Identifier (Arg2); 368 else 369 Check_Arg_Count (1); 370 end if; 371 372 ------------------------------- 373 -- Extensions_Allowed (GNAT) -- 374 ------------------------------- 375 376 -- pragma Extensions_Allowed (Off | On) 377 378 -- The processing for pragma Extensions_Allowed must be done at 379 -- parse time, since extensions mode may affect what is accepted. 380 381 when Pragma_Extensions_Allowed => 382 Check_Arg_Count (1); 383 Check_No_Identifier (Arg1); 384 Check_Arg_Is_On_Or_Off (Arg1); 385 386 if Chars (Expression (Arg1)) = Name_On then 387 Extensions_Allowed := True; 388 Ada_Version := Ada_2012; 389 else 390 Extensions_Allowed := False; 391 Ada_Version := Ada_Version_Explicit; 392 end if; 393 394 ---------------- 395 -- List (2.8) -- 396 ---------------- 397 398 -- pragma List (Off | On) 399 400 -- The processing for pragma List must be done at parse time, 401 -- since a listing can be generated in parse only mode. 402 403 when Pragma_List => 404 Check_Arg_Count (1); 405 Check_No_Identifier (Arg1); 406 Check_Arg_Is_On_Or_Off (Arg1); 407 408 -- We unconditionally make a List_On entry for the pragma, so that 409 -- in the List (Off) case, the pragma will print even in a region 410 -- of code with listing turned off (this is required!) 411 412 List_Pragmas.Increment_Last; 413 List_Pragmas.Table (List_Pragmas.Last) := 414 (Ptyp => List_On, Ploc => Sloc (Pragma_Node)); 415 416 -- Now generate the list off entry for pragma List (Off) 417 418 if Chars (Expression (Arg1)) = Name_Off then 419 List_Pragmas.Increment_Last; 420 List_Pragmas.Table (List_Pragmas.Last) := 421 (Ptyp => List_Off, Ploc => Semi); 422 end if; 423 424 ---------------- 425 -- Page (2.8) -- 426 ---------------- 427 428 -- pragma Page; 429 430 -- Processing for this pragma must be done at parse time, since a 431 -- listing can be generated in parse only mode with semantics off. 432 433 when Pragma_Page => 434 Check_Arg_Count (0); 435 List_Pragmas.Increment_Last; 436 List_Pragmas.Table (List_Pragmas.Last) := (Page, Semi); 437 438 ------------------ 439 -- Restrictions -- 440 ------------------ 441 442 -- pragma Restrictions (RESTRICTION {, RESTRICTION}); 443 444 -- RESTRICTION ::= 445 -- restriction_IDENTIFIER 446 -- | restriction_parameter_IDENTIFIER => EXPRESSION 447 448 -- We process the case of No_Obsolescent_Features, since this has 449 -- a syntactic effect that we need to detect at parse time (the use 450 -- of replacement characters such as colon for pound sign). 451 452 when Pragma_Restrictions => 453 Process_Restrictions_Or_Restriction_Warnings; 454 455 -------------------------- 456 -- Restriction_Warnings -- 457 -------------------------- 458 459 -- pragma Restriction_Warnings (RESTRICTION {, RESTRICTION}); 460 461 -- RESTRICTION ::= 462 -- restriction_IDENTIFIER 463 -- | restriction_parameter_IDENTIFIER => EXPRESSION 464 465 -- See above comment for pragma Restrictions 466 467 when Pragma_Restriction_Warnings => 468 Process_Restrictions_Or_Restriction_Warnings; 469 470 ---------------------------------------------------------- 471 -- Source_File_Name and Source_File_Name_Project (GNAT) -- 472 ---------------------------------------------------------- 473 474 -- These two pragmas have the same syntax and semantics. 475 -- There are five forms of these pragmas: 476 477 -- pragma Source_File_Name[_Project] ( 478 -- [UNIT_NAME =>] unit_NAME, 479 -- BODY_FILE_NAME => STRING_LITERAL 480 -- [, [INDEX =>] INTEGER_LITERAL]); 481 482 -- pragma Source_File_Name[_Project] ( 483 -- [UNIT_NAME =>] unit_NAME, 484 -- SPEC_FILE_NAME => STRING_LITERAL 485 -- [, [INDEX =>] INTEGER_LITERAL]); 486 487 -- pragma Source_File_Name[_Project] ( 488 -- BODY_FILE_NAME => STRING_LITERAL 489 -- [, DOT_REPLACEMENT => STRING_LITERAL] 490 -- [, CASING => CASING_SPEC]); 491 492 -- pragma Source_File_Name[_Project] ( 493 -- SPEC_FILE_NAME => STRING_LITERAL 494 -- [, DOT_REPLACEMENT => STRING_LITERAL] 495 -- [, CASING => CASING_SPEC]); 496 497 -- pragma Source_File_Name[_Project] ( 498 -- SUBUNIT_FILE_NAME => STRING_LITERAL 499 -- [, DOT_REPLACEMENT => STRING_LITERAL] 500 -- [, CASING => CASING_SPEC]); 501 502 -- CASING_SPEC ::= Uppercase | Lowercase | Mixedcase 503 504 -- Pragma Source_File_Name_Project (SFNP) is equivalent to pragma 505 -- Source_File_Name (SFN), however their usage is exclusive: 506 -- SFN can only be used when no project file is used, while 507 -- SFNP can only be used when a project file is used. 508 509 -- The Project Manager produces a configuration pragmas file that 510 -- is communicated to the compiler with -gnatec switch. This file 511 -- contains only SFNP pragmas (at least two for the default naming 512 -- scheme. As this configuration pragmas file is always the first 513 -- processed by the compiler, it prevents the use of pragmas SFN in 514 -- other config files when a project file is in use. 515 516 -- Note: we process this during parsing, since we need to have the 517 -- source file names set well before the semantic analysis starts, 518 -- since we load the spec and with'ed packages before analysis. 519 520 when Pragma_Source_File_Name | Pragma_Source_File_Name_Project => 521 Source_File_Name : declare 522 Unam : Unit_Name_Type; 523 Expr1 : Node_Id; 524 Pat : String_Ptr; 525 Typ : Character; 526 Dot : String_Ptr; 527 Cas : Casing_Type; 528 Nast : Nat; 529 Expr : Node_Id; 530 Index : Nat; 531 532 function Get_Fname (Arg : Node_Id) return File_Name_Type; 533 -- Process file name from unit name form of pragma 534 535 function Get_String_Argument (Arg : Node_Id) return String_Ptr; 536 -- Process string literal value from argument 537 538 procedure Process_Casing (Arg : Node_Id); 539 -- Process Casing argument of pattern form of pragma 540 541 procedure Process_Dot_Replacement (Arg : Node_Id); 542 -- Process Dot_Replacement argument of pattern form of pragma 543 544 --------------- 545 -- Get_Fname -- 546 --------------- 547 548 function Get_Fname (Arg : Node_Id) return File_Name_Type is 549 begin 550 String_To_Name_Buffer (Strval (Expression (Arg))); 551 552 for J in 1 .. Name_Len loop 553 if Is_Directory_Separator (Name_Buffer (J)) then 554 Error_Msg 555 ("directory separator character not allowed", 556 Sloc (Expression (Arg)) + Source_Ptr (J)); 557 end if; 558 end loop; 559 560 return Name_Find; 561 end Get_Fname; 562 563 ------------------------- 564 -- Get_String_Argument -- 565 ------------------------- 566 567 function Get_String_Argument (Arg : Node_Id) return String_Ptr is 568 Str : String_Id; 569 570 begin 571 if Nkind (Expression (Arg)) /= N_String_Literal 572 and then 573 Nkind (Expression (Arg)) /= N_Operator_Symbol 574 then 575 Error_Msg_N 576 ("argument for pragma% must be string literal", Arg); 577 raise Error_Resync; 578 end if; 579 580 Str := Strval (Expression (Arg)); 581 582 -- Check string has no wide chars 583 584 for J in 1 .. String_Length (Str) loop 585 if Get_String_Char (Str, J) > 255 then 586 Error_Msg 587 ("wide character not allowed in pattern for pragma%", 588 Sloc (Expression (Arg2)) + Text_Ptr (J) - 1); 589 end if; 590 end loop; 591 592 -- Acquire string 593 594 String_To_Name_Buffer (Str); 595 return new String'(Name_Buffer (1 .. Name_Len)); 596 end Get_String_Argument; 597 598 -------------------- 599 -- Process_Casing -- 600 -------------------- 601 602 procedure Process_Casing (Arg : Node_Id) is 603 Expr : constant Node_Id := Expression (Arg); 604 605 begin 606 Check_Required_Identifier (Arg, Name_Casing); 607 608 if Nkind (Expr) = N_Identifier then 609 if Chars (Expr) = Name_Lowercase then 610 Cas := All_Lower_Case; 611 return; 612 elsif Chars (Expr) = Name_Uppercase then 613 Cas := All_Upper_Case; 614 return; 615 elsif Chars (Expr) = Name_Mixedcase then 616 Cas := Mixed_Case; 617 return; 618 end if; 619 end if; 620 621 Error_Msg_N 622 ("Casing argument for pragma% must be " & 623 "one of Mixedcase, Lowercase, Uppercase", 624 Arg); 625 end Process_Casing; 626 627 ----------------------------- 628 -- Process_Dot_Replacement -- 629 ----------------------------- 630 631 procedure Process_Dot_Replacement (Arg : Node_Id) is 632 begin 633 Check_Required_Identifier (Arg, Name_Dot_Replacement); 634 Dot := Get_String_Argument (Arg); 635 end Process_Dot_Replacement; 636 637 -- Start of processing for Source_File_Name and 638 -- Source_File_Name_Project pragmas. 639 640 begin 641 if Prag_Id = Pragma_Source_File_Name then 642 if Project_File_In_Use = In_Use then 643 Error_Msg 644 ("pragma Source_File_Name cannot be used " & 645 "with a project file", Pragma_Sloc); 646 647 else 648 Project_File_In_Use := Not_In_Use; 649 end if; 650 651 else 652 if Project_File_In_Use = Not_In_Use then 653 Error_Msg 654 ("pragma Source_File_Name_Project should only be used " & 655 "with a project file", Pragma_Sloc); 656 else 657 Project_File_In_Use := In_Use; 658 end if; 659 end if; 660 661 -- We permit from 1 to 3 arguments 662 663 if Arg_Count not in 1 .. 3 then 664 Check_Arg_Count (1); 665 end if; 666 667 Expr1 := Expression (Arg1); 668 669 -- If first argument is identifier or selected component, then 670 -- we have the specific file case of the Source_File_Name pragma, 671 -- and the first argument is a unit name. 672 673 if Nkind (Expr1) = N_Identifier 674 or else 675 (Nkind (Expr1) = N_Selected_Component 676 and then 677 Nkind (Selector_Name (Expr1)) = N_Identifier) 678 then 679 if Nkind (Expr1) = N_Identifier 680 and then Chars (Expr1) = Name_System 681 then 682 Error_Msg_N 683 ("pragma Source_File_Name may not be used for System", 684 Arg1); 685 return Error; 686 end if; 687 688 -- Process index argument if present 689 690 if Arg_Count = 3 then 691 Expr := Expression (Arg3); 692 693 if Nkind (Expr) /= N_Integer_Literal 694 or else not UI_Is_In_Int_Range (Intval (Expr)) 695 or else Intval (Expr) > 999 696 or else Intval (Expr) <= 0 697 then 698 Error_Msg 699 ("pragma% index must be integer literal" & 700 " in range 1 .. 999", Sloc (Expr)); 701 raise Error_Resync; 702 else 703 Index := UI_To_Int (Intval (Expr)); 704 end if; 705 706 -- No index argument present 707 708 else 709 Check_Arg_Count (2); 710 Index := 0; 711 end if; 712 713 Check_Optional_Identifier (Arg1, Name_Unit_Name); 714 Unam := Get_Unit_Name (Expr1); 715 716 Check_Arg_Is_String_Literal (Arg2); 717 718 if Chars (Arg2) = Name_Spec_File_Name then 719 Set_File_Name 720 (Get_Spec_Name (Unam), Get_Fname (Arg2), Index); 721 722 elsif Chars (Arg2) = Name_Body_File_Name then 723 Set_File_Name 724 (Unam, Get_Fname (Arg2), Index); 725 726 else 727 Error_Msg_N 728 ("pragma% argument has incorrect identifier", Arg2); 729 return Pragma_Node; 730 end if; 731 732 -- If the first argument is not an identifier, then we must have 733 -- the pattern form of the pragma, and the first argument must be 734 -- the pattern string with an appropriate name. 735 736 else 737 if Chars (Arg1) = Name_Spec_File_Name then 738 Typ := 's'; 739 740 elsif Chars (Arg1) = Name_Body_File_Name then 741 Typ := 'b'; 742 743 elsif Chars (Arg1) = Name_Subunit_File_Name then 744 Typ := 'u'; 745 746 elsif Chars (Arg1) = Name_Unit_Name then 747 Error_Msg_N 748 ("Unit_Name parameter for pragma% must be an identifier", 749 Arg1); 750 raise Error_Resync; 751 752 else 753 Error_Msg_N 754 ("pragma% argument has incorrect identifier", Arg1); 755 raise Error_Resync; 756 end if; 757 758 Pat := Get_String_Argument (Arg1); 759 760 -- Check pattern has exactly one asterisk 761 762 Nast := 0; 763 for J in Pat'Range loop 764 if Pat (J) = '*' then 765 Nast := Nast + 1; 766 end if; 767 end loop; 768 769 if Nast /= 1 then 770 Error_Msg_N 771 ("file name pattern must have exactly one * character", 772 Arg1); 773 return Pragma_Node; 774 end if; 775 776 -- Set defaults for Casing and Dot_Separator parameters 777 778 Cas := All_Lower_Case; 779 Dot := new String'("."); 780 781 -- Process second and third arguments if present 782 783 if Arg_Count > 1 then 784 if Chars (Arg2) = Name_Casing then 785 Process_Casing (Arg2); 786 787 if Arg_Count = 3 then 788 Process_Dot_Replacement (Arg3); 789 end if; 790 791 else 792 Process_Dot_Replacement (Arg2); 793 794 if Arg_Count = 3 then 795 Process_Casing (Arg3); 796 end if; 797 end if; 798 end if; 799 800 Set_File_Name_Pattern (Pat, Typ, Dot, Cas); 801 end if; 802 end Source_File_Name; 803 804 ----------------------------- 805 -- Source_Reference (GNAT) -- 806 ----------------------------- 807 808 -- pragma Source_Reference 809 -- (INTEGER_LITERAL [, STRING_LITERAL] ); 810 811 -- Processing for this pragma must be done at parse time, since error 812 -- messages needing the proper line numbers can be generated in parse 813 -- only mode with semantic checking turned off, and indeed we usually 814 -- turn off semantic checking anyway if any parse errors are found. 815 816 when Pragma_Source_Reference => Source_Reference : declare 817 Fname : File_Name_Type; 818 819 begin 820 if Arg_Count /= 1 then 821 Check_Arg_Count (2); 822 Check_No_Identifier (Arg2); 823 end if; 824 825 -- Check that this is first line of file. We skip this test if 826 -- we are in syntax check only mode, since we may be dealing with 827 -- multiple compilation units. 828 829 if Get_Physical_Line_Number (Pragma_Sloc) /= 1 830 and then Num_SRef_Pragmas (Current_Source_File) = 0 831 and then Operating_Mode /= Check_Syntax 832 then 833 Error_Msg -- CODEFIX 834 ("first % pragma must be first line of file", Pragma_Sloc); 835 raise Error_Resync; 836 end if; 837 838 Check_No_Identifier (Arg1); 839 840 if Arg_Count = 1 then 841 if Num_SRef_Pragmas (Current_Source_File) = 0 then 842 Error_Msg 843 ("file name required for first % pragma in file", 844 Pragma_Sloc); 845 raise Error_Resync; 846 else 847 Fname := No_File; 848 end if; 849 850 -- File name present 851 852 else 853 Check_Arg_Is_String_Literal (Arg2); 854 String_To_Name_Buffer (Strval (Expression (Arg2))); 855 Fname := Name_Find; 856 857 if Num_SRef_Pragmas (Current_Source_File) > 0 then 858 if Fname /= Full_Ref_Name (Current_Source_File) then 859 Error_Msg 860 ("file name must be same in all % pragmas", Pragma_Sloc); 861 raise Error_Resync; 862 end if; 863 end if; 864 end if; 865 866 if Nkind (Expression (Arg1)) /= N_Integer_Literal then 867 Error_Msg 868 ("argument for pragma% must be integer literal", 869 Sloc (Expression (Arg1))); 870 raise Error_Resync; 871 872 -- OK, this source reference pragma is effective, however, we 873 -- ignore it if it is not in the first unit in the multiple unit 874 -- case. This is because the only purpose in this case is to 875 -- provide source pragmas for subsequent use by gnatchop. 876 877 else 878 if Num_Library_Units = 1 then 879 Register_Source_Ref_Pragma 880 (Fname, 881 Strip_Directory (Fname), 882 UI_To_Int (Intval (Expression (Arg1))), 883 Get_Physical_Line_Number (Pragma_Sloc) + 1); 884 end if; 885 end if; 886 end Source_Reference; 887 888 ------------------------- 889 -- Style_Checks (GNAT) -- 890 ------------------------- 891 892 -- pragma Style_Checks (On | Off | ALL_CHECKS | STRING_LITERAL); 893 894 -- This is processed by the parser since some of the style 895 -- checks take place during source scanning and parsing. 896 897 when Pragma_Style_Checks => Style_Checks : declare 898 A : Node_Id; 899 S : String_Id; 900 C : Char_Code; 901 OK : Boolean := True; 902 903 begin 904 -- Two argument case is only for semantics 905 906 if Arg_Count = 2 then 907 null; 908 909 else 910 Check_Arg_Count (1); 911 Check_No_Identifier (Arg1); 912 A := Expression (Arg1); 913 914 if Nkind (A) = N_String_Literal then 915 S := Strval (A); 916 917 declare 918 Slen : constant Natural := Natural (String_Length (S)); 919 Options : String (1 .. Slen); 920 J : Natural; 921 Ptr : Natural; 922 923 begin 924 J := 1; 925 loop 926 C := Get_String_Char (S, Int (J)); 927 928 if not In_Character_Range (C) then 929 OK := False; 930 Ptr := J; 931 exit; 932 933 else 934 Options (J) := Get_Character (C); 935 end if; 936 937 if J = Slen then 938 if not Ignore_Style_Checks_Pragmas then 939 Set_Style_Check_Options (Options, OK, Ptr); 940 end if; 941 942 exit; 943 944 else 945 J := J + 1; 946 end if; 947 end loop; 948 949 if not OK then 950 Error_Msg 951 (Style_Msg_Buf (1 .. Style_Msg_Len), 952 Sloc (Expression (Arg1)) + Source_Ptr (Ptr)); 953 raise Error_Resync; 954 end if; 955 end; 956 957 elsif Nkind (A) /= N_Identifier then 958 OK := False; 959 960 elsif Chars (A) = Name_All_Checks then 961 if not Ignore_Style_Checks_Pragmas then 962 if GNAT_Mode then 963 Stylesw.Set_GNAT_Style_Check_Options; 964 else 965 Stylesw.Set_Default_Style_Check_Options; 966 end if; 967 end if; 968 969 elsif Chars (A) = Name_On then 970 if not Ignore_Style_Checks_Pragmas then 971 Style_Check := True; 972 end if; 973 974 elsif Chars (A) = Name_Off then 975 if not Ignore_Style_Checks_Pragmas then 976 Style_Check := False; 977 end if; 978 979 else 980 OK := False; 981 end if; 982 983 if not OK then 984 Error_Msg ("incorrect argument for pragma%", Sloc (A)); 985 raise Error_Resync; 986 end if; 987 end if; 988 end Style_Checks; 989 990 ------------------------- 991 -- Suppress_All (GNAT) -- 992 ------------------------- 993 994 -- pragma Suppress_All 995 996 -- This is a rather odd pragma, because other compilers allow it in 997 -- strange places. DEC allows it at the end of units, and Rational 998 -- allows it as a program unit pragma, when it would be more natural 999 -- if it were a configuration pragma. 1000 1001 -- Since the reason we provide this pragma is for compatibility with 1002 -- these other compilers, we want to accommodate these strange placement 1003 -- rules, and the easiest thing is simply to allow it anywhere in a 1004 -- unit. If this pragma appears anywhere within a unit, then the effect 1005 -- is as though a pragma Suppress (All_Checks) had appeared as the first 1006 -- line of the current file, i.e. as the first configuration pragma in 1007 -- the current unit. 1008 1009 -- To get this effect, we set the flag Has_Pragma_Suppress_All in the 1010 -- compilation unit node for the current source file then in the last 1011 -- stage of parsing a file, if this flag is set, we materialize the 1012 -- Suppress (All_Checks) pragma, marked as not coming from Source. 1013 1014 when Pragma_Suppress_All => 1015 Set_Has_Pragma_Suppress_All (Cunit (Current_Source_Unit)); 1016 1017 --------------------- 1018 -- Warnings (GNAT) -- 1019 --------------------- 1020 1021 -- pragma Warnings (On | Off); 1022 -- pragma Warnings (On | Off, LOCAL_NAME); 1023 -- pragma Warnings (static_string_EXPRESSION); 1024 -- pragma Warnings (On | Off, static_string_EXPRESSION); 1025 1026 -- The one argument ON/OFF case is processed by the parser, since it may 1027 -- control parser warnings as well as semantic warnings, and in any case 1028 -- we want to be absolutely sure that the range in the warnings table is 1029 -- set well before any semantic analysis is performed. Note that we 1030 -- ignore this pragma if debug flag -gnatd.i is set. 1031 1032 when Pragma_Warnings => 1033 if Arg_Count = 1 and then not Debug_Flag_Dot_I then 1034 Check_No_Identifier (Arg1); 1035 1036 declare 1037 Argx : constant Node_Id := Expression (Arg1); 1038 begin 1039 if Nkind (Argx) = N_Identifier then 1040 if Chars (Argx) = Name_On then 1041 Set_Warnings_Mode_On (Pragma_Sloc); 1042 elsif Chars (Argx) = Name_Off then 1043 Set_Warnings_Mode_Off (Pragma_Sloc); 1044 end if; 1045 end if; 1046 end; 1047 end if; 1048 1049 ----------------------------- 1050 -- Wide_Character_Encoding -- 1051 ----------------------------- 1052 1053 -- pragma Wide_Character_Encoding (IDENTIFIER | CHARACTER_LITERAL); 1054 1055 -- This is processed by the parser, since the scanner is affected 1056 1057 when Pragma_Wide_Character_Encoding => Wide_Character_Encoding : declare 1058 A : Node_Id; 1059 1060 begin 1061 Check_Arg_Count (1); 1062 Check_No_Identifier (Arg1); 1063 A := Expression (Arg1); 1064 1065 if Nkind (A) = N_Identifier then 1066 Get_Name_String (Chars (A)); 1067 Wide_Character_Encoding_Method := 1068 Get_WC_Encoding_Method (Name_Buffer (1 .. Name_Len)); 1069 1070 elsif Nkind (A) = N_Character_Literal then 1071 declare 1072 R : constant Char_Code := 1073 Char_Code (UI_To_Int (Char_Literal_Value (A))); 1074 begin 1075 if In_Character_Range (R) then 1076 Wide_Character_Encoding_Method := 1077 Get_WC_Encoding_Method (Get_Character (R)); 1078 else 1079 raise Constraint_Error; 1080 end if; 1081 end; 1082 1083 else 1084 raise Constraint_Error; 1085 end if; 1086 1087 Upper_Half_Encoding := 1088 Wide_Character_Encoding_Method in 1089 WC_Upper_Half_Encoding_Method; 1090 1091 exception 1092 when Constraint_Error => 1093 Error_Msg_N ("invalid argument for pragma%", Arg1); 1094 end Wide_Character_Encoding; 1095 1096 ----------------------- 1097 -- All Other Pragmas -- 1098 ----------------------- 1099 1100 -- For all other pragmas, checking and processing is handled 1101 -- entirely in Sem_Prag, and no further checking is done by Par. 1102 1103 when Pragma_Abort_Defer | 1104 Pragma_Abstract_State | 1105 Pragma_Assertion_Policy | 1106 Pragma_Assume | 1107 Pragma_Assume_No_Invalid_Values | 1108 Pragma_AST_Entry | 1109 Pragma_All_Calls_Remote | 1110 Pragma_Annotate | 1111 Pragma_Assert | 1112 Pragma_Assert_And_Cut | 1113 Pragma_Asynchronous | 1114 Pragma_Atomic | 1115 Pragma_Atomic_Components | 1116 Pragma_Attach_Handler | 1117 Pragma_Attribute_Definition | 1118 Pragma_Check | 1119 Pragma_Check_Float_Overflow | 1120 Pragma_Check_Name | 1121 Pragma_Check_Policy | 1122 Pragma_CIL_Constructor | 1123 Pragma_Compile_Time_Error | 1124 Pragma_Compile_Time_Warning | 1125 Pragma_Compiler_Unit | 1126 Pragma_Contract_Case | 1127 Pragma_Contract_Cases | 1128 Pragma_Convention_Identifier | 1129 Pragma_CPP_Class | 1130 Pragma_CPP_Constructor | 1131 Pragma_CPP_Virtual | 1132 Pragma_CPP_Vtable | 1133 Pragma_CPU | 1134 Pragma_C_Pass_By_Copy | 1135 Pragma_Comment | 1136 Pragma_Common_Object | 1137 Pragma_Complete_Representation | 1138 Pragma_Complex_Representation | 1139 Pragma_Component_Alignment | 1140 Pragma_Controlled | 1141 Pragma_Convention | 1142 Pragma_Debug_Policy | 1143 Pragma_Detect_Blocking | 1144 Pragma_Default_Storage_Pool | 1145 Pragma_Disable_Atomic_Synchronization | 1146 Pragma_Discard_Names | 1147 Pragma_Dispatching_Domain | 1148 Pragma_Eliminate | 1149 Pragma_Elaborate | 1150 Pragma_Elaborate_All | 1151 Pragma_Elaborate_Body | 1152 Pragma_Elaboration_Checks | 1153 Pragma_Enable_Atomic_Synchronization | 1154 Pragma_Export | 1155 Pragma_Export_Exception | 1156 Pragma_Export_Function | 1157 Pragma_Export_Object | 1158 Pragma_Export_Procedure | 1159 Pragma_Export_Value | 1160 Pragma_Export_Valued_Procedure | 1161 Pragma_Extend_System | 1162 Pragma_External | 1163 Pragma_External_Name_Casing | 1164 Pragma_Favor_Top_Level | 1165 Pragma_Fast_Math | 1166 Pragma_Finalize_Storage_Only | 1167 Pragma_Float_Representation | 1168 Pragma_Global | 1169 Pragma_Ident | 1170 Pragma_Implementation_Defined | 1171 Pragma_Implemented | 1172 Pragma_Implicit_Packing | 1173 Pragma_Import | 1174 Pragma_Import_Exception | 1175 Pragma_Import_Function | 1176 Pragma_Import_Object | 1177 Pragma_Import_Procedure | 1178 Pragma_Import_Valued_Procedure | 1179 Pragma_Independent | 1180 Pragma_Independent_Components | 1181 Pragma_Initialize_Scalars | 1182 Pragma_Inline | 1183 Pragma_Inline_Always | 1184 Pragma_Inline_Generic | 1185 Pragma_Inspection_Point | 1186 Pragma_Interface | 1187 Pragma_Interface_Name | 1188 Pragma_Interrupt_Handler | 1189 Pragma_Interrupt_State | 1190 Pragma_Interrupt_Priority | 1191 Pragma_Invariant | 1192 Pragma_Java_Constructor | 1193 Pragma_Java_Interface | 1194 Pragma_Keep_Names | 1195 Pragma_License | 1196 Pragma_Link_With | 1197 Pragma_Linker_Alias | 1198 Pragma_Linker_Constructor | 1199 Pragma_Linker_Destructor | 1200 Pragma_Linker_Options | 1201 Pragma_Linker_Section | 1202 Pragma_Lock_Free | 1203 Pragma_Locking_Policy | 1204 Pragma_Long_Float | 1205 Pragma_Loop_Invariant | 1206 Pragma_Loop_Optimize | 1207 Pragma_Loop_Variant | 1208 Pragma_Machine_Attribute | 1209 Pragma_Main | 1210 Pragma_Main_Storage | 1211 Pragma_Memory_Size | 1212 Pragma_No_Body | 1213 Pragma_No_Inline | 1214 Pragma_No_Return | 1215 Pragma_No_Run_Time | 1216 Pragma_No_Strict_Aliasing | 1217 Pragma_Normalize_Scalars | 1218 Pragma_Obsolescent | 1219 Pragma_Ordered | 1220 Pragma_Optimize | 1221 Pragma_Optimize_Alignment | 1222 Pragma_Overflow_Mode | 1223 Pragma_Overriding_Renamings | 1224 Pragma_Pack | 1225 Pragma_Partition_Elaboration_Policy | 1226 Pragma_Passive | 1227 Pragma_Preelaborable_Initialization | 1228 Pragma_Polling | 1229 Pragma_Persistent_BSS | 1230 Pragma_Postcondition | 1231 Pragma_Precondition | 1232 Pragma_Predicate | 1233 Pragma_Preelaborate | 1234 Pragma_Preelaborate_05 | 1235 Pragma_Priority | 1236 Pragma_Priority_Specific_Dispatching | 1237 Pragma_Profile | 1238 Pragma_Profile_Warnings | 1239 Pragma_Propagate_Exceptions | 1240 Pragma_Psect_Object | 1241 Pragma_Pure | 1242 Pragma_Pure_05 | 1243 Pragma_Pure_12 | 1244 Pragma_Pure_Function | 1245 Pragma_Queuing_Policy | 1246 Pragma_Relative_Deadline | 1247 Pragma_Remote_Access_Type | 1248 Pragma_Remote_Call_Interface | 1249 Pragma_Remote_Types | 1250 Pragma_Restricted_Run_Time | 1251 Pragma_Rational | 1252 Pragma_Ravenscar | 1253 Pragma_Reviewable | 1254 Pragma_Share_Generic | 1255 Pragma_Shared | 1256 Pragma_Shared_Passive | 1257 Pragma_Short_Circuit_And_Or | 1258 Pragma_Short_Descriptors | 1259 Pragma_Simple_Storage_Pool_Type | 1260 Pragma_Storage_Size | 1261 Pragma_Storage_Unit | 1262 Pragma_Static_Elaboration_Desired | 1263 Pragma_Stream_Convert | 1264 Pragma_Subtitle | 1265 Pragma_Suppress | 1266 Pragma_Suppress_Debug_Info | 1267 Pragma_Suppress_Exception_Locations | 1268 Pragma_Suppress_Initialization | 1269 Pragma_System_Name | 1270 Pragma_Task_Dispatching_Policy | 1271 Pragma_Task_Info | 1272 Pragma_Task_Name | 1273 Pragma_Task_Storage | 1274 Pragma_Test_Case | 1275 Pragma_Thread_Local_Storage | 1276 Pragma_Time_Slice | 1277 Pragma_Title | 1278 Pragma_Unchecked_Union | 1279 Pragma_Unimplemented_Unit | 1280 Pragma_Universal_Aliasing | 1281 Pragma_Universal_Data | 1282 Pragma_Unmodified | 1283 Pragma_Unreferenced | 1284 Pragma_Unreferenced_Objects | 1285 Pragma_Unreserve_All_Interrupts | 1286 Pragma_Unsuppress | 1287 Pragma_Use_VADS_Size | 1288 Pragma_Volatile | 1289 Pragma_Volatile_Components | 1290 Pragma_Weak_External | 1291 Pragma_Validity_Checks => 1292 null; 1293 1294 -------------------- 1295 -- Unknown_Pragma -- 1296 -------------------- 1297 1298 -- Should be impossible, since we excluded this case earlier on 1299 1300 when Unknown_Pragma => 1301 raise Program_Error; 1302 1303 end case; 1304 1305 return Pragma_Node; 1306 1307 -------------------- 1308 -- Error Handling -- 1309 -------------------- 1310 1311exception 1312 when Error_Resync => 1313 return Error; 1314 1315end Prag; 1316