1 //===--- Pragma.cpp - Pragma registration and handling --------------------===// 2 // 3 // The LLVM Compiler Infrastructure 4 // 5 // This file is distributed under the University of Illinois Open Source 6 // License. See LICENSE.TXT for details. 7 // 8 //===----------------------------------------------------------------------===// 9 // 10 // This file implements the PragmaHandler/PragmaTable interfaces and implements 11 // pragma related methods of the Preprocessor class. 12 // 13 //===----------------------------------------------------------------------===// 14 15 #include "clang/Lex/Pragma.h" 16 #include "clang/Basic/FileManager.h" 17 #include "clang/Basic/SourceManager.h" 18 #include "clang/Lex/HeaderSearch.h" 19 #include "clang/Lex/LexDiagnostic.h" 20 #include "clang/Lex/LiteralSupport.h" 21 #include "clang/Lex/MacroInfo.h" 22 #include "clang/Lex/Preprocessor.h" 23 #include "llvm/ADT/STLExtras.h" 24 #include "llvm/ADT/StringSwitch.h" 25 #include "llvm/ADT/StringExtras.h" 26 #include "llvm/Support/CrashRecoveryContext.h" 27 #include "llvm/Support/ErrorHandling.h" 28 #include <algorithm> 29 using namespace clang; 30 31 #include "llvm/Support/raw_ostream.h" 32 33 // Out-of-line destructor to provide a home for the class. 34 PragmaHandler::~PragmaHandler() { 35 } 36 37 //===----------------------------------------------------------------------===// 38 // EmptyPragmaHandler Implementation. 39 //===----------------------------------------------------------------------===// 40 41 EmptyPragmaHandler::EmptyPragmaHandler() {} 42 43 void EmptyPragmaHandler::HandlePragma(Preprocessor &PP, 44 PragmaIntroducerKind Introducer, 45 Token &FirstToken) {} 46 47 //===----------------------------------------------------------------------===// 48 // PragmaNamespace Implementation. 49 //===----------------------------------------------------------------------===// 50 51 PragmaNamespace::~PragmaNamespace() { 52 llvm::DeleteContainerSeconds(Handlers); 53 } 54 55 /// FindHandler - Check to see if there is already a handler for the 56 /// specified name. If not, return the handler for the null identifier if it 57 /// exists, otherwise return null. If IgnoreNull is true (the default) then 58 /// the null handler isn't returned on failure to match. 59 PragmaHandler *PragmaNamespace::FindHandler(StringRef Name, 60 bool IgnoreNull) const { 61 if (PragmaHandler *Handler = Handlers.lookup(Name)) 62 return Handler; 63 return IgnoreNull ? nullptr : Handlers.lookup(StringRef()); 64 } 65 66 void PragmaNamespace::AddPragma(PragmaHandler *Handler) { 67 assert(!Handlers.lookup(Handler->getName()) && 68 "A handler with this name is already registered in this namespace"); 69 Handlers[Handler->getName()] = Handler; 70 } 71 72 void PragmaNamespace::RemovePragmaHandler(PragmaHandler *Handler) { 73 assert(Handlers.lookup(Handler->getName()) && 74 "Handler not registered in this namespace"); 75 Handlers.erase(Handler->getName()); 76 } 77 78 void PragmaNamespace::HandlePragma(Preprocessor &PP, 79 PragmaIntroducerKind Introducer, 80 Token &Tok) { 81 // Read the 'namespace' that the directive is in, e.g. STDC. Do not macro 82 // expand it, the user can have a STDC #define, that should not affect this. 83 PP.LexUnexpandedToken(Tok); 84 85 // Get the handler for this token. If there is no handler, ignore the pragma. 86 PragmaHandler *Handler 87 = FindHandler(Tok.getIdentifierInfo() ? Tok.getIdentifierInfo()->getName() 88 : StringRef(), 89 /*IgnoreNull=*/false); 90 if (!Handler) { 91 PP.Diag(Tok, diag::warn_pragma_ignored); 92 return; 93 } 94 95 // Otherwise, pass it down. 96 Handler->HandlePragma(PP, Introducer, Tok); 97 } 98 99 //===----------------------------------------------------------------------===// 100 // Preprocessor Pragma Directive Handling. 101 //===----------------------------------------------------------------------===// 102 103 /// HandlePragmaDirective - The "\#pragma" directive has been parsed. Lex the 104 /// rest of the pragma, passing it to the registered pragma handlers. 105 void Preprocessor::HandlePragmaDirective(SourceLocation IntroducerLoc, 106 PragmaIntroducerKind Introducer) { 107 if (Callbacks) 108 Callbacks->PragmaDirective(IntroducerLoc, Introducer); 109 110 if (!PragmasEnabled) 111 return; 112 113 ++NumPragma; 114 115 // Invoke the first level of pragma handlers which reads the namespace id. 116 Token Tok; 117 PragmaHandlers->HandlePragma(*this, Introducer, Tok); 118 119 // If the pragma handler didn't read the rest of the line, consume it now. 120 if ((CurTokenLexer && CurTokenLexer->isParsingPreprocessorDirective()) 121 || (CurPPLexer && CurPPLexer->ParsingPreprocessorDirective)) 122 DiscardUntilEndOfDirective(); 123 } 124 125 namespace { 126 /// \brief Helper class for \see Preprocessor::Handle_Pragma. 127 class LexingFor_PragmaRAII { 128 Preprocessor &PP; 129 bool InMacroArgPreExpansion; 130 bool Failed; 131 Token &OutTok; 132 Token PragmaTok; 133 134 public: 135 LexingFor_PragmaRAII(Preprocessor &PP, bool InMacroArgPreExpansion, 136 Token &Tok) 137 : PP(PP), InMacroArgPreExpansion(InMacroArgPreExpansion), 138 Failed(false), OutTok(Tok) { 139 if (InMacroArgPreExpansion) { 140 PragmaTok = OutTok; 141 PP.EnableBacktrackAtThisPos(); 142 } 143 } 144 145 ~LexingFor_PragmaRAII() { 146 if (InMacroArgPreExpansion) { 147 if (Failed) { 148 PP.CommitBacktrackedTokens(); 149 } else { 150 PP.Backtrack(); 151 OutTok = PragmaTok; 152 } 153 } 154 } 155 156 void failed() { 157 Failed = true; 158 } 159 }; 160 } 161 162 /// Handle_Pragma - Read a _Pragma directive, slice it up, process it, then 163 /// return the first token after the directive. The _Pragma token has just 164 /// been read into 'Tok'. 165 void Preprocessor::Handle_Pragma(Token &Tok) { 166 167 // This works differently if we are pre-expanding a macro argument. 168 // In that case we don't actually "activate" the pragma now, we only lex it 169 // until we are sure it is lexically correct and then we backtrack so that 170 // we activate the pragma whenever we encounter the tokens again in the token 171 // stream. This ensures that we will activate it in the correct location 172 // or that we will ignore it if it never enters the token stream, e.g: 173 // 174 // #define EMPTY(x) 175 // #define INACTIVE(x) EMPTY(x) 176 // INACTIVE(_Pragma("clang diagnostic ignored \"-Wconversion\"")) 177 178 LexingFor_PragmaRAII _PragmaLexing(*this, InMacroArgPreExpansion, Tok); 179 180 // Remember the pragma token location. 181 SourceLocation PragmaLoc = Tok.getLocation(); 182 183 // Read the '('. 184 Lex(Tok); 185 if (Tok.isNot(tok::l_paren)) { 186 Diag(PragmaLoc, diag::err__Pragma_malformed); 187 return _PragmaLexing.failed(); 188 } 189 190 // Read the '"..."'. 191 Lex(Tok); 192 if (!tok::isStringLiteral(Tok.getKind())) { 193 Diag(PragmaLoc, diag::err__Pragma_malformed); 194 // Skip this token, and the ')', if present. 195 if (Tok.isNot(tok::r_paren) && Tok.isNot(tok::eof)) 196 Lex(Tok); 197 if (Tok.is(tok::r_paren)) 198 Lex(Tok); 199 return _PragmaLexing.failed(); 200 } 201 202 if (Tok.hasUDSuffix()) { 203 Diag(Tok, diag::err_invalid_string_udl); 204 // Skip this token, and the ')', if present. 205 Lex(Tok); 206 if (Tok.is(tok::r_paren)) 207 Lex(Tok); 208 return _PragmaLexing.failed(); 209 } 210 211 // Remember the string. 212 Token StrTok = Tok; 213 214 // Read the ')'. 215 Lex(Tok); 216 if (Tok.isNot(tok::r_paren)) { 217 Diag(PragmaLoc, diag::err__Pragma_malformed); 218 return _PragmaLexing.failed(); 219 } 220 221 if (InMacroArgPreExpansion) 222 return; 223 224 SourceLocation RParenLoc = Tok.getLocation(); 225 std::string StrVal = getSpelling(StrTok); 226 227 // The _Pragma is lexically sound. Destringize according to C11 6.10.9.1: 228 // "The string literal is destringized by deleting any encoding prefix, 229 // deleting the leading and trailing double-quotes, replacing each escape 230 // sequence \" by a double-quote, and replacing each escape sequence \\ by a 231 // single backslash." 232 if (StrVal[0] == 'L' || StrVal[0] == 'U' || 233 (StrVal[0] == 'u' && StrVal[1] != '8')) 234 StrVal.erase(StrVal.begin()); 235 else if (StrVal[0] == 'u') 236 StrVal.erase(StrVal.begin(), StrVal.begin() + 2); 237 238 if (StrVal[0] == 'R') { 239 // FIXME: C++11 does not specify how to handle raw-string-literals here. 240 // We strip off the 'R', the quotes, the d-char-sequences, and the parens. 241 assert(StrVal[1] == '"' && StrVal[StrVal.size() - 1] == '"' && 242 "Invalid raw string token!"); 243 244 // Measure the length of the d-char-sequence. 245 unsigned NumDChars = 0; 246 while (StrVal[2 + NumDChars] != '(') { 247 assert(NumDChars < (StrVal.size() - 5) / 2 && 248 "Invalid raw string token!"); 249 ++NumDChars; 250 } 251 assert(StrVal[StrVal.size() - 2 - NumDChars] == ')'); 252 253 // Remove 'R " d-char-sequence' and 'd-char-sequence "'. We'll replace the 254 // parens below. 255 StrVal.erase(0, 2 + NumDChars); 256 StrVal.erase(StrVal.size() - 1 - NumDChars); 257 } else { 258 assert(StrVal[0] == '"' && StrVal[StrVal.size()-1] == '"' && 259 "Invalid string token!"); 260 261 // Remove escaped quotes and escapes. 262 unsigned ResultPos = 1; 263 for (unsigned i = 1, e = StrVal.size() - 1; i != e; ++i) { 264 // Skip escapes. \\ -> '\' and \" -> '"'. 265 if (StrVal[i] == '\\' && i + 1 < e && 266 (StrVal[i + 1] == '\\' || StrVal[i + 1] == '"')) 267 ++i; 268 StrVal[ResultPos++] = StrVal[i]; 269 } 270 StrVal.erase(StrVal.begin() + ResultPos, StrVal.end() - 1); 271 } 272 273 // Remove the front quote, replacing it with a space, so that the pragma 274 // contents appear to have a space before them. 275 StrVal[0] = ' '; 276 277 // Replace the terminating quote with a \n. 278 StrVal[StrVal.size()-1] = '\n'; 279 280 // Plop the string (including the newline and trailing null) into a buffer 281 // where we can lex it. 282 Token TmpTok; 283 TmpTok.startToken(); 284 CreateString(StrVal, TmpTok); 285 SourceLocation TokLoc = TmpTok.getLocation(); 286 287 // Make and enter a lexer object so that we lex and expand the tokens just 288 // like any others. 289 Lexer *TL = Lexer::Create_PragmaLexer(TokLoc, PragmaLoc, RParenLoc, 290 StrVal.size(), *this); 291 292 EnterSourceFileWithLexer(TL, nullptr); 293 294 // With everything set up, lex this as a #pragma directive. 295 HandlePragmaDirective(PragmaLoc, PIK__Pragma); 296 297 // Finally, return whatever came after the pragma directive. 298 return Lex(Tok); 299 } 300 301 /// HandleMicrosoft__pragma - Like Handle_Pragma except the pragma text 302 /// is not enclosed within a string literal. 303 void Preprocessor::HandleMicrosoft__pragma(Token &Tok) { 304 // Remember the pragma token location. 305 SourceLocation PragmaLoc = Tok.getLocation(); 306 307 // Read the '('. 308 Lex(Tok); 309 if (Tok.isNot(tok::l_paren)) { 310 Diag(PragmaLoc, diag::err__Pragma_malformed); 311 return; 312 } 313 314 // Get the tokens enclosed within the __pragma(), as well as the final ')'. 315 SmallVector<Token, 32> PragmaToks; 316 int NumParens = 0; 317 Lex(Tok); 318 while (Tok.isNot(tok::eof)) { 319 PragmaToks.push_back(Tok); 320 if (Tok.is(tok::l_paren)) 321 NumParens++; 322 else if (Tok.is(tok::r_paren) && NumParens-- == 0) 323 break; 324 Lex(Tok); 325 } 326 327 if (Tok.is(tok::eof)) { 328 Diag(PragmaLoc, diag::err_unterminated___pragma); 329 return; 330 } 331 332 PragmaToks.front().setFlag(Token::LeadingSpace); 333 334 // Replace the ')' with an EOD to mark the end of the pragma. 335 PragmaToks.back().setKind(tok::eod); 336 337 Token *TokArray = new Token[PragmaToks.size()]; 338 std::copy(PragmaToks.begin(), PragmaToks.end(), TokArray); 339 340 // Push the tokens onto the stack. 341 EnterTokenStream(TokArray, PragmaToks.size(), true, true); 342 343 // With everything set up, lex this as a #pragma directive. 344 HandlePragmaDirective(PragmaLoc, PIK___pragma); 345 346 // Finally, return whatever came after the pragma directive. 347 return Lex(Tok); 348 } 349 350 /// HandlePragmaOnce - Handle \#pragma once. OnceTok is the 'once'. 351 /// 352 void Preprocessor::HandlePragmaOnce(Token &OnceTok) { 353 if (isInPrimaryFile()) { 354 Diag(OnceTok, diag::pp_pragma_once_in_main_file); 355 return; 356 } 357 358 // Get the current file lexer we're looking at. Ignore _Pragma 'files' etc. 359 // Mark the file as a once-only file now. 360 HeaderInfo.MarkFileIncludeOnce(getCurrentFileLexer()->getFileEntry()); 361 } 362 363 void Preprocessor::HandlePragmaMark() { 364 assert(CurPPLexer && "No current lexer?"); 365 if (CurLexer) 366 CurLexer->ReadToEndOfLine(); 367 else 368 CurPTHLexer->DiscardToEndOfLine(); 369 } 370 371 372 /// HandlePragmaPoison - Handle \#pragma GCC poison. PoisonTok is the 'poison'. 373 /// 374 void Preprocessor::HandlePragmaPoison(Token &PoisonTok) { 375 Token Tok; 376 377 while (1) { 378 // Read the next token to poison. While doing this, pretend that we are 379 // skipping while reading the identifier to poison. 380 // This avoids errors on code like: 381 // #pragma GCC poison X 382 // #pragma GCC poison X 383 if (CurPPLexer) CurPPLexer->LexingRawMode = true; 384 LexUnexpandedToken(Tok); 385 if (CurPPLexer) CurPPLexer->LexingRawMode = false; 386 387 // If we reached the end of line, we're done. 388 if (Tok.is(tok::eod)) return; 389 390 // Can only poison identifiers. 391 if (Tok.isNot(tok::raw_identifier)) { 392 Diag(Tok, diag::err_pp_invalid_poison); 393 return; 394 } 395 396 // Look up the identifier info for the token. We disabled identifier lookup 397 // by saying we're skipping contents, so we need to do this manually. 398 IdentifierInfo *II = LookUpIdentifierInfo(Tok); 399 400 // Already poisoned. 401 if (II->isPoisoned()) continue; 402 403 // If this is a macro identifier, emit a warning. 404 if (isMacroDefined(II)) 405 Diag(Tok, diag::pp_poisoning_existing_macro); 406 407 // Finally, poison it! 408 II->setIsPoisoned(); 409 if (II->isFromAST()) 410 II->setChangedSinceDeserialization(); 411 } 412 } 413 414 /// HandlePragmaSystemHeader - Implement \#pragma GCC system_header. We know 415 /// that the whole directive has been parsed. 416 void Preprocessor::HandlePragmaSystemHeader(Token &SysHeaderTok) { 417 if (isInPrimaryFile()) { 418 Diag(SysHeaderTok, diag::pp_pragma_sysheader_in_main_file); 419 return; 420 } 421 422 // Get the current file lexer we're looking at. Ignore _Pragma 'files' etc. 423 PreprocessorLexer *TheLexer = getCurrentFileLexer(); 424 425 // Mark the file as a system header. 426 HeaderInfo.MarkFileSystemHeader(TheLexer->getFileEntry()); 427 428 429 PresumedLoc PLoc = SourceMgr.getPresumedLoc(SysHeaderTok.getLocation()); 430 if (PLoc.isInvalid()) 431 return; 432 433 unsigned FilenameID = SourceMgr.getLineTableFilenameID(PLoc.getFilename()); 434 435 // Notify the client, if desired, that we are in a new source file. 436 if (Callbacks) 437 Callbacks->FileChanged(SysHeaderTok.getLocation(), 438 PPCallbacks::SystemHeaderPragma, SrcMgr::C_System); 439 440 // Emit a line marker. This will change any source locations from this point 441 // forward to realize they are in a system header. 442 // Create a line note with this information. 443 SourceMgr.AddLineNote(SysHeaderTok.getLocation(), PLoc.getLine()+1, 444 FilenameID, /*IsEntry=*/false, /*IsExit=*/false, 445 /*IsSystem=*/true, /*IsExternC=*/false); 446 } 447 448 /// HandlePragmaDependency - Handle \#pragma GCC dependency "foo" blah. 449 /// 450 void Preprocessor::HandlePragmaDependency(Token &DependencyTok) { 451 Token FilenameTok; 452 CurPPLexer->LexIncludeFilename(FilenameTok); 453 454 // If the token kind is EOD, the error has already been diagnosed. 455 if (FilenameTok.is(tok::eod)) 456 return; 457 458 // Reserve a buffer to get the spelling. 459 SmallString<128> FilenameBuffer; 460 bool Invalid = false; 461 StringRef Filename = getSpelling(FilenameTok, FilenameBuffer, &Invalid); 462 if (Invalid) 463 return; 464 465 bool isAngled = 466 GetIncludeFilenameSpelling(FilenameTok.getLocation(), Filename); 467 // If GetIncludeFilenameSpelling set the start ptr to null, there was an 468 // error. 469 if (Filename.empty()) 470 return; 471 472 // Search include directories for this file. 473 const DirectoryLookup *CurDir; 474 const FileEntry *File = 475 LookupFile(FilenameTok.getLocation(), Filename, isAngled, nullptr, 476 nullptr, CurDir, nullptr, nullptr, nullptr); 477 if (!File) { 478 if (!SuppressIncludeNotFoundError) 479 Diag(FilenameTok, diag::err_pp_file_not_found) << Filename; 480 return; 481 } 482 483 const FileEntry *CurFile = getCurrentFileLexer()->getFileEntry(); 484 485 // If this file is older than the file it depends on, emit a diagnostic. 486 if (CurFile && CurFile->getModificationTime() < File->getModificationTime()) { 487 // Lex tokens at the end of the message and include them in the message. 488 std::string Message; 489 Lex(DependencyTok); 490 while (DependencyTok.isNot(tok::eod)) { 491 Message += getSpelling(DependencyTok) + " "; 492 Lex(DependencyTok); 493 } 494 495 // Remove the trailing ' ' if present. 496 if (!Message.empty()) 497 Message.erase(Message.end()-1); 498 Diag(FilenameTok, diag::pp_out_of_date_dependency) << Message; 499 } 500 } 501 502 /// ParsePragmaPushOrPopMacro - Handle parsing of pragma push_macro/pop_macro. 503 /// Return the IdentifierInfo* associated with the macro to push or pop. 504 IdentifierInfo *Preprocessor::ParsePragmaPushOrPopMacro(Token &Tok) { 505 // Remember the pragma token location. 506 Token PragmaTok = Tok; 507 508 // Read the '('. 509 Lex(Tok); 510 if (Tok.isNot(tok::l_paren)) { 511 Diag(PragmaTok.getLocation(), diag::err_pragma_push_pop_macro_malformed) 512 << getSpelling(PragmaTok); 513 return nullptr; 514 } 515 516 // Read the macro name string. 517 Lex(Tok); 518 if (Tok.isNot(tok::string_literal)) { 519 Diag(PragmaTok.getLocation(), diag::err_pragma_push_pop_macro_malformed) 520 << getSpelling(PragmaTok); 521 return nullptr; 522 } 523 524 if (Tok.hasUDSuffix()) { 525 Diag(Tok, diag::err_invalid_string_udl); 526 return nullptr; 527 } 528 529 // Remember the macro string. 530 std::string StrVal = getSpelling(Tok); 531 532 // Read the ')'. 533 Lex(Tok); 534 if (Tok.isNot(tok::r_paren)) { 535 Diag(PragmaTok.getLocation(), diag::err_pragma_push_pop_macro_malformed) 536 << getSpelling(PragmaTok); 537 return nullptr; 538 } 539 540 assert(StrVal[0] == '"' && StrVal[StrVal.size()-1] == '"' && 541 "Invalid string token!"); 542 543 // Create a Token from the string. 544 Token MacroTok; 545 MacroTok.startToken(); 546 MacroTok.setKind(tok::raw_identifier); 547 CreateString(StringRef(&StrVal[1], StrVal.size() - 2), MacroTok); 548 549 // Get the IdentifierInfo of MacroToPushTok. 550 return LookUpIdentifierInfo(MacroTok); 551 } 552 553 /// \brief Handle \#pragma push_macro. 554 /// 555 /// The syntax is: 556 /// \code 557 /// #pragma push_macro("macro") 558 /// \endcode 559 void Preprocessor::HandlePragmaPushMacro(Token &PushMacroTok) { 560 // Parse the pragma directive and get the macro IdentifierInfo*. 561 IdentifierInfo *IdentInfo = ParsePragmaPushOrPopMacro(PushMacroTok); 562 if (!IdentInfo) return; 563 564 // Get the MacroInfo associated with IdentInfo. 565 MacroInfo *MI = getMacroInfo(IdentInfo); 566 567 if (MI) { 568 // Allow the original MacroInfo to be redefined later. 569 MI->setIsAllowRedefinitionsWithoutWarning(true); 570 } 571 572 // Push the cloned MacroInfo so we can retrieve it later. 573 PragmaPushMacroInfo[IdentInfo].push_back(MI); 574 } 575 576 /// \brief Handle \#pragma pop_macro. 577 /// 578 /// The syntax is: 579 /// \code 580 /// #pragma pop_macro("macro") 581 /// \endcode 582 void Preprocessor::HandlePragmaPopMacro(Token &PopMacroTok) { 583 SourceLocation MessageLoc = PopMacroTok.getLocation(); 584 585 // Parse the pragma directive and get the macro IdentifierInfo*. 586 IdentifierInfo *IdentInfo = ParsePragmaPushOrPopMacro(PopMacroTok); 587 if (!IdentInfo) return; 588 589 // Find the vector<MacroInfo*> associated with the macro. 590 llvm::DenseMap<IdentifierInfo*, std::vector<MacroInfo*> >::iterator iter = 591 PragmaPushMacroInfo.find(IdentInfo); 592 if (iter != PragmaPushMacroInfo.end()) { 593 // Forget the MacroInfo currently associated with IdentInfo. 594 if (MacroInfo *MI = getMacroInfo(IdentInfo)) { 595 if (MI->isWarnIfUnused()) 596 WarnUnusedMacroLocs.erase(MI->getDefinitionLoc()); 597 appendMacroDirective(IdentInfo, AllocateUndefMacroDirective(MessageLoc)); 598 } 599 600 // Get the MacroInfo we want to reinstall. 601 MacroInfo *MacroToReInstall = iter->second.back(); 602 603 if (MacroToReInstall) 604 // Reinstall the previously pushed macro. 605 appendDefMacroDirective(IdentInfo, MacroToReInstall, MessageLoc); 606 607 // Pop PragmaPushMacroInfo stack. 608 iter->second.pop_back(); 609 if (iter->second.size() == 0) 610 PragmaPushMacroInfo.erase(iter); 611 } else { 612 Diag(MessageLoc, diag::warn_pragma_pop_macro_no_push) 613 << IdentInfo->getName(); 614 } 615 } 616 617 void Preprocessor::HandlePragmaIncludeAlias(Token &Tok) { 618 // We will either get a quoted filename or a bracketed filename, and we 619 // have to track which we got. The first filename is the source name, 620 // and the second name is the mapped filename. If the first is quoted, 621 // the second must be as well (cannot mix and match quotes and brackets). 622 623 // Get the open paren 624 Lex(Tok); 625 if (Tok.isNot(tok::l_paren)) { 626 Diag(Tok, diag::warn_pragma_include_alias_expected) << "("; 627 return; 628 } 629 630 // We expect either a quoted string literal, or a bracketed name 631 Token SourceFilenameTok; 632 CurPPLexer->LexIncludeFilename(SourceFilenameTok); 633 if (SourceFilenameTok.is(tok::eod)) { 634 // The diagnostic has already been handled 635 return; 636 } 637 638 StringRef SourceFileName; 639 SmallString<128> FileNameBuffer; 640 if (SourceFilenameTok.is(tok::string_literal) || 641 SourceFilenameTok.is(tok::angle_string_literal)) { 642 SourceFileName = getSpelling(SourceFilenameTok, FileNameBuffer); 643 } else if (SourceFilenameTok.is(tok::less)) { 644 // This could be a path instead of just a name 645 FileNameBuffer.push_back('<'); 646 SourceLocation End; 647 if (ConcatenateIncludeName(FileNameBuffer, End)) 648 return; // Diagnostic already emitted 649 SourceFileName = FileNameBuffer; 650 } else { 651 Diag(Tok, diag::warn_pragma_include_alias_expected_filename); 652 return; 653 } 654 FileNameBuffer.clear(); 655 656 // Now we expect a comma, followed by another include name 657 Lex(Tok); 658 if (Tok.isNot(tok::comma)) { 659 Diag(Tok, diag::warn_pragma_include_alias_expected) << ","; 660 return; 661 } 662 663 Token ReplaceFilenameTok; 664 CurPPLexer->LexIncludeFilename(ReplaceFilenameTok); 665 if (ReplaceFilenameTok.is(tok::eod)) { 666 // The diagnostic has already been handled 667 return; 668 } 669 670 StringRef ReplaceFileName; 671 if (ReplaceFilenameTok.is(tok::string_literal) || 672 ReplaceFilenameTok.is(tok::angle_string_literal)) { 673 ReplaceFileName = getSpelling(ReplaceFilenameTok, FileNameBuffer); 674 } else if (ReplaceFilenameTok.is(tok::less)) { 675 // This could be a path instead of just a name 676 FileNameBuffer.push_back('<'); 677 SourceLocation End; 678 if (ConcatenateIncludeName(FileNameBuffer, End)) 679 return; // Diagnostic already emitted 680 ReplaceFileName = FileNameBuffer; 681 } else { 682 Diag(Tok, diag::warn_pragma_include_alias_expected_filename); 683 return; 684 } 685 686 // Finally, we expect the closing paren 687 Lex(Tok); 688 if (Tok.isNot(tok::r_paren)) { 689 Diag(Tok, diag::warn_pragma_include_alias_expected) << ")"; 690 return; 691 } 692 693 // Now that we have the source and target filenames, we need to make sure 694 // they're both of the same type (angled vs non-angled) 695 StringRef OriginalSource = SourceFileName; 696 697 bool SourceIsAngled = 698 GetIncludeFilenameSpelling(SourceFilenameTok.getLocation(), 699 SourceFileName); 700 bool ReplaceIsAngled = 701 GetIncludeFilenameSpelling(ReplaceFilenameTok.getLocation(), 702 ReplaceFileName); 703 if (!SourceFileName.empty() && !ReplaceFileName.empty() && 704 (SourceIsAngled != ReplaceIsAngled)) { 705 unsigned int DiagID; 706 if (SourceIsAngled) 707 DiagID = diag::warn_pragma_include_alias_mismatch_angle; 708 else 709 DiagID = diag::warn_pragma_include_alias_mismatch_quote; 710 711 Diag(SourceFilenameTok.getLocation(), DiagID) 712 << SourceFileName 713 << ReplaceFileName; 714 715 return; 716 } 717 718 // Now we can let the include handler know about this mapping 719 getHeaderSearchInfo().AddIncludeAlias(OriginalSource, ReplaceFileName); 720 } 721 722 /// AddPragmaHandler - Add the specified pragma handler to the preprocessor. 723 /// If 'Namespace' is non-null, then it is a token required to exist on the 724 /// pragma line before the pragma string starts, e.g. "STDC" or "GCC". 725 void Preprocessor::AddPragmaHandler(StringRef Namespace, 726 PragmaHandler *Handler) { 727 PragmaNamespace *InsertNS = PragmaHandlers.get(); 728 729 // If this is specified to be in a namespace, step down into it. 730 if (!Namespace.empty()) { 731 // If there is already a pragma handler with the name of this namespace, 732 // we either have an error (directive with the same name as a namespace) or 733 // we already have the namespace to insert into. 734 if (PragmaHandler *Existing = PragmaHandlers->FindHandler(Namespace)) { 735 InsertNS = Existing->getIfNamespace(); 736 assert(InsertNS != nullptr && "Cannot have a pragma namespace and pragma" 737 " handler with the same name!"); 738 } else { 739 // Otherwise, this namespace doesn't exist yet, create and insert the 740 // handler for it. 741 InsertNS = new PragmaNamespace(Namespace); 742 PragmaHandlers->AddPragma(InsertNS); 743 } 744 } 745 746 // Check to make sure we don't already have a pragma for this identifier. 747 assert(!InsertNS->FindHandler(Handler->getName()) && 748 "Pragma handler already exists for this identifier!"); 749 InsertNS->AddPragma(Handler); 750 } 751 752 /// RemovePragmaHandler - Remove the specific pragma handler from the 753 /// preprocessor. If \arg Namespace is non-null, then it should be the 754 /// namespace that \arg Handler was added to. It is an error to remove 755 /// a handler that has not been registered. 756 void Preprocessor::RemovePragmaHandler(StringRef Namespace, 757 PragmaHandler *Handler) { 758 PragmaNamespace *NS = PragmaHandlers.get(); 759 760 // If this is specified to be in a namespace, step down into it. 761 if (!Namespace.empty()) { 762 PragmaHandler *Existing = PragmaHandlers->FindHandler(Namespace); 763 assert(Existing && "Namespace containing handler does not exist!"); 764 765 NS = Existing->getIfNamespace(); 766 assert(NS && "Invalid namespace, registered as a regular pragma handler!"); 767 } 768 769 NS->RemovePragmaHandler(Handler); 770 771 // If this is a non-default namespace and it is now empty, remove it. 772 if (NS != PragmaHandlers.get() && NS->IsEmpty()) { 773 PragmaHandlers->RemovePragmaHandler(NS); 774 delete NS; 775 } 776 } 777 778 bool Preprocessor::LexOnOffSwitch(tok::OnOffSwitch &Result) { 779 Token Tok; 780 LexUnexpandedToken(Tok); 781 782 if (Tok.isNot(tok::identifier)) { 783 Diag(Tok, diag::ext_on_off_switch_syntax); 784 return true; 785 } 786 IdentifierInfo *II = Tok.getIdentifierInfo(); 787 if (II->isStr("ON")) 788 Result = tok::OOS_ON; 789 else if (II->isStr("OFF")) 790 Result = tok::OOS_OFF; 791 else if (II->isStr("DEFAULT")) 792 Result = tok::OOS_DEFAULT; 793 else { 794 Diag(Tok, diag::ext_on_off_switch_syntax); 795 return true; 796 } 797 798 // Verify that this is followed by EOD. 799 LexUnexpandedToken(Tok); 800 if (Tok.isNot(tok::eod)) 801 Diag(Tok, diag::ext_pragma_syntax_eod); 802 return false; 803 } 804 805 namespace { 806 /// PragmaOnceHandler - "\#pragma once" marks the file as atomically included. 807 struct PragmaOnceHandler : public PragmaHandler { 808 PragmaOnceHandler() : PragmaHandler("once") {} 809 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 810 Token &OnceTok) override { 811 PP.CheckEndOfDirective("pragma once"); 812 PP.HandlePragmaOnce(OnceTok); 813 } 814 }; 815 816 /// PragmaMarkHandler - "\#pragma mark ..." is ignored by the compiler, and the 817 /// rest of the line is not lexed. 818 struct PragmaMarkHandler : public PragmaHandler { 819 PragmaMarkHandler() : PragmaHandler("mark") {} 820 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 821 Token &MarkTok) override { 822 PP.HandlePragmaMark(); 823 } 824 }; 825 826 /// PragmaPoisonHandler - "\#pragma poison x" marks x as not usable. 827 struct PragmaPoisonHandler : public PragmaHandler { 828 PragmaPoisonHandler() : PragmaHandler("poison") {} 829 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 830 Token &PoisonTok) override { 831 PP.HandlePragmaPoison(PoisonTok); 832 } 833 }; 834 835 /// PragmaSystemHeaderHandler - "\#pragma system_header" marks the current file 836 /// as a system header, which silences warnings in it. 837 struct PragmaSystemHeaderHandler : public PragmaHandler { 838 PragmaSystemHeaderHandler() : PragmaHandler("system_header") {} 839 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 840 Token &SHToken) override { 841 PP.HandlePragmaSystemHeader(SHToken); 842 PP.CheckEndOfDirective("pragma"); 843 } 844 }; 845 struct PragmaDependencyHandler : public PragmaHandler { 846 PragmaDependencyHandler() : PragmaHandler("dependency") {} 847 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 848 Token &DepToken) override { 849 PP.HandlePragmaDependency(DepToken); 850 } 851 }; 852 853 struct PragmaDebugHandler : public PragmaHandler { 854 PragmaDebugHandler() : PragmaHandler("__debug") {} 855 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 856 Token &DepToken) override { 857 Token Tok; 858 PP.LexUnexpandedToken(Tok); 859 if (Tok.isNot(tok::identifier)) { 860 PP.Diag(Tok, diag::warn_pragma_diagnostic_invalid); 861 return; 862 } 863 IdentifierInfo *II = Tok.getIdentifierInfo(); 864 865 if (II->isStr("assert")) { 866 llvm_unreachable("This is an assertion!"); 867 } else if (II->isStr("crash")) { 868 LLVM_BUILTIN_TRAP; 869 } else if (II->isStr("parser_crash")) { 870 Token Crasher; 871 Crasher.startToken(); 872 Crasher.setKind(tok::annot_pragma_parser_crash); 873 Crasher.setAnnotationRange(SourceRange(Tok.getLocation())); 874 PP.EnterToken(Crasher); 875 } else if (II->isStr("llvm_fatal_error")) { 876 llvm::report_fatal_error("#pragma clang __debug llvm_fatal_error"); 877 } else if (II->isStr("llvm_unreachable")) { 878 llvm_unreachable("#pragma clang __debug llvm_unreachable"); 879 } else if (II->isStr("macro")) { 880 Token MacroName; 881 PP.LexUnexpandedToken(MacroName); 882 auto *MacroII = MacroName.getIdentifierInfo(); 883 if (MacroII) 884 PP.dumpMacroInfo(MacroII); 885 else 886 PP.Diag(MacroName, diag::warn_pragma_diagnostic_invalid); 887 } else if (II->isStr("overflow_stack")) { 888 DebugOverflowStack(); 889 } else if (II->isStr("handle_crash")) { 890 llvm::CrashRecoveryContext *CRC =llvm::CrashRecoveryContext::GetCurrent(); 891 if (CRC) 892 CRC->HandleCrash(); 893 } else if (II->isStr("captured")) { 894 HandleCaptured(PP); 895 } else { 896 PP.Diag(Tok, diag::warn_pragma_debug_unexpected_command) 897 << II->getName(); 898 } 899 900 PPCallbacks *Callbacks = PP.getPPCallbacks(); 901 if (Callbacks) 902 Callbacks->PragmaDebug(Tok.getLocation(), II->getName()); 903 } 904 905 void HandleCaptured(Preprocessor &PP) { 906 // Skip if emitting preprocessed output. 907 if (PP.isPreprocessedOutput()) 908 return; 909 910 Token Tok; 911 PP.LexUnexpandedToken(Tok); 912 913 if (Tok.isNot(tok::eod)) { 914 PP.Diag(Tok, diag::ext_pp_extra_tokens_at_eol) 915 << "pragma clang __debug captured"; 916 return; 917 } 918 919 SourceLocation NameLoc = Tok.getLocation(); 920 Token *Toks = PP.getPreprocessorAllocator().Allocate<Token>(1); 921 Toks->startToken(); 922 Toks->setKind(tok::annot_pragma_captured); 923 Toks->setLocation(NameLoc); 924 925 PP.EnterTokenStream(Toks, 1, /*DisableMacroExpansion=*/true, 926 /*OwnsTokens=*/false); 927 } 928 929 // Disable MSVC warning about runtime stack overflow. 930 #ifdef _MSC_VER 931 #pragma warning(disable : 4717) 932 #endif 933 static void DebugOverflowStack() { 934 void (*volatile Self)() = DebugOverflowStack; 935 Self(); 936 } 937 #ifdef _MSC_VER 938 #pragma warning(default : 4717) 939 #endif 940 941 }; 942 943 /// PragmaDiagnosticHandler - e.g. '\#pragma GCC diagnostic ignored "-Wformat"' 944 struct PragmaDiagnosticHandler : public PragmaHandler { 945 private: 946 const char *Namespace; 947 public: 948 explicit PragmaDiagnosticHandler(const char *NS) : 949 PragmaHandler("diagnostic"), Namespace(NS) {} 950 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 951 Token &DiagToken) override { 952 SourceLocation DiagLoc = DiagToken.getLocation(); 953 Token Tok; 954 PP.LexUnexpandedToken(Tok); 955 if (Tok.isNot(tok::identifier)) { 956 PP.Diag(Tok, diag::warn_pragma_diagnostic_invalid); 957 return; 958 } 959 IdentifierInfo *II = Tok.getIdentifierInfo(); 960 PPCallbacks *Callbacks = PP.getPPCallbacks(); 961 962 if (II->isStr("pop")) { 963 if (!PP.getDiagnostics().popMappings(DiagLoc)) 964 PP.Diag(Tok, diag::warn_pragma_diagnostic_cannot_pop); 965 else if (Callbacks) 966 Callbacks->PragmaDiagnosticPop(DiagLoc, Namespace); 967 return; 968 } else if (II->isStr("push")) { 969 PP.getDiagnostics().pushMappings(DiagLoc); 970 if (Callbacks) 971 Callbacks->PragmaDiagnosticPush(DiagLoc, Namespace); 972 return; 973 } 974 975 diag::Severity SV = llvm::StringSwitch<diag::Severity>(II->getName()) 976 .Case("ignored", diag::Severity::Ignored) 977 .Case("warning", diag::Severity::Warning) 978 .Case("error", diag::Severity::Error) 979 .Case("fatal", diag::Severity::Fatal) 980 .Default(diag::Severity()); 981 982 if (SV == diag::Severity()) { 983 PP.Diag(Tok, diag::warn_pragma_diagnostic_invalid); 984 return; 985 } 986 987 PP.LexUnexpandedToken(Tok); 988 SourceLocation StringLoc = Tok.getLocation(); 989 990 std::string WarningName; 991 if (!PP.FinishLexStringLiteral(Tok, WarningName, "pragma diagnostic", 992 /*MacroExpansion=*/false)) 993 return; 994 995 if (Tok.isNot(tok::eod)) { 996 PP.Diag(Tok.getLocation(), diag::warn_pragma_diagnostic_invalid_token); 997 return; 998 } 999 1000 if (WarningName.size() < 3 || WarningName[0] != '-' || 1001 (WarningName[1] != 'W' && WarningName[1] != 'R')) { 1002 PP.Diag(StringLoc, diag::warn_pragma_diagnostic_invalid_option); 1003 return; 1004 } 1005 1006 if (PP.getDiagnostics().setSeverityForGroup( 1007 WarningName[1] == 'W' ? diag::Flavor::WarningOrError 1008 : diag::Flavor::Remark, 1009 WarningName.substr(2), SV, DiagLoc)) 1010 PP.Diag(StringLoc, diag::warn_pragma_diagnostic_unknown_warning) 1011 << WarningName; 1012 else if (Callbacks) 1013 Callbacks->PragmaDiagnostic(DiagLoc, Namespace, SV, WarningName); 1014 } 1015 }; 1016 1017 /// "\#pragma warning(...)". MSVC's diagnostics do not map cleanly to clang's 1018 /// diagnostics, so we don't really implement this pragma. We parse it and 1019 /// ignore it to avoid -Wunknown-pragma warnings. 1020 struct PragmaWarningHandler : public PragmaHandler { 1021 PragmaWarningHandler() : PragmaHandler("warning") {} 1022 1023 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1024 Token &Tok) override { 1025 // Parse things like: 1026 // warning(push, 1) 1027 // warning(pop) 1028 // warning(disable : 1 2 3 ; error : 4 5 6 ; suppress : 7 8 9) 1029 SourceLocation DiagLoc = Tok.getLocation(); 1030 PPCallbacks *Callbacks = PP.getPPCallbacks(); 1031 1032 PP.Lex(Tok); 1033 if (Tok.isNot(tok::l_paren)) { 1034 PP.Diag(Tok, diag::warn_pragma_warning_expected) << "("; 1035 return; 1036 } 1037 1038 PP.Lex(Tok); 1039 IdentifierInfo *II = Tok.getIdentifierInfo(); 1040 1041 if (II && II->isStr("push")) { 1042 // #pragma warning( push[ ,n ] ) 1043 int Level = -1; 1044 PP.Lex(Tok); 1045 if (Tok.is(tok::comma)) { 1046 PP.Lex(Tok); 1047 uint64_t Value; 1048 if (Tok.is(tok::numeric_constant) && 1049 PP.parseSimpleIntegerLiteral(Tok, Value)) 1050 Level = int(Value); 1051 if (Level < 0 || Level > 4) { 1052 PP.Diag(Tok, diag::warn_pragma_warning_push_level); 1053 return; 1054 } 1055 } 1056 if (Callbacks) 1057 Callbacks->PragmaWarningPush(DiagLoc, Level); 1058 } else if (II && II->isStr("pop")) { 1059 // #pragma warning( pop ) 1060 PP.Lex(Tok); 1061 if (Callbacks) 1062 Callbacks->PragmaWarningPop(DiagLoc); 1063 } else { 1064 // #pragma warning( warning-specifier : warning-number-list 1065 // [; warning-specifier : warning-number-list...] ) 1066 while (true) { 1067 II = Tok.getIdentifierInfo(); 1068 if (!II && !Tok.is(tok::numeric_constant)) { 1069 PP.Diag(Tok, diag::warn_pragma_warning_spec_invalid); 1070 return; 1071 } 1072 1073 // Figure out which warning specifier this is. 1074 bool SpecifierValid; 1075 StringRef Specifier; 1076 llvm::SmallString<1> SpecifierBuf; 1077 if (II) { 1078 Specifier = II->getName(); 1079 SpecifierValid = llvm::StringSwitch<bool>(Specifier) 1080 .Cases("default", "disable", "error", "once", 1081 "suppress", true) 1082 .Default(false); 1083 // If we read a correct specifier, snatch next token (that should be 1084 // ":", checked later). 1085 if (SpecifierValid) 1086 PP.Lex(Tok); 1087 } else { 1088 // Token is a numeric constant. It should be either 1, 2, 3 or 4. 1089 uint64_t Value; 1090 Specifier = PP.getSpelling(Tok, SpecifierBuf); 1091 if (PP.parseSimpleIntegerLiteral(Tok, Value)) { 1092 SpecifierValid = (Value >= 1) && (Value <= 4); 1093 } else 1094 SpecifierValid = false; 1095 // Next token already snatched by parseSimpleIntegerLiteral. 1096 } 1097 1098 if (!SpecifierValid) { 1099 PP.Diag(Tok, diag::warn_pragma_warning_spec_invalid); 1100 return; 1101 } 1102 if (Tok.isNot(tok::colon)) { 1103 PP.Diag(Tok, diag::warn_pragma_warning_expected) << ":"; 1104 return; 1105 } 1106 1107 // Collect the warning ids. 1108 SmallVector<int, 4> Ids; 1109 PP.Lex(Tok); 1110 while (Tok.is(tok::numeric_constant)) { 1111 uint64_t Value; 1112 if (!PP.parseSimpleIntegerLiteral(Tok, Value) || Value == 0 || 1113 Value > INT_MAX) { 1114 PP.Diag(Tok, diag::warn_pragma_warning_expected_number); 1115 return; 1116 } 1117 Ids.push_back(int(Value)); 1118 } 1119 if (Callbacks) 1120 Callbacks->PragmaWarning(DiagLoc, Specifier, Ids); 1121 1122 // Parse the next specifier if there is a semicolon. 1123 if (Tok.isNot(tok::semi)) 1124 break; 1125 PP.Lex(Tok); 1126 } 1127 } 1128 1129 if (Tok.isNot(tok::r_paren)) { 1130 PP.Diag(Tok, diag::warn_pragma_warning_expected) << ")"; 1131 return; 1132 } 1133 1134 PP.Lex(Tok); 1135 if (Tok.isNot(tok::eod)) 1136 PP.Diag(Tok, diag::ext_pp_extra_tokens_at_eol) << "pragma warning"; 1137 } 1138 }; 1139 1140 /// PragmaIncludeAliasHandler - "\#pragma include_alias("...")". 1141 struct PragmaIncludeAliasHandler : public PragmaHandler { 1142 PragmaIncludeAliasHandler() : PragmaHandler("include_alias") {} 1143 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1144 Token &IncludeAliasTok) override { 1145 PP.HandlePragmaIncludeAlias(IncludeAliasTok); 1146 } 1147 }; 1148 1149 /// PragmaMessageHandler - Handle the microsoft and gcc \#pragma message 1150 /// extension. The syntax is: 1151 /// \code 1152 /// #pragma message(string) 1153 /// \endcode 1154 /// OR, in GCC mode: 1155 /// \code 1156 /// #pragma message string 1157 /// \endcode 1158 /// string is a string, which is fully macro expanded, and permits string 1159 /// concatenation, embedded escape characters, etc... See MSDN for more details. 1160 /// Also handles \#pragma GCC warning and \#pragma GCC error which take the same 1161 /// form as \#pragma message. 1162 struct PragmaMessageHandler : public PragmaHandler { 1163 private: 1164 const PPCallbacks::PragmaMessageKind Kind; 1165 const StringRef Namespace; 1166 1167 static const char* PragmaKind(PPCallbacks::PragmaMessageKind Kind, 1168 bool PragmaNameOnly = false) { 1169 switch (Kind) { 1170 case PPCallbacks::PMK_Message: 1171 return PragmaNameOnly ? "message" : "pragma message"; 1172 case PPCallbacks::PMK_Warning: 1173 return PragmaNameOnly ? "warning" : "pragma warning"; 1174 case PPCallbacks::PMK_Error: 1175 return PragmaNameOnly ? "error" : "pragma error"; 1176 } 1177 llvm_unreachable("Unknown PragmaMessageKind!"); 1178 } 1179 1180 public: 1181 PragmaMessageHandler(PPCallbacks::PragmaMessageKind Kind, 1182 StringRef Namespace = StringRef()) 1183 : PragmaHandler(PragmaKind(Kind, true)), Kind(Kind), Namespace(Namespace) {} 1184 1185 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1186 Token &Tok) override { 1187 SourceLocation MessageLoc = Tok.getLocation(); 1188 PP.Lex(Tok); 1189 bool ExpectClosingParen = false; 1190 switch (Tok.getKind()) { 1191 case tok::l_paren: 1192 // We have a MSVC style pragma message. 1193 ExpectClosingParen = true; 1194 // Read the string. 1195 PP.Lex(Tok); 1196 break; 1197 case tok::string_literal: 1198 // We have a GCC style pragma message, and we just read the string. 1199 break; 1200 default: 1201 PP.Diag(MessageLoc, diag::err_pragma_message_malformed) << Kind; 1202 return; 1203 } 1204 1205 std::string MessageString; 1206 if (!PP.FinishLexStringLiteral(Tok, MessageString, PragmaKind(Kind), 1207 /*MacroExpansion=*/true)) 1208 return; 1209 1210 if (ExpectClosingParen) { 1211 if (Tok.isNot(tok::r_paren)) { 1212 PP.Diag(Tok.getLocation(), diag::err_pragma_message_malformed) << Kind; 1213 return; 1214 } 1215 PP.Lex(Tok); // eat the r_paren. 1216 } 1217 1218 if (Tok.isNot(tok::eod)) { 1219 PP.Diag(Tok.getLocation(), diag::err_pragma_message_malformed) << Kind; 1220 return; 1221 } 1222 1223 // Output the message. 1224 PP.Diag(MessageLoc, (Kind == PPCallbacks::PMK_Error) 1225 ? diag::err_pragma_message 1226 : diag::warn_pragma_message) << MessageString; 1227 1228 // If the pragma is lexically sound, notify any interested PPCallbacks. 1229 if (PPCallbacks *Callbacks = PP.getPPCallbacks()) 1230 Callbacks->PragmaMessage(MessageLoc, Namespace, Kind, MessageString); 1231 } 1232 }; 1233 1234 /// PragmaPushMacroHandler - "\#pragma push_macro" saves the value of the 1235 /// macro on the top of the stack. 1236 struct PragmaPushMacroHandler : public PragmaHandler { 1237 PragmaPushMacroHandler() : PragmaHandler("push_macro") {} 1238 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1239 Token &PushMacroTok) override { 1240 PP.HandlePragmaPushMacro(PushMacroTok); 1241 } 1242 }; 1243 1244 1245 /// PragmaPopMacroHandler - "\#pragma pop_macro" sets the value of the 1246 /// macro to the value on the top of the stack. 1247 struct PragmaPopMacroHandler : public PragmaHandler { 1248 PragmaPopMacroHandler() : PragmaHandler("pop_macro") {} 1249 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1250 Token &PopMacroTok) override { 1251 PP.HandlePragmaPopMacro(PopMacroTok); 1252 } 1253 }; 1254 1255 // Pragma STDC implementations. 1256 1257 /// PragmaSTDC_FENV_ACCESSHandler - "\#pragma STDC FENV_ACCESS ...". 1258 struct PragmaSTDC_FENV_ACCESSHandler : public PragmaHandler { 1259 PragmaSTDC_FENV_ACCESSHandler() : PragmaHandler("FENV_ACCESS") {} 1260 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1261 Token &Tok) override { 1262 tok::OnOffSwitch OOS; 1263 if (PP.LexOnOffSwitch(OOS)) 1264 return; 1265 if (OOS == tok::OOS_ON) 1266 PP.Diag(Tok, diag::warn_stdc_fenv_access_not_supported); 1267 } 1268 }; 1269 1270 /// PragmaSTDC_CX_LIMITED_RANGEHandler - "\#pragma STDC CX_LIMITED_RANGE ...". 1271 struct PragmaSTDC_CX_LIMITED_RANGEHandler : public PragmaHandler { 1272 PragmaSTDC_CX_LIMITED_RANGEHandler() 1273 : PragmaHandler("CX_LIMITED_RANGE") {} 1274 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1275 Token &Tok) override { 1276 tok::OnOffSwitch OOS; 1277 PP.LexOnOffSwitch(OOS); 1278 } 1279 }; 1280 1281 /// PragmaSTDC_UnknownHandler - "\#pragma STDC ...". 1282 struct PragmaSTDC_UnknownHandler : public PragmaHandler { 1283 PragmaSTDC_UnknownHandler() {} 1284 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1285 Token &UnknownTok) override { 1286 // C99 6.10.6p2, unknown forms are not allowed. 1287 PP.Diag(UnknownTok, diag::ext_stdc_pragma_ignored); 1288 } 1289 }; 1290 1291 /// PragmaARCCFCodeAuditedHandler - 1292 /// \#pragma clang arc_cf_code_audited begin/end 1293 struct PragmaARCCFCodeAuditedHandler : public PragmaHandler { 1294 PragmaARCCFCodeAuditedHandler() : PragmaHandler("arc_cf_code_audited") {} 1295 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1296 Token &NameTok) override { 1297 SourceLocation Loc = NameTok.getLocation(); 1298 bool IsBegin; 1299 1300 Token Tok; 1301 1302 // Lex the 'begin' or 'end'. 1303 PP.LexUnexpandedToken(Tok); 1304 const IdentifierInfo *BeginEnd = Tok.getIdentifierInfo(); 1305 if (BeginEnd && BeginEnd->isStr("begin")) { 1306 IsBegin = true; 1307 } else if (BeginEnd && BeginEnd->isStr("end")) { 1308 IsBegin = false; 1309 } else { 1310 PP.Diag(Tok.getLocation(), diag::err_pp_arc_cf_code_audited_syntax); 1311 return; 1312 } 1313 1314 // Verify that this is followed by EOD. 1315 PP.LexUnexpandedToken(Tok); 1316 if (Tok.isNot(tok::eod)) 1317 PP.Diag(Tok, diag::ext_pp_extra_tokens_at_eol) << "pragma"; 1318 1319 // The start location of the active audit. 1320 SourceLocation BeginLoc = PP.getPragmaARCCFCodeAuditedLoc(); 1321 1322 // The start location we want after processing this. 1323 SourceLocation NewLoc; 1324 1325 if (IsBegin) { 1326 // Complain about attempts to re-enter an audit. 1327 if (BeginLoc.isValid()) { 1328 PP.Diag(Loc, diag::err_pp_double_begin_of_arc_cf_code_audited); 1329 PP.Diag(BeginLoc, diag::note_pragma_entered_here); 1330 } 1331 NewLoc = Loc; 1332 } else { 1333 // Complain about attempts to leave an audit that doesn't exist. 1334 if (!BeginLoc.isValid()) { 1335 PP.Diag(Loc, diag::err_pp_unmatched_end_of_arc_cf_code_audited); 1336 return; 1337 } 1338 NewLoc = SourceLocation(); 1339 } 1340 1341 PP.setPragmaARCCFCodeAuditedLoc(NewLoc); 1342 } 1343 }; 1344 1345 /// PragmaAssumeNonNullHandler - 1346 /// \#pragma clang assume_nonnull begin/end 1347 struct PragmaAssumeNonNullHandler : public PragmaHandler { 1348 PragmaAssumeNonNullHandler() : PragmaHandler("assume_nonnull") {} 1349 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1350 Token &NameTok) override { 1351 SourceLocation Loc = NameTok.getLocation(); 1352 bool IsBegin; 1353 1354 Token Tok; 1355 1356 // Lex the 'begin' or 'end'. 1357 PP.LexUnexpandedToken(Tok); 1358 const IdentifierInfo *BeginEnd = Tok.getIdentifierInfo(); 1359 if (BeginEnd && BeginEnd->isStr("begin")) { 1360 IsBegin = true; 1361 } else if (BeginEnd && BeginEnd->isStr("end")) { 1362 IsBegin = false; 1363 } else { 1364 PP.Diag(Tok.getLocation(), diag::err_pp_assume_nonnull_syntax); 1365 return; 1366 } 1367 1368 // Verify that this is followed by EOD. 1369 PP.LexUnexpandedToken(Tok); 1370 if (Tok.isNot(tok::eod)) 1371 PP.Diag(Tok, diag::ext_pp_extra_tokens_at_eol) << "pragma"; 1372 1373 // The start location of the active audit. 1374 SourceLocation BeginLoc = PP.getPragmaAssumeNonNullLoc(); 1375 1376 // The start location we want after processing this. 1377 SourceLocation NewLoc; 1378 1379 if (IsBegin) { 1380 // Complain about attempts to re-enter an audit. 1381 if (BeginLoc.isValid()) { 1382 PP.Diag(Loc, diag::err_pp_double_begin_of_assume_nonnull); 1383 PP.Diag(BeginLoc, diag::note_pragma_entered_here); 1384 } 1385 NewLoc = Loc; 1386 } else { 1387 // Complain about attempts to leave an audit that doesn't exist. 1388 if (!BeginLoc.isValid()) { 1389 PP.Diag(Loc, diag::err_pp_unmatched_end_of_assume_nonnull); 1390 return; 1391 } 1392 NewLoc = SourceLocation(); 1393 } 1394 1395 PP.setPragmaAssumeNonNullLoc(NewLoc); 1396 } 1397 }; 1398 1399 /// \brief Handle "\#pragma region [...]" 1400 /// 1401 /// The syntax is 1402 /// \code 1403 /// #pragma region [optional name] 1404 /// #pragma endregion [optional comment] 1405 /// \endcode 1406 /// 1407 /// \note This is 1408 /// <a href="http://msdn.microsoft.com/en-us/library/b6xkz944(v=vs.80).aspx">editor-only</a> 1409 /// pragma, just skipped by compiler. 1410 struct PragmaRegionHandler : public PragmaHandler { 1411 PragmaRegionHandler(const char *pragma) : PragmaHandler(pragma) { } 1412 1413 void HandlePragma(Preprocessor &PP, PragmaIntroducerKind Introducer, 1414 Token &NameTok) override { 1415 // #pragma region: endregion matches can be verified 1416 // __pragma(region): no sense, but ignored by msvc 1417 // _Pragma is not valid for MSVC, but there isn't any point 1418 // to handle a _Pragma differently. 1419 } 1420 }; 1421 1422 } // end anonymous namespace 1423 1424 1425 /// RegisterBuiltinPragmas - Install the standard preprocessor pragmas: 1426 /// \#pragma GCC poison/system_header/dependency and \#pragma once. 1427 void Preprocessor::RegisterBuiltinPragmas() { 1428 AddPragmaHandler(new PragmaOnceHandler()); 1429 AddPragmaHandler(new PragmaMarkHandler()); 1430 AddPragmaHandler(new PragmaPushMacroHandler()); 1431 AddPragmaHandler(new PragmaPopMacroHandler()); 1432 AddPragmaHandler(new PragmaMessageHandler(PPCallbacks::PMK_Message)); 1433 1434 // #pragma GCC ... 1435 AddPragmaHandler("GCC", new PragmaPoisonHandler()); 1436 AddPragmaHandler("GCC", new PragmaSystemHeaderHandler()); 1437 AddPragmaHandler("GCC", new PragmaDependencyHandler()); 1438 AddPragmaHandler("GCC", new PragmaDiagnosticHandler("GCC")); 1439 AddPragmaHandler("GCC", new PragmaMessageHandler(PPCallbacks::PMK_Warning, 1440 "GCC")); 1441 AddPragmaHandler("GCC", new PragmaMessageHandler(PPCallbacks::PMK_Error, 1442 "GCC")); 1443 // #pragma clang ... 1444 AddPragmaHandler("clang", new PragmaPoisonHandler()); 1445 AddPragmaHandler("clang", new PragmaSystemHeaderHandler()); 1446 AddPragmaHandler("clang", new PragmaDebugHandler()); 1447 AddPragmaHandler("clang", new PragmaDependencyHandler()); 1448 AddPragmaHandler("clang", new PragmaDiagnosticHandler("clang")); 1449 AddPragmaHandler("clang", new PragmaARCCFCodeAuditedHandler()); 1450 AddPragmaHandler("clang", new PragmaAssumeNonNullHandler()); 1451 1452 AddPragmaHandler("STDC", new PragmaSTDC_FENV_ACCESSHandler()); 1453 AddPragmaHandler("STDC", new PragmaSTDC_CX_LIMITED_RANGEHandler()); 1454 AddPragmaHandler("STDC", new PragmaSTDC_UnknownHandler()); 1455 1456 // MS extensions. 1457 if (LangOpts.MicrosoftExt) { 1458 AddPragmaHandler(new PragmaWarningHandler()); 1459 AddPragmaHandler(new PragmaIncludeAliasHandler()); 1460 AddPragmaHandler(new PragmaRegionHandler("region")); 1461 AddPragmaHandler(new PragmaRegionHandler("endregion")); 1462 } 1463 } 1464 1465 /// Ignore all pragmas, useful for modes such as -Eonly which would otherwise 1466 /// warn about those pragmas being unknown. 1467 void Preprocessor::IgnorePragmas() { 1468 AddPragmaHandler(new EmptyPragmaHandler()); 1469 // Also ignore all pragmas in all namespaces created 1470 // in Preprocessor::RegisterBuiltinPragmas(). 1471 AddPragmaHandler("GCC", new EmptyPragmaHandler()); 1472 AddPragmaHandler("clang", new EmptyPragmaHandler()); 1473 if (PragmaHandler *NS = PragmaHandlers->FindHandler("STDC")) { 1474 // Preprocessor::RegisterBuiltinPragmas() already registers 1475 // PragmaSTDC_UnknownHandler as the empty handler, so remove it first, 1476 // otherwise there will be an assert about a duplicate handler. 1477 PragmaNamespace *STDCNamespace = NS->getIfNamespace(); 1478 assert(STDCNamespace && 1479 "Invalid namespace, registered as a regular pragma handler!"); 1480 if (PragmaHandler *Existing = STDCNamespace->FindHandler("", false)) { 1481 RemovePragmaHandler("STDC", Existing); 1482 delete Existing; 1483 } 1484 } 1485 AddPragmaHandler("STDC", new EmptyPragmaHandler()); 1486 } 1487