Parser.cpp revision 200583
1//===--- Parser.cpp - C Language Family Parser ----------------------------===// 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 Parser interfaces. 11// 12//===----------------------------------------------------------------------===// 13 14#include "clang/Parse/Parser.h" 15#include "clang/Parse/ParseDiagnostic.h" 16#include "clang/Parse/DeclSpec.h" 17#include "clang/Parse/Scope.h" 18#include "clang/Parse/Template.h" 19#include "llvm/Support/raw_ostream.h" 20#include "RAIIObjectsForParser.h" 21#include "ParsePragma.h" 22using namespace clang; 23 24/// \brief A comment handler that passes comments found by the preprocessor 25/// to the parser action. 26class ActionCommentHandler : public CommentHandler { 27 Action &Actions; 28 29public: 30 explicit ActionCommentHandler(Action &Actions) : Actions(Actions) { } 31 32 virtual void HandleComment(Preprocessor &PP, SourceRange Comment) { 33 Actions.ActOnComment(Comment); 34 } 35}; 36 37Parser::Parser(Preprocessor &pp, Action &actions) 38 : CrashInfo(*this), PP(pp), Actions(actions), Diags(PP.getDiagnostics()), 39 GreaterThanIsOperator(true), ColonIsSacred(false), 40 TemplateParameterDepth(0) { 41 Tok.setKind(tok::eof); 42 CurScope = 0; 43 NumCachedScopes = 0; 44 ParenCount = BracketCount = BraceCount = 0; 45 ObjCImpDecl = DeclPtrTy(); 46 47 // Add #pragma handlers. These are removed and destroyed in the 48 // destructor. 49 PackHandler.reset(new 50 PragmaPackHandler(&PP.getIdentifierTable().get("pack"), actions)); 51 PP.AddPragmaHandler(0, PackHandler.get()); 52 53 UnusedHandler.reset(new 54 PragmaUnusedHandler(&PP.getIdentifierTable().get("unused"), actions, 55 *this)); 56 PP.AddPragmaHandler(0, UnusedHandler.get()); 57 58 WeakHandler.reset(new 59 PragmaWeakHandler(&PP.getIdentifierTable().get("weak"), actions)); 60 PP.AddPragmaHandler(0, WeakHandler.get()); 61 62 CommentHandler.reset(new ActionCommentHandler(actions)); 63 PP.AddCommentHandler(CommentHandler.get()); 64} 65 66/// If a crash happens while the parser is active, print out a line indicating 67/// what the current token is. 68void PrettyStackTraceParserEntry::print(llvm::raw_ostream &OS) const { 69 const Token &Tok = P.getCurToken(); 70 if (Tok.is(tok::eof)) { 71 OS << "<eof> parser at end of file\n"; 72 return; 73 } 74 75 if (Tok.getLocation().isInvalid()) { 76 OS << "<unknown> parser at unknown location\n"; 77 return; 78 } 79 80 const Preprocessor &PP = P.getPreprocessor(); 81 Tok.getLocation().print(OS, PP.getSourceManager()); 82 if (Tok.isAnnotation()) 83 OS << ": at annotation token \n"; 84 else 85 OS << ": current parser token '" << PP.getSpelling(Tok) << "'\n"; 86} 87 88 89DiagnosticBuilder Parser::Diag(SourceLocation Loc, unsigned DiagID) { 90 return Diags.Report(FullSourceLoc(Loc, PP.getSourceManager()), DiagID); 91} 92 93DiagnosticBuilder Parser::Diag(const Token &Tok, unsigned DiagID) { 94 return Diag(Tok.getLocation(), DiagID); 95} 96 97/// \brief Emits a diagnostic suggesting parentheses surrounding a 98/// given range. 99/// 100/// \param Loc The location where we'll emit the diagnostic. 101/// \param Loc The kind of diagnostic to emit. 102/// \param ParenRange Source range enclosing code that should be parenthesized. 103void Parser::SuggestParentheses(SourceLocation Loc, unsigned DK, 104 SourceRange ParenRange) { 105 SourceLocation EndLoc = PP.getLocForEndOfToken(ParenRange.getEnd()); 106 if (!ParenRange.getEnd().isFileID() || EndLoc.isInvalid()) { 107 // We can't display the parentheses, so just dig the 108 // warning/error and return. 109 Diag(Loc, DK); 110 return; 111 } 112 113 Diag(Loc, DK) 114 << CodeModificationHint::CreateInsertion(ParenRange.getBegin(), "(") 115 << CodeModificationHint::CreateInsertion(EndLoc, ")"); 116} 117 118/// MatchRHSPunctuation - For punctuation with a LHS and RHS (e.g. '['/']'), 119/// this helper function matches and consumes the specified RHS token if 120/// present. If not present, it emits the specified diagnostic indicating 121/// that the parser failed to match the RHS of the token at LHSLoc. LHSName 122/// should be the name of the unmatched LHS token. 123SourceLocation Parser::MatchRHSPunctuation(tok::TokenKind RHSTok, 124 SourceLocation LHSLoc) { 125 126 if (Tok.is(RHSTok)) 127 return ConsumeAnyToken(); 128 129 SourceLocation R = Tok.getLocation(); 130 const char *LHSName = "unknown"; 131 diag::kind DID = diag::err_parse_error; 132 switch (RHSTok) { 133 default: break; 134 case tok::r_paren : LHSName = "("; DID = diag::err_expected_rparen; break; 135 case tok::r_brace : LHSName = "{"; DID = diag::err_expected_rbrace; break; 136 case tok::r_square: LHSName = "["; DID = diag::err_expected_rsquare; break; 137 case tok::greater: LHSName = "<"; DID = diag::err_expected_greater; break; 138 } 139 Diag(Tok, DID); 140 Diag(LHSLoc, diag::note_matching) << LHSName; 141 SkipUntil(RHSTok); 142 return R; 143} 144 145/// ExpectAndConsume - The parser expects that 'ExpectedTok' is next in the 146/// input. If so, it is consumed and false is returned. 147/// 148/// If the input is malformed, this emits the specified diagnostic. Next, if 149/// SkipToTok is specified, it calls SkipUntil(SkipToTok). Finally, true is 150/// returned. 151bool Parser::ExpectAndConsume(tok::TokenKind ExpectedTok, unsigned DiagID, 152 const char *Msg, tok::TokenKind SkipToTok) { 153 if (Tok.is(ExpectedTok)) { 154 ConsumeAnyToken(); 155 return false; 156 } 157 158 const char *Spelling = 0; 159 SourceLocation EndLoc = PP.getLocForEndOfToken(PrevTokLocation); 160 if (EndLoc.isValid() && 161 (Spelling = tok::getTokenSimpleSpelling(ExpectedTok))) { 162 // Show what code to insert to fix this problem. 163 Diag(EndLoc, DiagID) 164 << Msg 165 << CodeModificationHint::CreateInsertion(EndLoc, Spelling); 166 } else 167 Diag(Tok, DiagID) << Msg; 168 169 if (SkipToTok != tok::unknown) 170 SkipUntil(SkipToTok); 171 return true; 172} 173 174//===----------------------------------------------------------------------===// 175// Error recovery. 176//===----------------------------------------------------------------------===// 177 178/// SkipUntil - Read tokens until we get to the specified token, then consume 179/// it (unless DontConsume is true). Because we cannot guarantee that the 180/// token will ever occur, this skips to the next token, or to some likely 181/// good stopping point. If StopAtSemi is true, skipping will stop at a ';' 182/// character. 183/// 184/// If SkipUntil finds the specified token, it returns true, otherwise it 185/// returns false. 186bool Parser::SkipUntil(const tok::TokenKind *Toks, unsigned NumToks, 187 bool StopAtSemi, bool DontConsume) { 188 // We always want this function to skip at least one token if the first token 189 // isn't T and if not at EOF. 190 bool isFirstTokenSkipped = true; 191 while (1) { 192 // If we found one of the tokens, stop and return true. 193 for (unsigned i = 0; i != NumToks; ++i) { 194 if (Tok.is(Toks[i])) { 195 if (DontConsume) { 196 // Noop, don't consume the token. 197 } else { 198 ConsumeAnyToken(); 199 } 200 return true; 201 } 202 } 203 204 switch (Tok.getKind()) { 205 case tok::eof: 206 // Ran out of tokens. 207 return false; 208 209 case tok::l_paren: 210 // Recursively skip properly-nested parens. 211 ConsumeParen(); 212 SkipUntil(tok::r_paren, false); 213 break; 214 case tok::l_square: 215 // Recursively skip properly-nested square brackets. 216 ConsumeBracket(); 217 SkipUntil(tok::r_square, false); 218 break; 219 case tok::l_brace: 220 // Recursively skip properly-nested braces. 221 ConsumeBrace(); 222 SkipUntil(tok::r_brace, false); 223 break; 224 225 // Okay, we found a ']' or '}' or ')', which we think should be balanced. 226 // Since the user wasn't looking for this token (if they were, it would 227 // already be handled), this isn't balanced. If there is a LHS token at a 228 // higher level, we will assume that this matches the unbalanced token 229 // and return it. Otherwise, this is a spurious RHS token, which we skip. 230 case tok::r_paren: 231 if (ParenCount && !isFirstTokenSkipped) 232 return false; // Matches something. 233 ConsumeParen(); 234 break; 235 case tok::r_square: 236 if (BracketCount && !isFirstTokenSkipped) 237 return false; // Matches something. 238 ConsumeBracket(); 239 break; 240 case tok::r_brace: 241 if (BraceCount && !isFirstTokenSkipped) 242 return false; // Matches something. 243 ConsumeBrace(); 244 break; 245 246 case tok::string_literal: 247 case tok::wide_string_literal: 248 ConsumeStringToken(); 249 break; 250 case tok::semi: 251 if (StopAtSemi) 252 return false; 253 // FALL THROUGH. 254 default: 255 // Skip this token. 256 ConsumeToken(); 257 break; 258 } 259 isFirstTokenSkipped = false; 260 } 261} 262 263//===----------------------------------------------------------------------===// 264// Scope manipulation 265//===----------------------------------------------------------------------===// 266 267/// EnterScope - Start a new scope. 268void Parser::EnterScope(unsigned ScopeFlags) { 269 if (NumCachedScopes) { 270 Scope *N = ScopeCache[--NumCachedScopes]; 271 N->Init(CurScope, ScopeFlags); 272 CurScope = N; 273 } else { 274 CurScope = new Scope(CurScope, ScopeFlags); 275 } 276} 277 278/// ExitScope - Pop a scope off the scope stack. 279void Parser::ExitScope() { 280 assert(CurScope && "Scope imbalance!"); 281 282 // Inform the actions module that this scope is going away if there are any 283 // decls in it. 284 if (!CurScope->decl_empty()) 285 Actions.ActOnPopScope(Tok.getLocation(), CurScope); 286 287 Scope *OldScope = CurScope; 288 CurScope = OldScope->getParent(); 289 290 if (NumCachedScopes == ScopeCacheSize) 291 delete OldScope; 292 else 293 ScopeCache[NumCachedScopes++] = OldScope; 294} 295 296 297 298 299//===----------------------------------------------------------------------===// 300// C99 6.9: External Definitions. 301//===----------------------------------------------------------------------===// 302 303Parser::~Parser() { 304 // If we still have scopes active, delete the scope tree. 305 delete CurScope; 306 307 // Free the scope cache. 308 for (unsigned i = 0, e = NumCachedScopes; i != e; ++i) 309 delete ScopeCache[i]; 310 311 // Remove the pragma handlers we installed. 312 PP.RemovePragmaHandler(0, PackHandler.get()); 313 PackHandler.reset(); 314 PP.RemovePragmaHandler(0, UnusedHandler.get()); 315 UnusedHandler.reset(); 316 PP.RemovePragmaHandler(0, WeakHandler.get()); 317 WeakHandler.reset(); 318 PP.RemoveCommentHandler(CommentHandler.get()); 319} 320 321/// Initialize - Warm up the parser. 322/// 323void Parser::Initialize() { 324 // Prime the lexer look-ahead. 325 ConsumeToken(); 326 327 // Create the translation unit scope. Install it as the current scope. 328 assert(CurScope == 0 && "A scope is already active?"); 329 EnterScope(Scope::DeclScope); 330 Actions.ActOnTranslationUnitScope(Tok.getLocation(), CurScope); 331 332 if (Tok.is(tok::eof) && 333 !getLang().CPlusPlus) // Empty source file is an extension in C 334 Diag(Tok, diag::ext_empty_source_file); 335 336 // Initialization for Objective-C context sensitive keywords recognition. 337 // Referenced in Parser::ParseObjCTypeQualifierList. 338 if (getLang().ObjC1) { 339 ObjCTypeQuals[objc_in] = &PP.getIdentifierTable().get("in"); 340 ObjCTypeQuals[objc_out] = &PP.getIdentifierTable().get("out"); 341 ObjCTypeQuals[objc_inout] = &PP.getIdentifierTable().get("inout"); 342 ObjCTypeQuals[objc_oneway] = &PP.getIdentifierTable().get("oneway"); 343 ObjCTypeQuals[objc_bycopy] = &PP.getIdentifierTable().get("bycopy"); 344 ObjCTypeQuals[objc_byref] = &PP.getIdentifierTable().get("byref"); 345 } 346 347 Ident_super = &PP.getIdentifierTable().get("super"); 348} 349 350/// ParseTopLevelDecl - Parse one top-level declaration, return whatever the 351/// action tells us to. This returns true if the EOF was encountered. 352bool Parser::ParseTopLevelDecl(DeclGroupPtrTy &Result) { 353 Result = DeclGroupPtrTy(); 354 if (Tok.is(tok::eof)) { 355 Actions.ActOnEndOfTranslationUnit(); 356 return true; 357 } 358 359 CXX0XAttributeList Attr; 360 if (getLang().CPlusPlus0x && isCXX0XAttributeSpecifier()) 361 Attr = ParseCXX0XAttributes(); 362 Result = ParseExternalDeclaration(Attr); 363 return false; 364} 365 366/// ParseTranslationUnit: 367/// translation-unit: [C99 6.9] 368/// external-declaration 369/// translation-unit external-declaration 370void Parser::ParseTranslationUnit() { 371 Initialize(); 372 373 DeclGroupPtrTy Res; 374 while (!ParseTopLevelDecl(Res)) 375 /*parse them all*/; 376 377 ExitScope(); 378 assert(CurScope == 0 && "Scope imbalance!"); 379} 380 381/// ParseExternalDeclaration: 382/// 383/// external-declaration: [C99 6.9], declaration: [C++ dcl.dcl] 384/// function-definition 385/// declaration 386/// [C++0x] empty-declaration 387/// [GNU] asm-definition 388/// [GNU] __extension__ external-declaration 389/// [OBJC] objc-class-definition 390/// [OBJC] objc-class-declaration 391/// [OBJC] objc-alias-declaration 392/// [OBJC] objc-protocol-definition 393/// [OBJC] objc-method-definition 394/// [OBJC] @end 395/// [C++] linkage-specification 396/// [GNU] asm-definition: 397/// simple-asm-expr ';' 398/// 399/// [C++0x] empty-declaration: 400/// ';' 401/// 402/// [C++0x/GNU] 'extern' 'template' declaration 403Parser::DeclGroupPtrTy Parser::ParseExternalDeclaration(CXX0XAttributeList Attr) { 404 DeclPtrTy SingleDecl; 405 switch (Tok.getKind()) { 406 case tok::semi: 407 if (!getLang().CPlusPlus0x) 408 Diag(Tok, diag::ext_top_level_semi) 409 << CodeModificationHint::CreateRemoval(Tok.getLocation()); 410 411 ConsumeToken(); 412 // TODO: Invoke action for top-level semicolon. 413 return DeclGroupPtrTy(); 414 case tok::r_brace: 415 Diag(Tok, diag::err_expected_external_declaration); 416 ConsumeBrace(); 417 return DeclGroupPtrTy(); 418 case tok::eof: 419 Diag(Tok, diag::err_expected_external_declaration); 420 return DeclGroupPtrTy(); 421 case tok::kw___extension__: { 422 // __extension__ silences extension warnings in the subexpression. 423 ExtensionRAIIObject O(Diags); // Use RAII to do this. 424 ConsumeToken(); 425 return ParseExternalDeclaration(Attr); 426 } 427 case tok::kw_asm: { 428 if (Attr.HasAttr) 429 Diag(Attr.Range.getBegin(), diag::err_attributes_not_allowed) 430 << Attr.Range; 431 432 OwningExprResult Result(ParseSimpleAsm()); 433 434 ExpectAndConsume(tok::semi, diag::err_expected_semi_after, 435 "top-level asm block"); 436 437 if (Result.isInvalid()) 438 return DeclGroupPtrTy(); 439 SingleDecl = Actions.ActOnFileScopeAsmDecl(Tok.getLocation(), move(Result)); 440 break; 441 } 442 case tok::at: 443 // @ is not a legal token unless objc is enabled, no need to check for ObjC. 444 /// FIXME: ParseObjCAtDirectives should return a DeclGroup for things like 445 /// @class foo, bar; 446 SingleDecl = ParseObjCAtDirectives(); 447 break; 448 case tok::minus: 449 case tok::plus: 450 if (!getLang().ObjC1) { 451 Diag(Tok, diag::err_expected_external_declaration); 452 ConsumeToken(); 453 return DeclGroupPtrTy(); 454 } 455 SingleDecl = ParseObjCMethodDefinition(); 456 break; 457 case tok::code_completion: 458 Actions.CodeCompleteOrdinaryName(CurScope); 459 ConsumeToken(); 460 return ParseExternalDeclaration(Attr); 461 case tok::kw_using: 462 case tok::kw_namespace: 463 case tok::kw_typedef: 464 case tok::kw_template: 465 case tok::kw_export: // As in 'export template' 466 case tok::kw_static_assert: 467 // A function definition cannot start with a these keywords. 468 { 469 SourceLocation DeclEnd; 470 return ParseDeclaration(Declarator::FileContext, DeclEnd, Attr); 471 } 472 case tok::kw_extern: 473 if (getLang().CPlusPlus && NextToken().is(tok::kw_template)) { 474 // Extern templates 475 SourceLocation ExternLoc = ConsumeToken(); 476 SourceLocation TemplateLoc = ConsumeToken(); 477 SourceLocation DeclEnd; 478 return Actions.ConvertDeclToDeclGroup( 479 ParseExplicitInstantiation(ExternLoc, TemplateLoc, DeclEnd)); 480 } 481 482 // FIXME: Detect C++ linkage specifications here? 483 484 // Fall through to handle other declarations or function definitions. 485 486 default: 487 // We can't tell whether this is a function-definition or declaration yet. 488 return ParseDeclarationOrFunctionDefinition(Attr.AttrList); 489 } 490 491 // This routine returns a DeclGroup, if the thing we parsed only contains a 492 // single decl, convert it now. 493 return Actions.ConvertDeclToDeclGroup(SingleDecl); 494} 495 496/// \brief Determine whether the current token, if it occurs after a 497/// declarator, continues a declaration or declaration list. 498bool Parser::isDeclarationAfterDeclarator() { 499 return Tok.is(tok::equal) || // int X()= -> not a function def 500 Tok.is(tok::comma) || // int X(), -> not a function def 501 Tok.is(tok::semi) || // int X(); -> not a function def 502 Tok.is(tok::kw_asm) || // int X() __asm__ -> not a function def 503 Tok.is(tok::kw___attribute) || // int X() __attr__ -> not a function def 504 (getLang().CPlusPlus && 505 Tok.is(tok::l_paren)); // int X(0) -> not a function def [C++] 506} 507 508/// \brief Determine whether the current token, if it occurs after a 509/// declarator, indicates the start of a function definition. 510bool Parser::isStartOfFunctionDefinition() { 511 if (Tok.is(tok::l_brace)) // int X() {} 512 return true; 513 514 if (!getLang().CPlusPlus) 515 return isDeclarationSpecifier(); // int X(f) int f; {} 516 return Tok.is(tok::colon) || // X() : Base() {} (used for ctors) 517 Tok.is(tok::kw_try); // X() try { ... } 518} 519 520/// ParseDeclarationOrFunctionDefinition - Parse either a function-definition or 521/// a declaration. We can't tell which we have until we read up to the 522/// compound-statement in function-definition. TemplateParams, if 523/// non-NULL, provides the template parameters when we're parsing a 524/// C++ template-declaration. 525/// 526/// function-definition: [C99 6.9.1] 527/// decl-specs declarator declaration-list[opt] compound-statement 528/// [C90] function-definition: [C99 6.7.1] - implicit int result 529/// [C90] decl-specs[opt] declarator declaration-list[opt] compound-statement 530/// 531/// declaration: [C99 6.7] 532/// declaration-specifiers init-declarator-list[opt] ';' 533/// [!C99] init-declarator-list ';' [TODO: warn in c99 mode] 534/// [OMP] threadprivate-directive [TODO] 535/// 536Parser::DeclGroupPtrTy 537Parser::ParseDeclarationOrFunctionDefinition(ParsingDeclSpec &DS, 538 AttributeList *Attr, 539 AccessSpecifier AS) { 540 // Parse the common declaration-specifiers piece. 541 if (Attr) 542 DS.AddAttributes(Attr); 543 544 ParseDeclarationSpecifiers(DS, ParsedTemplateInfo(), AS); 545 546 // C99 6.7.2.3p6: Handle "struct-or-union identifier;", "enum { X };" 547 // declaration-specifiers init-declarator-list[opt] ';' 548 if (Tok.is(tok::semi)) { 549 ConsumeToken(); 550 DeclPtrTy TheDecl = Actions.ParsedFreeStandingDeclSpec(CurScope, DS); 551 DS.complete(TheDecl); 552 return Actions.ConvertDeclToDeclGroup(TheDecl); 553 } 554 555 // ObjC2 allows prefix attributes on class interfaces and protocols. 556 // FIXME: This still needs better diagnostics. We should only accept 557 // attributes here, no types, etc. 558 if (getLang().ObjC2 && Tok.is(tok::at)) { 559 SourceLocation AtLoc = ConsumeToken(); // the "@" 560 if (!Tok.isObjCAtKeyword(tok::objc_interface) && 561 !Tok.isObjCAtKeyword(tok::objc_protocol)) { 562 Diag(Tok, diag::err_objc_unexpected_attr); 563 SkipUntil(tok::semi); // FIXME: better skip? 564 return DeclGroupPtrTy(); 565 } 566 567 DS.abort(); 568 569 const char *PrevSpec = 0; 570 unsigned DiagID; 571 if (DS.SetTypeSpecType(DeclSpec::TST_unspecified, AtLoc, PrevSpec, DiagID)) 572 Diag(AtLoc, DiagID) << PrevSpec; 573 574 DeclPtrTy TheDecl; 575 if (Tok.isObjCAtKeyword(tok::objc_protocol)) 576 TheDecl = ParseObjCAtProtocolDeclaration(AtLoc, DS.getAttributes()); 577 else 578 TheDecl = ParseObjCAtInterfaceDeclaration(AtLoc, DS.getAttributes()); 579 return Actions.ConvertDeclToDeclGroup(TheDecl); 580 } 581 582 // If the declspec consisted only of 'extern' and we have a string 583 // literal following it, this must be a C++ linkage specifier like 584 // 'extern "C"'. 585 if (Tok.is(tok::string_literal) && getLang().CPlusPlus && 586 DS.getStorageClassSpec() == DeclSpec::SCS_extern && 587 DS.getParsedSpecifiers() == DeclSpec::PQ_StorageClassSpecifier) { 588 DS.abort(); 589 DeclPtrTy TheDecl = ParseLinkage(DS, Declarator::FileContext); 590 return Actions.ConvertDeclToDeclGroup(TheDecl); 591 } 592 593 return ParseDeclGroup(DS, Declarator::FileContext, true); 594} 595 596Parser::DeclGroupPtrTy 597Parser::ParseDeclarationOrFunctionDefinition(AttributeList *Attr, 598 AccessSpecifier AS) { 599 ParsingDeclSpec DS(*this); 600 return ParseDeclarationOrFunctionDefinition(DS, Attr, AS); 601} 602 603/// ParseFunctionDefinition - We parsed and verified that the specified 604/// Declarator is well formed. If this is a K&R-style function, read the 605/// parameters declaration-list, then start the compound-statement. 606/// 607/// function-definition: [C99 6.9.1] 608/// decl-specs declarator declaration-list[opt] compound-statement 609/// [C90] function-definition: [C99 6.7.1] - implicit int result 610/// [C90] decl-specs[opt] declarator declaration-list[opt] compound-statement 611/// [C++] function-definition: [C++ 8.4] 612/// decl-specifier-seq[opt] declarator ctor-initializer[opt] 613/// function-body 614/// [C++] function-definition: [C++ 8.4] 615/// decl-specifier-seq[opt] declarator function-try-block 616/// 617Parser::DeclPtrTy Parser::ParseFunctionDefinition(ParsingDeclarator &D, 618 const ParsedTemplateInfo &TemplateInfo) { 619 const DeclaratorChunk &FnTypeInfo = D.getTypeObject(0); 620 assert(FnTypeInfo.Kind == DeclaratorChunk::Function && 621 "This isn't a function declarator!"); 622 const DeclaratorChunk::FunctionTypeInfo &FTI = FnTypeInfo.Fun; 623 624 // If this is C90 and the declspecs were completely missing, fudge in an 625 // implicit int. We do this here because this is the only place where 626 // declaration-specifiers are completely optional in the grammar. 627 if (getLang().ImplicitInt && D.getDeclSpec().isEmpty()) { 628 const char *PrevSpec; 629 unsigned DiagID; 630 D.getMutableDeclSpec().SetTypeSpecType(DeclSpec::TST_int, 631 D.getIdentifierLoc(), 632 PrevSpec, DiagID); 633 D.SetRangeBegin(D.getDeclSpec().getSourceRange().getBegin()); 634 } 635 636 // If this declaration was formed with a K&R-style identifier list for the 637 // arguments, parse declarations for all of the args next. 638 // int foo(a,b) int a; float b; {} 639 if (!FTI.hasPrototype && FTI.NumArgs != 0) 640 ParseKNRParamDeclarations(D); 641 642 // We should have either an opening brace or, in a C++ constructor, 643 // we may have a colon. 644 if (Tok.isNot(tok::l_brace) && Tok.isNot(tok::colon) && 645 Tok.isNot(tok::kw_try)) { 646 Diag(Tok, diag::err_expected_fn_body); 647 648 // Skip over garbage, until we get to '{'. Don't eat the '{'. 649 SkipUntil(tok::l_brace, true, true); 650 651 // If we didn't find the '{', bail out. 652 if (Tok.isNot(tok::l_brace)) 653 return DeclPtrTy(); 654 } 655 656 // Enter a scope for the function body. 657 ParseScope BodyScope(this, Scope::FnScope|Scope::DeclScope); 658 659 // Tell the actions module that we have entered a function definition with the 660 // specified Declarator for the function. 661 DeclPtrTy Res = TemplateInfo.TemplateParams? 662 Actions.ActOnStartOfFunctionTemplateDef(CurScope, 663 Action::MultiTemplateParamsArg(Actions, 664 TemplateInfo.TemplateParams->data(), 665 TemplateInfo.TemplateParams->size()), 666 D) 667 : Actions.ActOnStartOfFunctionDef(CurScope, D); 668 669 // Break out of the ParsingDeclarator context before we parse the body. 670 D.complete(Res); 671 672 // Break out of the ParsingDeclSpec context, too. This const_cast is 673 // safe because we're always the sole owner. 674 D.getMutableDeclSpec().abort(); 675 676 if (Tok.is(tok::kw_try)) 677 return ParseFunctionTryBlock(Res); 678 679 // If we have a colon, then we're probably parsing a C++ 680 // ctor-initializer. 681 if (Tok.is(tok::colon)) 682 ParseConstructorInitializer(Res); 683 else 684 Actions.ActOnDefaultCtorInitializers(Res); 685 686 return ParseFunctionStatementBody(Res); 687} 688 689/// ParseKNRParamDeclarations - Parse 'declaration-list[opt]' which provides 690/// types for a function with a K&R-style identifier list for arguments. 691void Parser::ParseKNRParamDeclarations(Declarator &D) { 692 // We know that the top-level of this declarator is a function. 693 DeclaratorChunk::FunctionTypeInfo &FTI = D.getTypeObject(0).Fun; 694 695 // Enter function-declaration scope, limiting any declarators to the 696 // function prototype scope, including parameter declarators. 697 ParseScope PrototypeScope(this, Scope::FunctionPrototypeScope|Scope::DeclScope); 698 699 // Read all the argument declarations. 700 while (isDeclarationSpecifier()) { 701 SourceLocation DSStart = Tok.getLocation(); 702 703 // Parse the common declaration-specifiers piece. 704 DeclSpec DS; 705 ParseDeclarationSpecifiers(DS); 706 707 // C99 6.9.1p6: 'each declaration in the declaration list shall have at 708 // least one declarator'. 709 // NOTE: GCC just makes this an ext-warn. It's not clear what it does with 710 // the declarations though. It's trivial to ignore them, really hard to do 711 // anything else with them. 712 if (Tok.is(tok::semi)) { 713 Diag(DSStart, diag::err_declaration_does_not_declare_param); 714 ConsumeToken(); 715 continue; 716 } 717 718 // C99 6.9.1p6: Declarations shall contain no storage-class specifiers other 719 // than register. 720 if (DS.getStorageClassSpec() != DeclSpec::SCS_unspecified && 721 DS.getStorageClassSpec() != DeclSpec::SCS_register) { 722 Diag(DS.getStorageClassSpecLoc(), 723 diag::err_invalid_storage_class_in_func_decl); 724 DS.ClearStorageClassSpecs(); 725 } 726 if (DS.isThreadSpecified()) { 727 Diag(DS.getThreadSpecLoc(), 728 diag::err_invalid_storage_class_in_func_decl); 729 DS.ClearStorageClassSpecs(); 730 } 731 732 // Parse the first declarator attached to this declspec. 733 Declarator ParmDeclarator(DS, Declarator::KNRTypeListContext); 734 ParseDeclarator(ParmDeclarator); 735 736 // Handle the full declarator list. 737 while (1) { 738 Action::AttrTy *AttrList; 739 // If attributes are present, parse them. 740 if (Tok.is(tok::kw___attribute)) 741 // FIXME: attach attributes too. 742 AttrList = ParseGNUAttributes(); 743 744 // Ask the actions module to compute the type for this declarator. 745 Action::DeclPtrTy Param = 746 Actions.ActOnParamDeclarator(CurScope, ParmDeclarator); 747 748 if (Param && 749 // A missing identifier has already been diagnosed. 750 ParmDeclarator.getIdentifier()) { 751 752 // Scan the argument list looking for the correct param to apply this 753 // type. 754 for (unsigned i = 0; ; ++i) { 755 // C99 6.9.1p6: those declarators shall declare only identifiers from 756 // the identifier list. 757 if (i == FTI.NumArgs) { 758 Diag(ParmDeclarator.getIdentifierLoc(), diag::err_no_matching_param) 759 << ParmDeclarator.getIdentifier(); 760 break; 761 } 762 763 if (FTI.ArgInfo[i].Ident == ParmDeclarator.getIdentifier()) { 764 // Reject redefinitions of parameters. 765 if (FTI.ArgInfo[i].Param) { 766 Diag(ParmDeclarator.getIdentifierLoc(), 767 diag::err_param_redefinition) 768 << ParmDeclarator.getIdentifier(); 769 } else { 770 FTI.ArgInfo[i].Param = Param; 771 } 772 break; 773 } 774 } 775 } 776 777 // If we don't have a comma, it is either the end of the list (a ';') or 778 // an error, bail out. 779 if (Tok.isNot(tok::comma)) 780 break; 781 782 // Consume the comma. 783 ConsumeToken(); 784 785 // Parse the next declarator. 786 ParmDeclarator.clear(); 787 ParseDeclarator(ParmDeclarator); 788 } 789 790 if (Tok.is(tok::semi)) { 791 ConsumeToken(); 792 } else { 793 Diag(Tok, diag::err_parse_error); 794 // Skip to end of block or statement 795 SkipUntil(tok::semi, true); 796 if (Tok.is(tok::semi)) 797 ConsumeToken(); 798 } 799 } 800 801 // The actions module must verify that all arguments were declared. 802 Actions.ActOnFinishKNRParamDeclarations(CurScope, D, Tok.getLocation()); 803} 804 805 806/// ParseAsmStringLiteral - This is just a normal string-literal, but is not 807/// allowed to be a wide string, and is not subject to character translation. 808/// 809/// [GNU] asm-string-literal: 810/// string-literal 811/// 812Parser::OwningExprResult Parser::ParseAsmStringLiteral() { 813 if (!isTokenStringLiteral()) { 814 Diag(Tok, diag::err_expected_string_literal); 815 return ExprError(); 816 } 817 818 OwningExprResult Res(ParseStringLiteralExpression()); 819 if (Res.isInvalid()) return move(Res); 820 821 // TODO: Diagnose: wide string literal in 'asm' 822 823 return move(Res); 824} 825 826/// ParseSimpleAsm 827/// 828/// [GNU] simple-asm-expr: 829/// 'asm' '(' asm-string-literal ')' 830/// 831Parser::OwningExprResult Parser::ParseSimpleAsm(SourceLocation *EndLoc) { 832 assert(Tok.is(tok::kw_asm) && "Not an asm!"); 833 SourceLocation Loc = ConsumeToken(); 834 835 if (Tok.isNot(tok::l_paren)) { 836 Diag(Tok, diag::err_expected_lparen_after) << "asm"; 837 return ExprError(); 838 } 839 840 Loc = ConsumeParen(); 841 842 OwningExprResult Result(ParseAsmStringLiteral()); 843 844 if (Result.isInvalid()) { 845 SkipUntil(tok::r_paren, true, true); 846 if (EndLoc) 847 *EndLoc = Tok.getLocation(); 848 ConsumeAnyToken(); 849 } else { 850 Loc = MatchRHSPunctuation(tok::r_paren, Loc); 851 if (EndLoc) 852 *EndLoc = Loc; 853 } 854 855 return move(Result); 856} 857 858/// TryAnnotateTypeOrScopeToken - If the current token position is on a 859/// typename (possibly qualified in C++) or a C++ scope specifier not followed 860/// by a typename, TryAnnotateTypeOrScopeToken will replace one or more tokens 861/// with a single annotation token representing the typename or C++ scope 862/// respectively. 863/// This simplifies handling of C++ scope specifiers and allows efficient 864/// backtracking without the need to re-parse and resolve nested-names and 865/// typenames. 866/// It will mainly be called when we expect to treat identifiers as typenames 867/// (if they are typenames). For example, in C we do not expect identifiers 868/// inside expressions to be treated as typenames so it will not be called 869/// for expressions in C. 870/// The benefit for C/ObjC is that a typename will be annotated and 871/// Actions.getTypeName will not be needed to be called again (e.g. getTypeName 872/// will not be called twice, once to check whether we have a declaration 873/// specifier, and another one to get the actual type inside 874/// ParseDeclarationSpecifiers). 875/// 876/// This returns true if the token was annotated or an unrecoverable error 877/// occurs. 878/// 879/// Note that this routine emits an error if you call it with ::new or ::delete 880/// as the current tokens, so only call it in contexts where these are invalid. 881bool Parser::TryAnnotateTypeOrScopeToken(bool EnteringContext) { 882 assert((Tok.is(tok::identifier) || Tok.is(tok::coloncolon) 883 || Tok.is(tok::kw_typename)) && 884 "Cannot be a type or scope token!"); 885 886 if (Tok.is(tok::kw_typename)) { 887 // Parse a C++ typename-specifier, e.g., "typename T::type". 888 // 889 // typename-specifier: 890 // 'typename' '::' [opt] nested-name-specifier identifier 891 // 'typename' '::' [opt] nested-name-specifier template [opt] 892 // simple-template-id 893 SourceLocation TypenameLoc = ConsumeToken(); 894 CXXScopeSpec SS; 895 bool HadNestedNameSpecifier 896 = ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, false); 897 if (!HadNestedNameSpecifier) { 898 Diag(Tok.getLocation(), diag::err_expected_qualified_after_typename); 899 return false; 900 } 901 902 TypeResult Ty; 903 if (Tok.is(tok::identifier)) { 904 // FIXME: check whether the next token is '<', first! 905 Ty = Actions.ActOnTypenameType(TypenameLoc, SS, *Tok.getIdentifierInfo(), 906 Tok.getLocation()); 907 } else if (Tok.is(tok::annot_template_id)) { 908 TemplateIdAnnotation *TemplateId 909 = static_cast<TemplateIdAnnotation *>(Tok.getAnnotationValue()); 910 if (TemplateId->Kind == TNK_Function_template) { 911 Diag(Tok, diag::err_typename_refers_to_non_type_template) 912 << Tok.getAnnotationRange(); 913 return false; 914 } 915 916 AnnotateTemplateIdTokenAsType(0); 917 assert(Tok.is(tok::annot_typename) && 918 "AnnotateTemplateIdTokenAsType isn't working properly"); 919 if (Tok.getAnnotationValue()) 920 Ty = Actions.ActOnTypenameType(TypenameLoc, SS, SourceLocation(), 921 Tok.getAnnotationValue()); 922 else 923 Ty = true; 924 } else { 925 Diag(Tok, diag::err_expected_type_name_after_typename) 926 << SS.getRange(); 927 return false; 928 } 929 930 Tok.setKind(tok::annot_typename); 931 Tok.setAnnotationValue(Ty.isInvalid()? 0 : Ty.get()); 932 Tok.setAnnotationEndLoc(Tok.getLocation()); 933 Tok.setLocation(TypenameLoc); 934 PP.AnnotateCachedTokens(Tok); 935 return true; 936 } 937 938 CXXScopeSpec SS; 939 if (getLang().CPlusPlus) 940 ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, EnteringContext); 941 942 if (Tok.is(tok::identifier)) { 943 // Determine whether the identifier is a type name. 944 if (TypeTy *Ty = Actions.getTypeName(*Tok.getIdentifierInfo(), 945 Tok.getLocation(), CurScope, &SS)) { 946 // This is a typename. Replace the current token in-place with an 947 // annotation type token. 948 Tok.setKind(tok::annot_typename); 949 Tok.setAnnotationValue(Ty); 950 Tok.setAnnotationEndLoc(Tok.getLocation()); 951 if (SS.isNotEmpty()) // it was a C++ qualified type name. 952 Tok.setLocation(SS.getBeginLoc()); 953 954 // In case the tokens were cached, have Preprocessor replace 955 // them with the annotation token. 956 PP.AnnotateCachedTokens(Tok); 957 return true; 958 } 959 960 if (!getLang().CPlusPlus) { 961 // If we're in C, we can't have :: tokens at all (the lexer won't return 962 // them). If the identifier is not a type, then it can't be scope either, 963 // just early exit. 964 return false; 965 } 966 967 // If this is a template-id, annotate with a template-id or type token. 968 if (NextToken().is(tok::less)) { 969 TemplateTy Template; 970 UnqualifiedId TemplateName; 971 TemplateName.setIdentifier(Tok.getIdentifierInfo(), Tok.getLocation()); 972 if (TemplateNameKind TNK 973 = Actions.isTemplateName(CurScope, SS, TemplateName, 974 /*ObjectType=*/0, EnteringContext, 975 Template)) { 976 // Consume the identifier. 977 ConsumeToken(); 978 if (AnnotateTemplateIdToken(Template, TNK, &SS, TemplateName)) { 979 // If an unrecoverable error occurred, we need to return true here, 980 // because the token stream is in a damaged state. We may not return 981 // a valid identifier. 982 return Tok.isNot(tok::identifier); 983 } 984 } 985 } 986 987 // The current token, which is either an identifier or a 988 // template-id, is not part of the annotation. Fall through to 989 // push that token back into the stream and complete the C++ scope 990 // specifier annotation. 991 } 992 993 if (Tok.is(tok::annot_template_id)) { 994 TemplateIdAnnotation *TemplateId 995 = static_cast<TemplateIdAnnotation *>(Tok.getAnnotationValue()); 996 if (TemplateId->Kind == TNK_Type_template) { 997 // A template-id that refers to a type was parsed into a 998 // template-id annotation in a context where we weren't allowed 999 // to produce a type annotation token. Update the template-id 1000 // annotation token to a type annotation token now. 1001 AnnotateTemplateIdTokenAsType(&SS); 1002 return true; 1003 } 1004 } 1005 1006 if (SS.isEmpty()) 1007 return Tok.isNot(tok::identifier) && Tok.isNot(tok::coloncolon); 1008 1009 // A C++ scope specifier that isn't followed by a typename. 1010 // Push the current token back into the token stream (or revert it if it is 1011 // cached) and use an annotation scope token for current token. 1012 if (PP.isBacktrackEnabled()) 1013 PP.RevertCachedTokens(1); 1014 else 1015 PP.EnterToken(Tok); 1016 Tok.setKind(tok::annot_cxxscope); 1017 Tok.setAnnotationValue(SS.getScopeRep()); 1018 Tok.setAnnotationRange(SS.getRange()); 1019 1020 // In case the tokens were cached, have Preprocessor replace them with the 1021 // annotation token. 1022 PP.AnnotateCachedTokens(Tok); 1023 return true; 1024} 1025 1026/// TryAnnotateScopeToken - Like TryAnnotateTypeOrScopeToken but only 1027/// annotates C++ scope specifiers and template-ids. This returns 1028/// true if the token was annotated or there was an error that could not be 1029/// recovered from. 1030/// 1031/// Note that this routine emits an error if you call it with ::new or ::delete 1032/// as the current tokens, so only call it in contexts where these are invalid. 1033bool Parser::TryAnnotateCXXScopeToken(bool EnteringContext) { 1034 assert(getLang().CPlusPlus && 1035 "Call sites of this function should be guarded by checking for C++"); 1036 assert((Tok.is(tok::identifier) || Tok.is(tok::coloncolon)) && 1037 "Cannot be a type or scope token!"); 1038 1039 CXXScopeSpec SS; 1040 if (!ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, EnteringContext)) 1041 // If the token left behind is not an identifier, we either had an error or 1042 // successfully turned it into an annotation token. 1043 return Tok.isNot(tok::identifier); 1044 1045 // Push the current token back into the token stream (or revert it if it is 1046 // cached) and use an annotation scope token for current token. 1047 if (PP.isBacktrackEnabled()) 1048 PP.RevertCachedTokens(1); 1049 else 1050 PP.EnterToken(Tok); 1051 Tok.setKind(tok::annot_cxxscope); 1052 Tok.setAnnotationValue(SS.getScopeRep()); 1053 Tok.setAnnotationRange(SS.getRange()); 1054 1055 // In case the tokens were cached, have Preprocessor replace them with the 1056 // annotation token. 1057 PP.AnnotateCachedTokens(Tok); 1058 return true; 1059} 1060 1061// Anchor the Parser::FieldCallback vtable to this translation unit. 1062// We use a spurious method instead of the destructor because 1063// destroying FieldCallbacks can actually be slightly 1064// performance-sensitive. 1065void Parser::FieldCallback::_anchor() { 1066} 1067