1 //===--- UnwrappedLineParser.cpp - Format C++ code ------------------------===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 /// 9 /// \file 10 /// This file contains the implementation of the UnwrappedLineParser, 11 /// which turns a stream of tokens into UnwrappedLines. 12 /// 13 //===----------------------------------------------------------------------===// 14 15 #include "UnwrappedLineParser.h" 16 #include "llvm/ADT/STLExtras.h" 17 #include "llvm/Support/Debug.h" 18 #include "llvm/Support/raw_ostream.h" 19 20 #include <algorithm> 21 22 #define DEBUG_TYPE "format-parser" 23 24 namespace clang { 25 namespace format { 26 27 class FormatTokenSource { 28 public: 29 virtual ~FormatTokenSource() {} 30 virtual FormatToken *getNextToken() = 0; 31 32 virtual unsigned getPosition() = 0; 33 virtual FormatToken *setPosition(unsigned Position) = 0; 34 }; 35 36 namespace { 37 38 class ScopedDeclarationState { 39 public: 40 ScopedDeclarationState(UnwrappedLine &Line, std::vector<bool> &Stack, 41 bool MustBeDeclaration) 42 : Line(Line), Stack(Stack) { 43 Line.MustBeDeclaration = MustBeDeclaration; 44 Stack.push_back(MustBeDeclaration); 45 } 46 ~ScopedDeclarationState() { 47 Stack.pop_back(); 48 if (!Stack.empty()) 49 Line.MustBeDeclaration = Stack.back(); 50 else 51 Line.MustBeDeclaration = true; 52 } 53 54 private: 55 UnwrappedLine &Line; 56 std::vector<bool> &Stack; 57 }; 58 59 static bool isLineComment(const FormatToken &FormatTok) { 60 return FormatTok.is(tok::comment) && !FormatTok.TokenText.startswith("/*"); 61 } 62 63 // Checks if \p FormatTok is a line comment that continues the line comment 64 // \p Previous. The original column of \p MinColumnToken is used to determine 65 // whether \p FormatTok is indented enough to the right to continue \p Previous. 66 static bool continuesLineComment(const FormatToken &FormatTok, 67 const FormatToken *Previous, 68 const FormatToken *MinColumnToken) { 69 if (!Previous || !MinColumnToken) 70 return false; 71 unsigned MinContinueColumn = 72 MinColumnToken->OriginalColumn + (isLineComment(*MinColumnToken) ? 0 : 1); 73 return isLineComment(FormatTok) && FormatTok.NewlinesBefore == 1 && 74 isLineComment(*Previous) && 75 FormatTok.OriginalColumn >= MinContinueColumn; 76 } 77 78 class ScopedMacroState : public FormatTokenSource { 79 public: 80 ScopedMacroState(UnwrappedLine &Line, FormatTokenSource *&TokenSource, 81 FormatToken *&ResetToken) 82 : Line(Line), TokenSource(TokenSource), ResetToken(ResetToken), 83 PreviousLineLevel(Line.Level), PreviousTokenSource(TokenSource), 84 Token(nullptr), PreviousToken(nullptr) { 85 FakeEOF.Tok.startToken(); 86 FakeEOF.Tok.setKind(tok::eof); 87 TokenSource = this; 88 Line.Level = 0; 89 Line.InPPDirective = true; 90 } 91 92 ~ScopedMacroState() override { 93 TokenSource = PreviousTokenSource; 94 ResetToken = Token; 95 Line.InPPDirective = false; 96 Line.Level = PreviousLineLevel; 97 } 98 99 FormatToken *getNextToken() override { 100 // The \c UnwrappedLineParser guards against this by never calling 101 // \c getNextToken() after it has encountered the first eof token. 102 assert(!eof()); 103 PreviousToken = Token; 104 Token = PreviousTokenSource->getNextToken(); 105 if (eof()) 106 return &FakeEOF; 107 return Token; 108 } 109 110 unsigned getPosition() override { return PreviousTokenSource->getPosition(); } 111 112 FormatToken *setPosition(unsigned Position) override { 113 PreviousToken = nullptr; 114 Token = PreviousTokenSource->setPosition(Position); 115 return Token; 116 } 117 118 private: 119 bool eof() { 120 return Token && Token->HasUnescapedNewline && 121 !continuesLineComment(*Token, PreviousToken, 122 /*MinColumnToken=*/PreviousToken); 123 } 124 125 FormatToken FakeEOF; 126 UnwrappedLine &Line; 127 FormatTokenSource *&TokenSource; 128 FormatToken *&ResetToken; 129 unsigned PreviousLineLevel; 130 FormatTokenSource *PreviousTokenSource; 131 132 FormatToken *Token; 133 FormatToken *PreviousToken; 134 }; 135 136 } // end anonymous namespace 137 138 class ScopedLineState { 139 public: 140 ScopedLineState(UnwrappedLineParser &Parser, 141 bool SwitchToPreprocessorLines = false) 142 : Parser(Parser), OriginalLines(Parser.CurrentLines) { 143 if (SwitchToPreprocessorLines) 144 Parser.CurrentLines = &Parser.PreprocessorDirectives; 145 else if (!Parser.Line->Tokens.empty()) 146 Parser.CurrentLines = &Parser.Line->Tokens.back().Children; 147 PreBlockLine = std::move(Parser.Line); 148 Parser.Line = std::make_unique<UnwrappedLine>(); 149 Parser.Line->Level = PreBlockLine->Level; 150 Parser.Line->InPPDirective = PreBlockLine->InPPDirective; 151 } 152 153 ~ScopedLineState() { 154 if (!Parser.Line->Tokens.empty()) { 155 Parser.addUnwrappedLine(); 156 } 157 assert(Parser.Line->Tokens.empty()); 158 Parser.Line = std::move(PreBlockLine); 159 if (Parser.CurrentLines == &Parser.PreprocessorDirectives) 160 Parser.MustBreakBeforeNextToken = true; 161 Parser.CurrentLines = OriginalLines; 162 } 163 164 private: 165 UnwrappedLineParser &Parser; 166 167 std::unique_ptr<UnwrappedLine> PreBlockLine; 168 SmallVectorImpl<UnwrappedLine> *OriginalLines; 169 }; 170 171 class CompoundStatementIndenter { 172 public: 173 CompoundStatementIndenter(UnwrappedLineParser *Parser, 174 const FormatStyle &Style, unsigned &LineLevel) 175 : CompoundStatementIndenter(Parser, LineLevel, 176 Style.BraceWrapping.AfterControlStatement, 177 Style.BraceWrapping.IndentBraces) {} 178 CompoundStatementIndenter(UnwrappedLineParser *Parser, unsigned &LineLevel, 179 bool WrapBrace, bool IndentBrace) 180 : LineLevel(LineLevel), OldLineLevel(LineLevel) { 181 if (WrapBrace) 182 Parser->addUnwrappedLine(); 183 if (IndentBrace) 184 ++LineLevel; 185 } 186 ~CompoundStatementIndenter() { LineLevel = OldLineLevel; } 187 188 private: 189 unsigned &LineLevel; 190 unsigned OldLineLevel; 191 }; 192 193 namespace { 194 195 class IndexedTokenSource : public FormatTokenSource { 196 public: 197 IndexedTokenSource(ArrayRef<FormatToken *> Tokens) 198 : Tokens(Tokens), Position(-1) {} 199 200 FormatToken *getNextToken() override { 201 ++Position; 202 return Tokens[Position]; 203 } 204 205 unsigned getPosition() override { 206 assert(Position >= 0); 207 return Position; 208 } 209 210 FormatToken *setPosition(unsigned P) override { 211 Position = P; 212 return Tokens[Position]; 213 } 214 215 void reset() { Position = -1; } 216 217 private: 218 ArrayRef<FormatToken *> Tokens; 219 int Position; 220 }; 221 222 } // end anonymous namespace 223 224 UnwrappedLineParser::UnwrappedLineParser(const FormatStyle &Style, 225 const AdditionalKeywords &Keywords, 226 unsigned FirstStartColumn, 227 ArrayRef<FormatToken *> Tokens, 228 UnwrappedLineConsumer &Callback) 229 : Line(new UnwrappedLine), MustBreakBeforeNextToken(false), 230 CurrentLines(&Lines), Style(Style), Keywords(Keywords), 231 CommentPragmasRegex(Style.CommentPragmas), Tokens(nullptr), 232 Callback(Callback), AllTokens(Tokens), PPBranchLevel(-1), 233 IncludeGuard(Style.IndentPPDirectives == FormatStyle::PPDIS_None 234 ? IG_Rejected 235 : IG_Inited), 236 IncludeGuardToken(nullptr), FirstStartColumn(FirstStartColumn) {} 237 238 void UnwrappedLineParser::reset() { 239 PPBranchLevel = -1; 240 IncludeGuard = Style.IndentPPDirectives == FormatStyle::PPDIS_None 241 ? IG_Rejected 242 : IG_Inited; 243 IncludeGuardToken = nullptr; 244 Line.reset(new UnwrappedLine); 245 CommentsBeforeNextToken.clear(); 246 FormatTok = nullptr; 247 MustBreakBeforeNextToken = false; 248 PreprocessorDirectives.clear(); 249 CurrentLines = &Lines; 250 DeclarationScopeStack.clear(); 251 PPStack.clear(); 252 Line->FirstStartColumn = FirstStartColumn; 253 } 254 255 void UnwrappedLineParser::parse() { 256 IndexedTokenSource TokenSource(AllTokens); 257 Line->FirstStartColumn = FirstStartColumn; 258 do { 259 LLVM_DEBUG(llvm::dbgs() << "----\n"); 260 reset(); 261 Tokens = &TokenSource; 262 TokenSource.reset(); 263 264 readToken(); 265 parseFile(); 266 267 // If we found an include guard then all preprocessor directives (other than 268 // the guard) are over-indented by one. 269 if (IncludeGuard == IG_Found) 270 for (auto &Line : Lines) 271 if (Line.InPPDirective && Line.Level > 0) 272 --Line.Level; 273 274 // Create line with eof token. 275 pushToken(FormatTok); 276 addUnwrappedLine(); 277 278 for (SmallVectorImpl<UnwrappedLine>::iterator I = Lines.begin(), 279 E = Lines.end(); 280 I != E; ++I) { 281 Callback.consumeUnwrappedLine(*I); 282 } 283 Callback.finishRun(); 284 Lines.clear(); 285 while (!PPLevelBranchIndex.empty() && 286 PPLevelBranchIndex.back() + 1 >= PPLevelBranchCount.back()) { 287 PPLevelBranchIndex.resize(PPLevelBranchIndex.size() - 1); 288 PPLevelBranchCount.resize(PPLevelBranchCount.size() - 1); 289 } 290 if (!PPLevelBranchIndex.empty()) { 291 ++PPLevelBranchIndex.back(); 292 assert(PPLevelBranchIndex.size() == PPLevelBranchCount.size()); 293 assert(PPLevelBranchIndex.back() <= PPLevelBranchCount.back()); 294 } 295 } while (!PPLevelBranchIndex.empty()); 296 } 297 298 void UnwrappedLineParser::parseFile() { 299 // The top-level context in a file always has declarations, except for pre- 300 // processor directives and JavaScript files. 301 bool MustBeDeclaration = 302 !Line->InPPDirective && Style.Language != FormatStyle::LK_JavaScript; 303 ScopedDeclarationState DeclarationState(*Line, DeclarationScopeStack, 304 MustBeDeclaration); 305 if (Style.Language == FormatStyle::LK_TextProto) 306 parseBracedList(); 307 else 308 parseLevel(/*HasOpeningBrace=*/false); 309 // Make sure to format the remaining tokens. 310 // 311 // LK_TextProto is special since its top-level is parsed as the body of a 312 // braced list, which does not necessarily have natural line separators such 313 // as a semicolon. Comments after the last entry that have been determined to 314 // not belong to that line, as in: 315 // key: value 316 // // endfile comment 317 // do not have a chance to be put on a line of their own until this point. 318 // Here we add this newline before end-of-file comments. 319 if (Style.Language == FormatStyle::LK_TextProto && 320 !CommentsBeforeNextToken.empty()) 321 addUnwrappedLine(); 322 flushComments(true); 323 addUnwrappedLine(); 324 } 325 326 void UnwrappedLineParser::parseLevel(bool HasOpeningBrace) { 327 bool SwitchLabelEncountered = false; 328 do { 329 tok::TokenKind kind = FormatTok->Tok.getKind(); 330 if (FormatTok->Type == TT_MacroBlockBegin) { 331 kind = tok::l_brace; 332 } else if (FormatTok->Type == TT_MacroBlockEnd) { 333 kind = tok::r_brace; 334 } 335 336 switch (kind) { 337 case tok::comment: 338 nextToken(); 339 addUnwrappedLine(); 340 break; 341 case tok::l_brace: 342 // FIXME: Add parameter whether this can happen - if this happens, we must 343 // be in a non-declaration context. 344 if (!FormatTok->is(TT_MacroBlockBegin) && tryToParseBracedList()) 345 continue; 346 parseBlock(/*MustBeDeclaration=*/false); 347 addUnwrappedLine(); 348 break; 349 case tok::r_brace: 350 if (HasOpeningBrace) 351 return; 352 nextToken(); 353 addUnwrappedLine(); 354 break; 355 case tok::kw_default: { 356 unsigned StoredPosition = Tokens->getPosition(); 357 FormatToken *Next; 358 do { 359 Next = Tokens->getNextToken(); 360 } while (Next && Next->is(tok::comment)); 361 FormatTok = Tokens->setPosition(StoredPosition); 362 if (Next && Next->isNot(tok::colon)) { 363 // default not followed by ':' is not a case label; treat it like 364 // an identifier. 365 parseStructuralElement(); 366 break; 367 } 368 // Else, if it is 'default:', fall through to the case handling. 369 LLVM_FALLTHROUGH; 370 } 371 case tok::kw_case: 372 if (Style.Language == FormatStyle::LK_JavaScript && 373 Line->MustBeDeclaration) { 374 // A 'case: string' style field declaration. 375 parseStructuralElement(); 376 break; 377 } 378 if (!SwitchLabelEncountered && 379 (Style.IndentCaseLabels || (Line->InPPDirective && Line->Level == 1))) 380 ++Line->Level; 381 SwitchLabelEncountered = true; 382 parseStructuralElement(); 383 break; 384 default: 385 parseStructuralElement(); 386 break; 387 } 388 } while (!eof()); 389 } 390 391 void UnwrappedLineParser::calculateBraceTypes(bool ExpectClassBody) { 392 // We'll parse forward through the tokens until we hit 393 // a closing brace or eof - note that getNextToken() will 394 // parse macros, so this will magically work inside macro 395 // definitions, too. 396 unsigned StoredPosition = Tokens->getPosition(); 397 FormatToken *Tok = FormatTok; 398 const FormatToken *PrevTok = Tok->Previous; 399 // Keep a stack of positions of lbrace tokens. We will 400 // update information about whether an lbrace starts a 401 // braced init list or a different block during the loop. 402 SmallVector<FormatToken *, 8> LBraceStack; 403 assert(Tok->Tok.is(tok::l_brace)); 404 do { 405 // Get next non-comment token. 406 FormatToken *NextTok; 407 unsigned ReadTokens = 0; 408 do { 409 NextTok = Tokens->getNextToken(); 410 ++ReadTokens; 411 } while (NextTok->is(tok::comment)); 412 413 switch (Tok->Tok.getKind()) { 414 case tok::l_brace: 415 if (Style.Language == FormatStyle::LK_JavaScript && PrevTok) { 416 if (PrevTok->isOneOf(tok::colon, tok::less)) 417 // A ':' indicates this code is in a type, or a braced list 418 // following a label in an object literal ({a: {b: 1}}). 419 // A '<' could be an object used in a comparison, but that is nonsense 420 // code (can never return true), so more likely it is a generic type 421 // argument (`X<{a: string; b: number}>`). 422 // The code below could be confused by semicolons between the 423 // individual members in a type member list, which would normally 424 // trigger BK_Block. In both cases, this must be parsed as an inline 425 // braced init. 426 Tok->BlockKind = BK_BracedInit; 427 else if (PrevTok->is(tok::r_paren)) 428 // `) { }` can only occur in function or method declarations in JS. 429 Tok->BlockKind = BK_Block; 430 } else { 431 Tok->BlockKind = BK_Unknown; 432 } 433 LBraceStack.push_back(Tok); 434 break; 435 case tok::r_brace: 436 if (LBraceStack.empty()) 437 break; 438 if (LBraceStack.back()->BlockKind == BK_Unknown) { 439 bool ProbablyBracedList = false; 440 if (Style.Language == FormatStyle::LK_Proto) { 441 ProbablyBracedList = NextTok->isOneOf(tok::comma, tok::r_square); 442 } else { 443 // Using OriginalColumn to distinguish between ObjC methods and 444 // binary operators is a bit hacky. 445 bool NextIsObjCMethod = NextTok->isOneOf(tok::plus, tok::minus) && 446 NextTok->OriginalColumn == 0; 447 448 // If there is a comma, semicolon or right paren after the closing 449 // brace, we assume this is a braced initializer list. Note that 450 // regardless how we mark inner braces here, we will overwrite the 451 // BlockKind later if we parse a braced list (where all blocks 452 // inside are by default braced lists), or when we explicitly detect 453 // blocks (for example while parsing lambdas). 454 // FIXME: Some of these do not apply to JS, e.g. "} {" can never be a 455 // braced list in JS. 456 ProbablyBracedList = 457 (Style.Language == FormatStyle::LK_JavaScript && 458 NextTok->isOneOf(Keywords.kw_of, Keywords.kw_in, 459 Keywords.kw_as)) || 460 (Style.isCpp() && NextTok->is(tok::l_paren)) || 461 NextTok->isOneOf(tok::comma, tok::period, tok::colon, 462 tok::r_paren, tok::r_square, tok::l_brace, 463 tok::ellipsis) || 464 (NextTok->is(tok::identifier) && 465 !PrevTok->isOneOf(tok::semi, tok::r_brace, tok::l_brace)) || 466 (NextTok->is(tok::semi) && 467 (!ExpectClassBody || LBraceStack.size() != 1)) || 468 (NextTok->isBinaryOperator() && !NextIsObjCMethod); 469 if (NextTok->is(tok::l_square)) { 470 // We can have an array subscript after a braced init 471 // list, but C++11 attributes are expected after blocks. 472 NextTok = Tokens->getNextToken(); 473 ++ReadTokens; 474 ProbablyBracedList = NextTok->isNot(tok::l_square); 475 } 476 } 477 if (ProbablyBracedList) { 478 Tok->BlockKind = BK_BracedInit; 479 LBraceStack.back()->BlockKind = BK_BracedInit; 480 } else { 481 Tok->BlockKind = BK_Block; 482 LBraceStack.back()->BlockKind = BK_Block; 483 } 484 } 485 LBraceStack.pop_back(); 486 break; 487 case tok::identifier: 488 if (!Tok->is(TT_StatementMacro)) 489 break; 490 LLVM_FALLTHROUGH; 491 case tok::at: 492 case tok::semi: 493 case tok::kw_if: 494 case tok::kw_while: 495 case tok::kw_for: 496 case tok::kw_switch: 497 case tok::kw_try: 498 case tok::kw___try: 499 if (!LBraceStack.empty() && LBraceStack.back()->BlockKind == BK_Unknown) 500 LBraceStack.back()->BlockKind = BK_Block; 501 break; 502 default: 503 break; 504 } 505 PrevTok = Tok; 506 Tok = NextTok; 507 } while (Tok->Tok.isNot(tok::eof) && !LBraceStack.empty()); 508 509 // Assume other blocks for all unclosed opening braces. 510 for (unsigned i = 0, e = LBraceStack.size(); i != e; ++i) { 511 if (LBraceStack[i]->BlockKind == BK_Unknown) 512 LBraceStack[i]->BlockKind = BK_Block; 513 } 514 515 FormatTok = Tokens->setPosition(StoredPosition); 516 } 517 518 template <class T> 519 static inline void hash_combine(std::size_t &seed, const T &v) { 520 std::hash<T> hasher; 521 seed ^= hasher(v) + 0x9e3779b9 + (seed << 6) + (seed >> 2); 522 } 523 524 size_t UnwrappedLineParser::computePPHash() const { 525 size_t h = 0; 526 for (const auto &i : PPStack) { 527 hash_combine(h, size_t(i.Kind)); 528 hash_combine(h, i.Line); 529 } 530 return h; 531 } 532 533 void UnwrappedLineParser::parseBlock(bool MustBeDeclaration, bool AddLevel, 534 bool MunchSemi) { 535 assert(FormatTok->isOneOf(tok::l_brace, TT_MacroBlockBegin) && 536 "'{' or macro block token expected"); 537 const bool MacroBlock = FormatTok->is(TT_MacroBlockBegin); 538 FormatTok->BlockKind = BK_Block; 539 540 size_t PPStartHash = computePPHash(); 541 542 unsigned InitialLevel = Line->Level; 543 nextToken(/*LevelDifference=*/AddLevel ? 1 : 0); 544 545 if (MacroBlock && FormatTok->is(tok::l_paren)) 546 parseParens(); 547 548 size_t NbPreprocessorDirectives = 549 CurrentLines == &Lines ? PreprocessorDirectives.size() : 0; 550 addUnwrappedLine(); 551 size_t OpeningLineIndex = 552 CurrentLines->empty() 553 ? (UnwrappedLine::kInvalidIndex) 554 : (CurrentLines->size() - 1 - NbPreprocessorDirectives); 555 556 ScopedDeclarationState DeclarationState(*Line, DeclarationScopeStack, 557 MustBeDeclaration); 558 if (AddLevel) 559 ++Line->Level; 560 parseLevel(/*HasOpeningBrace=*/true); 561 562 if (eof()) 563 return; 564 565 if (MacroBlock ? !FormatTok->is(TT_MacroBlockEnd) 566 : !FormatTok->is(tok::r_brace)) { 567 Line->Level = InitialLevel; 568 FormatTok->BlockKind = BK_Block; 569 return; 570 } 571 572 size_t PPEndHash = computePPHash(); 573 574 // Munch the closing brace. 575 nextToken(/*LevelDifference=*/AddLevel ? -1 : 0); 576 577 if (MacroBlock && FormatTok->is(tok::l_paren)) 578 parseParens(); 579 580 if (MunchSemi && FormatTok->Tok.is(tok::semi)) 581 nextToken(); 582 Line->Level = InitialLevel; 583 584 if (PPStartHash == PPEndHash) { 585 Line->MatchingOpeningBlockLineIndex = OpeningLineIndex; 586 if (OpeningLineIndex != UnwrappedLine::kInvalidIndex) { 587 // Update the opening line to add the forward reference as well 588 (*CurrentLines)[OpeningLineIndex].MatchingClosingBlockLineIndex = 589 CurrentLines->size() - 1; 590 } 591 } 592 } 593 594 static bool isGoogScope(const UnwrappedLine &Line) { 595 // FIXME: Closure-library specific stuff should not be hard-coded but be 596 // configurable. 597 if (Line.Tokens.size() < 4) 598 return false; 599 auto I = Line.Tokens.begin(); 600 if (I->Tok->TokenText != "goog") 601 return false; 602 ++I; 603 if (I->Tok->isNot(tok::period)) 604 return false; 605 ++I; 606 if (I->Tok->TokenText != "scope") 607 return false; 608 ++I; 609 return I->Tok->is(tok::l_paren); 610 } 611 612 static bool isIIFE(const UnwrappedLine &Line, 613 const AdditionalKeywords &Keywords) { 614 // Look for the start of an immediately invoked anonymous function. 615 // https://en.wikipedia.org/wiki/Immediately-invoked_function_expression 616 // This is commonly done in JavaScript to create a new, anonymous scope. 617 // Example: (function() { ... })() 618 if (Line.Tokens.size() < 3) 619 return false; 620 auto I = Line.Tokens.begin(); 621 if (I->Tok->isNot(tok::l_paren)) 622 return false; 623 ++I; 624 if (I->Tok->isNot(Keywords.kw_function)) 625 return false; 626 ++I; 627 return I->Tok->is(tok::l_paren); 628 } 629 630 static bool ShouldBreakBeforeBrace(const FormatStyle &Style, 631 const FormatToken &InitialToken) { 632 if (InitialToken.isOneOf(tok::kw_namespace, TT_NamespaceMacro)) 633 return Style.BraceWrapping.AfterNamespace; 634 if (InitialToken.is(tok::kw_class)) 635 return Style.BraceWrapping.AfterClass; 636 if (InitialToken.is(tok::kw_union)) 637 return Style.BraceWrapping.AfterUnion; 638 if (InitialToken.is(tok::kw_struct)) 639 return Style.BraceWrapping.AfterStruct; 640 return false; 641 } 642 643 void UnwrappedLineParser::parseChildBlock() { 644 FormatTok->BlockKind = BK_Block; 645 nextToken(); 646 { 647 bool SkipIndent = (Style.Language == FormatStyle::LK_JavaScript && 648 (isGoogScope(*Line) || isIIFE(*Line, Keywords))); 649 ScopedLineState LineState(*this); 650 ScopedDeclarationState DeclarationState(*Line, DeclarationScopeStack, 651 /*MustBeDeclaration=*/false); 652 Line->Level += SkipIndent ? 0 : 1; 653 parseLevel(/*HasOpeningBrace=*/true); 654 flushComments(isOnNewLine(*FormatTok)); 655 Line->Level -= SkipIndent ? 0 : 1; 656 } 657 nextToken(); 658 } 659 660 void UnwrappedLineParser::parsePPDirective() { 661 assert(FormatTok->Tok.is(tok::hash) && "'#' expected"); 662 ScopedMacroState MacroState(*Line, Tokens, FormatTok); 663 664 nextToken(); 665 666 if (!FormatTok->Tok.getIdentifierInfo()) { 667 parsePPUnknown(); 668 return; 669 } 670 671 switch (FormatTok->Tok.getIdentifierInfo()->getPPKeywordID()) { 672 case tok::pp_define: 673 parsePPDefine(); 674 return; 675 case tok::pp_if: 676 parsePPIf(/*IfDef=*/false); 677 break; 678 case tok::pp_ifdef: 679 case tok::pp_ifndef: 680 parsePPIf(/*IfDef=*/true); 681 break; 682 case tok::pp_else: 683 parsePPElse(); 684 break; 685 case tok::pp_elif: 686 parsePPElIf(); 687 break; 688 case tok::pp_endif: 689 parsePPEndIf(); 690 break; 691 default: 692 parsePPUnknown(); 693 break; 694 } 695 } 696 697 void UnwrappedLineParser::conditionalCompilationCondition(bool Unreachable) { 698 size_t Line = CurrentLines->size(); 699 if (CurrentLines == &PreprocessorDirectives) 700 Line += Lines.size(); 701 702 if (Unreachable || 703 (!PPStack.empty() && PPStack.back().Kind == PP_Unreachable)) 704 PPStack.push_back({PP_Unreachable, Line}); 705 else 706 PPStack.push_back({PP_Conditional, Line}); 707 } 708 709 void UnwrappedLineParser::conditionalCompilationStart(bool Unreachable) { 710 ++PPBranchLevel; 711 assert(PPBranchLevel >= 0 && PPBranchLevel <= (int)PPLevelBranchIndex.size()); 712 if (PPBranchLevel == (int)PPLevelBranchIndex.size()) { 713 PPLevelBranchIndex.push_back(0); 714 PPLevelBranchCount.push_back(0); 715 } 716 PPChainBranchIndex.push(0); 717 bool Skip = PPLevelBranchIndex[PPBranchLevel] > 0; 718 conditionalCompilationCondition(Unreachable || Skip); 719 } 720 721 void UnwrappedLineParser::conditionalCompilationAlternative() { 722 if (!PPStack.empty()) 723 PPStack.pop_back(); 724 assert(PPBranchLevel < (int)PPLevelBranchIndex.size()); 725 if (!PPChainBranchIndex.empty()) 726 ++PPChainBranchIndex.top(); 727 conditionalCompilationCondition( 728 PPBranchLevel >= 0 && !PPChainBranchIndex.empty() && 729 PPLevelBranchIndex[PPBranchLevel] != PPChainBranchIndex.top()); 730 } 731 732 void UnwrappedLineParser::conditionalCompilationEnd() { 733 assert(PPBranchLevel < (int)PPLevelBranchIndex.size()); 734 if (PPBranchLevel >= 0 && !PPChainBranchIndex.empty()) { 735 if (PPChainBranchIndex.top() + 1 > PPLevelBranchCount[PPBranchLevel]) { 736 PPLevelBranchCount[PPBranchLevel] = PPChainBranchIndex.top() + 1; 737 } 738 } 739 // Guard against #endif's without #if. 740 if (PPBranchLevel > -1) 741 --PPBranchLevel; 742 if (!PPChainBranchIndex.empty()) 743 PPChainBranchIndex.pop(); 744 if (!PPStack.empty()) 745 PPStack.pop_back(); 746 } 747 748 void UnwrappedLineParser::parsePPIf(bool IfDef) { 749 bool IfNDef = FormatTok->is(tok::pp_ifndef); 750 nextToken(); 751 bool Unreachable = false; 752 if (!IfDef && (FormatTok->is(tok::kw_false) || FormatTok->TokenText == "0")) 753 Unreachable = true; 754 if (IfDef && !IfNDef && FormatTok->TokenText == "SWIG") 755 Unreachable = true; 756 conditionalCompilationStart(Unreachable); 757 FormatToken *IfCondition = FormatTok; 758 // If there's a #ifndef on the first line, and the only lines before it are 759 // comments, it could be an include guard. 760 bool MaybeIncludeGuard = IfNDef; 761 if (IncludeGuard == IG_Inited && MaybeIncludeGuard) 762 for (auto &Line : Lines) { 763 if (!Line.Tokens.front().Tok->is(tok::comment)) { 764 MaybeIncludeGuard = false; 765 IncludeGuard = IG_Rejected; 766 break; 767 } 768 } 769 --PPBranchLevel; 770 parsePPUnknown(); 771 ++PPBranchLevel; 772 if (IncludeGuard == IG_Inited && MaybeIncludeGuard) { 773 IncludeGuard = IG_IfNdefed; 774 IncludeGuardToken = IfCondition; 775 } 776 } 777 778 void UnwrappedLineParser::parsePPElse() { 779 // If a potential include guard has an #else, it's not an include guard. 780 if (IncludeGuard == IG_Defined && PPBranchLevel == 0) 781 IncludeGuard = IG_Rejected; 782 conditionalCompilationAlternative(); 783 if (PPBranchLevel > -1) 784 --PPBranchLevel; 785 parsePPUnknown(); 786 ++PPBranchLevel; 787 } 788 789 void UnwrappedLineParser::parsePPElIf() { parsePPElse(); } 790 791 void UnwrappedLineParser::parsePPEndIf() { 792 conditionalCompilationEnd(); 793 parsePPUnknown(); 794 // If the #endif of a potential include guard is the last thing in the file, 795 // then we found an include guard. 796 unsigned TokenPosition = Tokens->getPosition(); 797 FormatToken *PeekNext = AllTokens[TokenPosition]; 798 if (IncludeGuard == IG_Defined && PPBranchLevel == -1 && 799 PeekNext->is(tok::eof) && 800 Style.IndentPPDirectives != FormatStyle::PPDIS_None) 801 IncludeGuard = IG_Found; 802 } 803 804 void UnwrappedLineParser::parsePPDefine() { 805 nextToken(); 806 807 if (!FormatTok->Tok.getIdentifierInfo()) { 808 IncludeGuard = IG_Rejected; 809 IncludeGuardToken = nullptr; 810 parsePPUnknown(); 811 return; 812 } 813 814 if (IncludeGuard == IG_IfNdefed && 815 IncludeGuardToken->TokenText == FormatTok->TokenText) { 816 IncludeGuard = IG_Defined; 817 IncludeGuardToken = nullptr; 818 for (auto &Line : Lines) { 819 if (!Line.Tokens.front().Tok->isOneOf(tok::comment, tok::hash)) { 820 IncludeGuard = IG_Rejected; 821 break; 822 } 823 } 824 } 825 826 nextToken(); 827 if (FormatTok->Tok.getKind() == tok::l_paren && 828 FormatTok->WhitespaceRange.getBegin() == 829 FormatTok->WhitespaceRange.getEnd()) { 830 parseParens(); 831 } 832 if (Style.IndentPPDirectives != FormatStyle::PPDIS_None) 833 Line->Level += PPBranchLevel + 1; 834 addUnwrappedLine(); 835 ++Line->Level; 836 837 // Errors during a preprocessor directive can only affect the layout of the 838 // preprocessor directive, and thus we ignore them. An alternative approach 839 // would be to use the same approach we use on the file level (no 840 // re-indentation if there was a structural error) within the macro 841 // definition. 842 parseFile(); 843 } 844 845 void UnwrappedLineParser::parsePPUnknown() { 846 do { 847 nextToken(); 848 } while (!eof()); 849 if (Style.IndentPPDirectives != FormatStyle::PPDIS_None) 850 Line->Level += PPBranchLevel + 1; 851 addUnwrappedLine(); 852 } 853 854 // Here we blacklist certain tokens that are not usually the first token in an 855 // unwrapped line. This is used in attempt to distinguish macro calls without 856 // trailing semicolons from other constructs split to several lines. 857 static bool tokenCanStartNewLine(const clang::Token &Tok) { 858 // Semicolon can be a null-statement, l_square can be a start of a macro or 859 // a C++11 attribute, but this doesn't seem to be common. 860 return Tok.isNot(tok::semi) && Tok.isNot(tok::l_brace) && 861 Tok.isNot(tok::l_square) && 862 // Tokens that can only be used as binary operators and a part of 863 // overloaded operator names. 864 Tok.isNot(tok::period) && Tok.isNot(tok::periodstar) && 865 Tok.isNot(tok::arrow) && Tok.isNot(tok::arrowstar) && 866 Tok.isNot(tok::less) && Tok.isNot(tok::greater) && 867 Tok.isNot(tok::slash) && Tok.isNot(tok::percent) && 868 Tok.isNot(tok::lessless) && Tok.isNot(tok::greatergreater) && 869 Tok.isNot(tok::equal) && Tok.isNot(tok::plusequal) && 870 Tok.isNot(tok::minusequal) && Tok.isNot(tok::starequal) && 871 Tok.isNot(tok::slashequal) && Tok.isNot(tok::percentequal) && 872 Tok.isNot(tok::ampequal) && Tok.isNot(tok::pipeequal) && 873 Tok.isNot(tok::caretequal) && Tok.isNot(tok::greatergreaterequal) && 874 Tok.isNot(tok::lesslessequal) && 875 // Colon is used in labels, base class lists, initializer lists, 876 // range-based for loops, ternary operator, but should never be the 877 // first token in an unwrapped line. 878 Tok.isNot(tok::colon) && 879 // 'noexcept' is a trailing annotation. 880 Tok.isNot(tok::kw_noexcept); 881 } 882 883 static bool mustBeJSIdent(const AdditionalKeywords &Keywords, 884 const FormatToken *FormatTok) { 885 // FIXME: This returns true for C/C++ keywords like 'struct'. 886 return FormatTok->is(tok::identifier) && 887 (FormatTok->Tok.getIdentifierInfo() == nullptr || 888 !FormatTok->isOneOf( 889 Keywords.kw_in, Keywords.kw_of, Keywords.kw_as, Keywords.kw_async, 890 Keywords.kw_await, Keywords.kw_yield, Keywords.kw_finally, 891 Keywords.kw_function, Keywords.kw_import, Keywords.kw_is, 892 Keywords.kw_let, Keywords.kw_var, tok::kw_const, 893 Keywords.kw_abstract, Keywords.kw_extends, Keywords.kw_implements, 894 Keywords.kw_instanceof, Keywords.kw_interface, Keywords.kw_throws, 895 Keywords.kw_from)); 896 } 897 898 static bool mustBeJSIdentOrValue(const AdditionalKeywords &Keywords, 899 const FormatToken *FormatTok) { 900 return FormatTok->Tok.isLiteral() || 901 FormatTok->isOneOf(tok::kw_true, tok::kw_false) || 902 mustBeJSIdent(Keywords, FormatTok); 903 } 904 905 // isJSDeclOrStmt returns true if |FormatTok| starts a declaration or statement 906 // when encountered after a value (see mustBeJSIdentOrValue). 907 static bool isJSDeclOrStmt(const AdditionalKeywords &Keywords, 908 const FormatToken *FormatTok) { 909 return FormatTok->isOneOf( 910 tok::kw_return, Keywords.kw_yield, 911 // conditionals 912 tok::kw_if, tok::kw_else, 913 // loops 914 tok::kw_for, tok::kw_while, tok::kw_do, tok::kw_continue, tok::kw_break, 915 // switch/case 916 tok::kw_switch, tok::kw_case, 917 // exceptions 918 tok::kw_throw, tok::kw_try, tok::kw_catch, Keywords.kw_finally, 919 // declaration 920 tok::kw_const, tok::kw_class, Keywords.kw_var, Keywords.kw_let, 921 Keywords.kw_async, Keywords.kw_function, 922 // import/export 923 Keywords.kw_import, tok::kw_export); 924 } 925 926 // readTokenWithJavaScriptASI reads the next token and terminates the current 927 // line if JavaScript Automatic Semicolon Insertion must 928 // happen between the current token and the next token. 929 // 930 // This method is conservative - it cannot cover all edge cases of JavaScript, 931 // but only aims to correctly handle certain well known cases. It *must not* 932 // return true in speculative cases. 933 void UnwrappedLineParser::readTokenWithJavaScriptASI() { 934 FormatToken *Previous = FormatTok; 935 readToken(); 936 FormatToken *Next = FormatTok; 937 938 bool IsOnSameLine = 939 CommentsBeforeNextToken.empty() 940 ? Next->NewlinesBefore == 0 941 : CommentsBeforeNextToken.front()->NewlinesBefore == 0; 942 if (IsOnSameLine) 943 return; 944 945 bool PreviousMustBeValue = mustBeJSIdentOrValue(Keywords, Previous); 946 bool PreviousStartsTemplateExpr = 947 Previous->is(TT_TemplateString) && Previous->TokenText.endswith("${"); 948 if (PreviousMustBeValue || Previous->is(tok::r_paren)) { 949 // If the line contains an '@' sign, the previous token might be an 950 // annotation, which can precede another identifier/value. 951 bool HasAt = std::find_if(Line->Tokens.begin(), Line->Tokens.end(), 952 [](UnwrappedLineNode &LineNode) { 953 return LineNode.Tok->is(tok::at); 954 }) != Line->Tokens.end(); 955 if (HasAt) 956 return; 957 } 958 if (Next->is(tok::exclaim) && PreviousMustBeValue) 959 return addUnwrappedLine(); 960 bool NextMustBeValue = mustBeJSIdentOrValue(Keywords, Next); 961 bool NextEndsTemplateExpr = 962 Next->is(TT_TemplateString) && Next->TokenText.startswith("}"); 963 if (NextMustBeValue && !NextEndsTemplateExpr && !PreviousStartsTemplateExpr && 964 (PreviousMustBeValue || 965 Previous->isOneOf(tok::r_square, tok::r_paren, tok::plusplus, 966 tok::minusminus))) 967 return addUnwrappedLine(); 968 if ((PreviousMustBeValue || Previous->is(tok::r_paren)) && 969 isJSDeclOrStmt(Keywords, Next)) 970 return addUnwrappedLine(); 971 } 972 973 void UnwrappedLineParser::parseStructuralElement() { 974 assert(!FormatTok->is(tok::l_brace)); 975 if (Style.Language == FormatStyle::LK_TableGen && 976 FormatTok->is(tok::pp_include)) { 977 nextToken(); 978 if (FormatTok->is(tok::string_literal)) 979 nextToken(); 980 addUnwrappedLine(); 981 return; 982 } 983 switch (FormatTok->Tok.getKind()) { 984 case tok::kw_asm: 985 nextToken(); 986 if (FormatTok->is(tok::l_brace)) { 987 FormatTok->Type = TT_InlineASMBrace; 988 nextToken(); 989 while (FormatTok && FormatTok->isNot(tok::eof)) { 990 if (FormatTok->is(tok::r_brace)) { 991 FormatTok->Type = TT_InlineASMBrace; 992 nextToken(); 993 addUnwrappedLine(); 994 break; 995 } 996 FormatTok->Finalized = true; 997 nextToken(); 998 } 999 } 1000 break; 1001 case tok::kw_namespace: 1002 parseNamespace(); 1003 return; 1004 case tok::kw_public: 1005 case tok::kw_protected: 1006 case tok::kw_private: 1007 if (Style.Language == FormatStyle::LK_Java || 1008 Style.Language == FormatStyle::LK_JavaScript || Style.isCSharp()) 1009 nextToken(); 1010 else 1011 parseAccessSpecifier(); 1012 return; 1013 case tok::kw_if: 1014 parseIfThenElse(); 1015 return; 1016 case tok::kw_for: 1017 case tok::kw_while: 1018 parseForOrWhileLoop(); 1019 return; 1020 case tok::kw_do: 1021 parseDoWhile(); 1022 return; 1023 case tok::kw_switch: 1024 if (Style.Language == FormatStyle::LK_JavaScript && Line->MustBeDeclaration) 1025 // 'switch: string' field declaration. 1026 break; 1027 parseSwitch(); 1028 return; 1029 case tok::kw_default: 1030 if (Style.Language == FormatStyle::LK_JavaScript && Line->MustBeDeclaration) 1031 // 'default: string' field declaration. 1032 break; 1033 nextToken(); 1034 if (FormatTok->is(tok::colon)) { 1035 parseLabel(); 1036 return; 1037 } 1038 // e.g. "default void f() {}" in a Java interface. 1039 break; 1040 case tok::kw_case: 1041 if (Style.Language == FormatStyle::LK_JavaScript && Line->MustBeDeclaration) 1042 // 'case: string' field declaration. 1043 break; 1044 parseCaseLabel(); 1045 return; 1046 case tok::kw_try: 1047 case tok::kw___try: 1048 parseTryCatch(); 1049 return; 1050 case tok::kw_extern: 1051 nextToken(); 1052 if (FormatTok->Tok.is(tok::string_literal)) { 1053 nextToken(); 1054 if (FormatTok->Tok.is(tok::l_brace)) { 1055 if (Style.BraceWrapping.AfterExternBlock) { 1056 addUnwrappedLine(); 1057 parseBlock(/*MustBeDeclaration=*/true); 1058 } else { 1059 parseBlock(/*MustBeDeclaration=*/true, /*AddLevel=*/false); 1060 } 1061 addUnwrappedLine(); 1062 return; 1063 } 1064 } 1065 break; 1066 case tok::kw_export: 1067 if (Style.Language == FormatStyle::LK_JavaScript) { 1068 parseJavaScriptEs6ImportExport(); 1069 return; 1070 } 1071 if (!Style.isCpp()) 1072 break; 1073 // Handle C++ "(inline|export) namespace". 1074 LLVM_FALLTHROUGH; 1075 case tok::kw_inline: 1076 nextToken(); 1077 if (FormatTok->Tok.is(tok::kw_namespace)) { 1078 parseNamespace(); 1079 return; 1080 } 1081 break; 1082 case tok::identifier: 1083 if (FormatTok->is(TT_ForEachMacro)) { 1084 parseForOrWhileLoop(); 1085 return; 1086 } 1087 if (FormatTok->is(TT_MacroBlockBegin)) { 1088 parseBlock(/*MustBeDeclaration=*/false, /*AddLevel=*/true, 1089 /*MunchSemi=*/false); 1090 return; 1091 } 1092 if (FormatTok->is(Keywords.kw_import)) { 1093 if (Style.Language == FormatStyle::LK_JavaScript) { 1094 parseJavaScriptEs6ImportExport(); 1095 return; 1096 } 1097 if (Style.Language == FormatStyle::LK_Proto) { 1098 nextToken(); 1099 if (FormatTok->is(tok::kw_public)) 1100 nextToken(); 1101 if (!FormatTok->is(tok::string_literal)) 1102 return; 1103 nextToken(); 1104 if (FormatTok->is(tok::semi)) 1105 nextToken(); 1106 addUnwrappedLine(); 1107 return; 1108 } 1109 } 1110 if (Style.isCpp() && 1111 FormatTok->isOneOf(Keywords.kw_signals, Keywords.kw_qsignals, 1112 Keywords.kw_slots, Keywords.kw_qslots)) { 1113 nextToken(); 1114 if (FormatTok->is(tok::colon)) { 1115 nextToken(); 1116 addUnwrappedLine(); 1117 return; 1118 } 1119 } 1120 if (Style.isCpp() && FormatTok->is(TT_StatementMacro)) { 1121 parseStatementMacro(); 1122 return; 1123 } 1124 if (Style.isCpp() && FormatTok->is(TT_NamespaceMacro)) { 1125 parseNamespace(); 1126 return; 1127 } 1128 // In all other cases, parse the declaration. 1129 break; 1130 default: 1131 break; 1132 } 1133 do { 1134 const FormatToken *Previous = FormatTok->Previous; 1135 switch (FormatTok->Tok.getKind()) { 1136 case tok::at: 1137 nextToken(); 1138 if (FormatTok->Tok.is(tok::l_brace)) { 1139 nextToken(); 1140 parseBracedList(); 1141 break; 1142 } else if (Style.Language == FormatStyle::LK_Java && 1143 FormatTok->is(Keywords.kw_interface)) { 1144 nextToken(); 1145 break; 1146 } 1147 switch (FormatTok->Tok.getObjCKeywordID()) { 1148 case tok::objc_public: 1149 case tok::objc_protected: 1150 case tok::objc_package: 1151 case tok::objc_private: 1152 return parseAccessSpecifier(); 1153 case tok::objc_interface: 1154 case tok::objc_implementation: 1155 return parseObjCInterfaceOrImplementation(); 1156 case tok::objc_protocol: 1157 if (parseObjCProtocol()) 1158 return; 1159 break; 1160 case tok::objc_end: 1161 return; // Handled by the caller. 1162 case tok::objc_optional: 1163 case tok::objc_required: 1164 nextToken(); 1165 addUnwrappedLine(); 1166 return; 1167 case tok::objc_autoreleasepool: 1168 nextToken(); 1169 if (FormatTok->Tok.is(tok::l_brace)) { 1170 if (Style.BraceWrapping.AfterControlStatement) 1171 addUnwrappedLine(); 1172 parseBlock(/*MustBeDeclaration=*/false); 1173 } 1174 addUnwrappedLine(); 1175 return; 1176 case tok::objc_synchronized: 1177 nextToken(); 1178 if (FormatTok->Tok.is(tok::l_paren)) 1179 // Skip synchronization object 1180 parseParens(); 1181 if (FormatTok->Tok.is(tok::l_brace)) { 1182 if (Style.BraceWrapping.AfterControlStatement) 1183 addUnwrappedLine(); 1184 parseBlock(/*MustBeDeclaration=*/false); 1185 } 1186 addUnwrappedLine(); 1187 return; 1188 case tok::objc_try: 1189 // This branch isn't strictly necessary (the kw_try case below would 1190 // do this too after the tok::at is parsed above). But be explicit. 1191 parseTryCatch(); 1192 return; 1193 default: 1194 break; 1195 } 1196 break; 1197 case tok::kw_enum: 1198 // Ignore if this is part of "template <enum ...". 1199 if (Previous && Previous->is(tok::less)) { 1200 nextToken(); 1201 break; 1202 } 1203 1204 // parseEnum falls through and does not yet add an unwrapped line as an 1205 // enum definition can start a structural element. 1206 if (!parseEnum()) 1207 break; 1208 // This only applies for C++. 1209 if (!Style.isCpp()) { 1210 addUnwrappedLine(); 1211 return; 1212 } 1213 break; 1214 case tok::kw_typedef: 1215 nextToken(); 1216 if (FormatTok->isOneOf(Keywords.kw_NS_ENUM, Keywords.kw_NS_OPTIONS, 1217 Keywords.kw_CF_ENUM, Keywords.kw_CF_OPTIONS, 1218 Keywords.kw_CF_CLOSED_ENUM, 1219 Keywords.kw_NS_CLOSED_ENUM)) 1220 parseEnum(); 1221 break; 1222 case tok::kw_struct: 1223 case tok::kw_union: 1224 case tok::kw_class: 1225 // parseRecord falls through and does not yet add an unwrapped line as a 1226 // record declaration or definition can start a structural element. 1227 parseRecord(); 1228 // This does not apply for Java, JavaScript and C#. 1229 if (Style.Language == FormatStyle::LK_Java || 1230 Style.Language == FormatStyle::LK_JavaScript || Style.isCSharp()) { 1231 if (FormatTok->is(tok::semi)) 1232 nextToken(); 1233 addUnwrappedLine(); 1234 return; 1235 } 1236 break; 1237 case tok::period: 1238 nextToken(); 1239 // In Java, classes have an implicit static member "class". 1240 if (Style.Language == FormatStyle::LK_Java && FormatTok && 1241 FormatTok->is(tok::kw_class)) 1242 nextToken(); 1243 if (Style.Language == FormatStyle::LK_JavaScript && FormatTok && 1244 FormatTok->Tok.getIdentifierInfo()) 1245 // JavaScript only has pseudo keywords, all keywords are allowed to 1246 // appear in "IdentifierName" positions. See http://es5.github.io/#x7.6 1247 nextToken(); 1248 break; 1249 case tok::semi: 1250 nextToken(); 1251 addUnwrappedLine(); 1252 return; 1253 case tok::r_brace: 1254 addUnwrappedLine(); 1255 return; 1256 case tok::l_paren: 1257 parseParens(); 1258 break; 1259 case tok::kw_operator: 1260 nextToken(); 1261 if (FormatTok->isBinaryOperator()) 1262 nextToken(); 1263 break; 1264 case tok::caret: 1265 nextToken(); 1266 if (FormatTok->Tok.isAnyIdentifier() || 1267 FormatTok->isSimpleTypeSpecifier()) 1268 nextToken(); 1269 if (FormatTok->is(tok::l_paren)) 1270 parseParens(); 1271 if (FormatTok->is(tok::l_brace)) 1272 parseChildBlock(); 1273 break; 1274 case tok::l_brace: 1275 if (!tryToParseBracedList()) { 1276 // A block outside of parentheses must be the last part of a 1277 // structural element. 1278 // FIXME: Figure out cases where this is not true, and add projections 1279 // for them (the one we know is missing are lambdas). 1280 if (Style.BraceWrapping.AfterFunction) 1281 addUnwrappedLine(); 1282 FormatTok->Type = TT_FunctionLBrace; 1283 parseBlock(/*MustBeDeclaration=*/false); 1284 addUnwrappedLine(); 1285 return; 1286 } 1287 // Otherwise this was a braced init list, and the structural 1288 // element continues. 1289 break; 1290 case tok::kw_try: 1291 // We arrive here when parsing function-try blocks. 1292 if (Style.BraceWrapping.AfterFunction) 1293 addUnwrappedLine(); 1294 parseTryCatch(); 1295 return; 1296 case tok::identifier: { 1297 if (FormatTok->is(TT_MacroBlockEnd)) { 1298 addUnwrappedLine(); 1299 return; 1300 } 1301 1302 // Function declarations (as opposed to function expressions) are parsed 1303 // on their own unwrapped line by continuing this loop. Function 1304 // expressions (functions that are not on their own line) must not create 1305 // a new unwrapped line, so they are special cased below. 1306 size_t TokenCount = Line->Tokens.size(); 1307 if (Style.Language == FormatStyle::LK_JavaScript && 1308 FormatTok->is(Keywords.kw_function) && 1309 (TokenCount > 1 || (TokenCount == 1 && !Line->Tokens.front().Tok->is( 1310 Keywords.kw_async)))) { 1311 tryToParseJSFunction(); 1312 break; 1313 } 1314 if ((Style.Language == FormatStyle::LK_JavaScript || 1315 Style.Language == FormatStyle::LK_Java) && 1316 FormatTok->is(Keywords.kw_interface)) { 1317 if (Style.Language == FormatStyle::LK_JavaScript) { 1318 // In JavaScript/TypeScript, "interface" can be used as a standalone 1319 // identifier, e.g. in `var interface = 1;`. If "interface" is 1320 // followed by another identifier, it is very like to be an actual 1321 // interface declaration. 1322 unsigned StoredPosition = Tokens->getPosition(); 1323 FormatToken *Next = Tokens->getNextToken(); 1324 FormatTok = Tokens->setPosition(StoredPosition); 1325 if (Next && !mustBeJSIdent(Keywords, Next)) { 1326 nextToken(); 1327 break; 1328 } 1329 } 1330 parseRecord(); 1331 addUnwrappedLine(); 1332 return; 1333 } 1334 1335 if (Style.isCpp() && FormatTok->is(TT_StatementMacro)) { 1336 parseStatementMacro(); 1337 return; 1338 } 1339 1340 // See if the following token should start a new unwrapped line. 1341 StringRef Text = FormatTok->TokenText; 1342 nextToken(); 1343 1344 // JS doesn't have macros, and within classes colons indicate fields, not 1345 // labels. 1346 if (Style.Language == FormatStyle::LK_JavaScript) 1347 break; 1348 1349 TokenCount = Line->Tokens.size(); 1350 if (TokenCount == 1 || 1351 (TokenCount == 2 && Line->Tokens.front().Tok->is(tok::comment))) { 1352 if (FormatTok->Tok.is(tok::colon) && !Line->MustBeDeclaration) { 1353 Line->Tokens.begin()->Tok->MustBreakBefore = true; 1354 parseLabel(!Style.IndentGotoLabels); 1355 return; 1356 } 1357 // Recognize function-like macro usages without trailing semicolon as 1358 // well as free-standing macros like Q_OBJECT. 1359 bool FunctionLike = FormatTok->is(tok::l_paren); 1360 if (FunctionLike) 1361 parseParens(); 1362 1363 bool FollowedByNewline = 1364 CommentsBeforeNextToken.empty() 1365 ? FormatTok->NewlinesBefore > 0 1366 : CommentsBeforeNextToken.front()->NewlinesBefore > 0; 1367 1368 if (FollowedByNewline && (Text.size() >= 5 || FunctionLike) && 1369 tokenCanStartNewLine(FormatTok->Tok) && Text == Text.upper()) { 1370 addUnwrappedLine(); 1371 return; 1372 } 1373 } 1374 break; 1375 } 1376 case tok::equal: 1377 // Fat arrows (=>) have tok::TokenKind tok::equal but TokenType 1378 // TT_JsFatArrow. The always start an expression or a child block if 1379 // followed by a curly. 1380 if (FormatTok->is(TT_JsFatArrow)) { 1381 nextToken(); 1382 if (FormatTok->is(tok::l_brace)) 1383 parseChildBlock(); 1384 break; 1385 } 1386 1387 nextToken(); 1388 if (FormatTok->Tok.is(tok::l_brace)) { 1389 nextToken(); 1390 parseBracedList(); 1391 } else if (Style.Language == FormatStyle::LK_Proto && 1392 FormatTok->Tok.is(tok::less)) { 1393 nextToken(); 1394 parseBracedList(/*ContinueOnSemicolons=*/false, 1395 /*ClosingBraceKind=*/tok::greater); 1396 } 1397 break; 1398 case tok::l_square: 1399 parseSquare(); 1400 break; 1401 case tok::kw_new: 1402 parseNew(); 1403 break; 1404 default: 1405 nextToken(); 1406 break; 1407 } 1408 } while (!eof()); 1409 } 1410 1411 bool UnwrappedLineParser::tryToParseLambda() { 1412 if (!Style.isCpp()) { 1413 nextToken(); 1414 return false; 1415 } 1416 assert(FormatTok->is(tok::l_square)); 1417 FormatToken &LSquare = *FormatTok; 1418 if (!tryToParseLambdaIntroducer()) 1419 return false; 1420 1421 bool SeenArrow = false; 1422 1423 while (FormatTok->isNot(tok::l_brace)) { 1424 if (FormatTok->isSimpleTypeSpecifier()) { 1425 nextToken(); 1426 continue; 1427 } 1428 switch (FormatTok->Tok.getKind()) { 1429 case tok::l_brace: 1430 break; 1431 case tok::l_paren: 1432 parseParens(); 1433 break; 1434 case tok::amp: 1435 case tok::star: 1436 case tok::kw_const: 1437 case tok::comma: 1438 case tok::less: 1439 case tok::greater: 1440 case tok::identifier: 1441 case tok::numeric_constant: 1442 case tok::coloncolon: 1443 case tok::kw_mutable: 1444 case tok::kw_noexcept: 1445 nextToken(); 1446 break; 1447 // Specialization of a template with an integer parameter can contain 1448 // arithmetic, logical, comparison and ternary operators. 1449 // 1450 // FIXME: This also accepts sequences of operators that are not in the scope 1451 // of a template argument list. 1452 // 1453 // In a C++ lambda a template type can only occur after an arrow. We use 1454 // this as an heuristic to distinguish between Objective-C expressions 1455 // followed by an `a->b` expression, such as: 1456 // ([obj func:arg] + a->b) 1457 // Otherwise the code below would parse as a lambda. 1458 case tok::plus: 1459 case tok::minus: 1460 case tok::exclaim: 1461 case tok::tilde: 1462 case tok::slash: 1463 case tok::percent: 1464 case tok::lessless: 1465 case tok::pipe: 1466 case tok::pipepipe: 1467 case tok::ampamp: 1468 case tok::caret: 1469 case tok::equalequal: 1470 case tok::exclaimequal: 1471 case tok::greaterequal: 1472 case tok::lessequal: 1473 case tok::question: 1474 case tok::colon: 1475 case tok::kw_true: 1476 case tok::kw_false: 1477 if (SeenArrow) { 1478 nextToken(); 1479 break; 1480 } 1481 return true; 1482 case tok::arrow: 1483 // This might or might not actually be a lambda arrow (this could be an 1484 // ObjC method invocation followed by a dereferencing arrow). We might 1485 // reset this back to TT_Unknown in TokenAnnotator. 1486 FormatTok->Type = TT_LambdaArrow; 1487 SeenArrow = true; 1488 nextToken(); 1489 break; 1490 default: 1491 return true; 1492 } 1493 } 1494 FormatTok->Type = TT_LambdaLBrace; 1495 LSquare.Type = TT_LambdaLSquare; 1496 parseChildBlock(); 1497 return true; 1498 } 1499 1500 bool UnwrappedLineParser::tryToParseLambdaIntroducer() { 1501 const FormatToken *Previous = FormatTok->Previous; 1502 if (Previous && 1503 (Previous->isOneOf(tok::identifier, tok::kw_operator, tok::kw_new, 1504 tok::kw_delete, tok::l_square) || 1505 FormatTok->isCppStructuredBinding(Style) || Previous->closesScope() || 1506 Previous->isSimpleTypeSpecifier())) { 1507 nextToken(); 1508 return false; 1509 } 1510 nextToken(); 1511 if (FormatTok->is(tok::l_square)) { 1512 return false; 1513 } 1514 parseSquare(/*LambdaIntroducer=*/true); 1515 return true; 1516 } 1517 1518 void UnwrappedLineParser::tryToParseJSFunction() { 1519 assert(FormatTok->is(Keywords.kw_function) || 1520 FormatTok->startsSequence(Keywords.kw_async, Keywords.kw_function)); 1521 if (FormatTok->is(Keywords.kw_async)) 1522 nextToken(); 1523 // Consume "function". 1524 nextToken(); 1525 1526 // Consume * (generator function). Treat it like C++'s overloaded operators. 1527 if (FormatTok->is(tok::star)) { 1528 FormatTok->Type = TT_OverloadedOperator; 1529 nextToken(); 1530 } 1531 1532 // Consume function name. 1533 if (FormatTok->is(tok::identifier)) 1534 nextToken(); 1535 1536 if (FormatTok->isNot(tok::l_paren)) 1537 return; 1538 1539 // Parse formal parameter list. 1540 parseParens(); 1541 1542 if (FormatTok->is(tok::colon)) { 1543 // Parse a type definition. 1544 nextToken(); 1545 1546 // Eat the type declaration. For braced inline object types, balance braces, 1547 // otherwise just parse until finding an l_brace for the function body. 1548 if (FormatTok->is(tok::l_brace)) 1549 tryToParseBracedList(); 1550 else 1551 while (!FormatTok->isOneOf(tok::l_brace, tok::semi) && !eof()) 1552 nextToken(); 1553 } 1554 1555 if (FormatTok->is(tok::semi)) 1556 return; 1557 1558 parseChildBlock(); 1559 } 1560 1561 bool UnwrappedLineParser::tryToParseBracedList() { 1562 if (FormatTok->BlockKind == BK_Unknown) 1563 calculateBraceTypes(); 1564 assert(FormatTok->BlockKind != BK_Unknown); 1565 if (FormatTok->BlockKind == BK_Block) 1566 return false; 1567 nextToken(); 1568 parseBracedList(); 1569 return true; 1570 } 1571 1572 bool UnwrappedLineParser::parseBracedList(bool ContinueOnSemicolons, 1573 tok::TokenKind ClosingBraceKind) { 1574 bool HasError = false; 1575 1576 // FIXME: Once we have an expression parser in the UnwrappedLineParser, 1577 // replace this by using parseAssigmentExpression() inside. 1578 do { 1579 if (Style.Language == FormatStyle::LK_JavaScript) { 1580 if (FormatTok->is(Keywords.kw_function) || 1581 FormatTok->startsSequence(Keywords.kw_async, Keywords.kw_function)) { 1582 tryToParseJSFunction(); 1583 continue; 1584 } 1585 if (FormatTok->is(TT_JsFatArrow)) { 1586 nextToken(); 1587 // Fat arrows can be followed by simple expressions or by child blocks 1588 // in curly braces. 1589 if (FormatTok->is(tok::l_brace)) { 1590 parseChildBlock(); 1591 continue; 1592 } 1593 } 1594 if (FormatTok->is(tok::l_brace)) { 1595 // Could be a method inside of a braced list `{a() { return 1; }}`. 1596 if (tryToParseBracedList()) 1597 continue; 1598 parseChildBlock(); 1599 } 1600 } 1601 if (FormatTok->Tok.getKind() == ClosingBraceKind) { 1602 nextToken(); 1603 return !HasError; 1604 } 1605 switch (FormatTok->Tok.getKind()) { 1606 case tok::caret: 1607 nextToken(); 1608 if (FormatTok->is(tok::l_brace)) { 1609 parseChildBlock(); 1610 } 1611 break; 1612 case tok::l_square: 1613 tryToParseLambda(); 1614 break; 1615 case tok::l_paren: 1616 parseParens(); 1617 // JavaScript can just have free standing methods and getters/setters in 1618 // object literals. Detect them by a "{" following ")". 1619 if (Style.Language == FormatStyle::LK_JavaScript) { 1620 if (FormatTok->is(tok::l_brace)) 1621 parseChildBlock(); 1622 break; 1623 } 1624 break; 1625 case tok::l_brace: 1626 // Assume there are no blocks inside a braced init list apart 1627 // from the ones we explicitly parse out (like lambdas). 1628 FormatTok->BlockKind = BK_BracedInit; 1629 nextToken(); 1630 parseBracedList(); 1631 break; 1632 case tok::less: 1633 if (Style.Language == FormatStyle::LK_Proto) { 1634 nextToken(); 1635 parseBracedList(/*ContinueOnSemicolons=*/false, 1636 /*ClosingBraceKind=*/tok::greater); 1637 } else { 1638 nextToken(); 1639 } 1640 break; 1641 case tok::semi: 1642 // JavaScript (or more precisely TypeScript) can have semicolons in braced 1643 // lists (in so-called TypeMemberLists). Thus, the semicolon cannot be 1644 // used for error recovery if we have otherwise determined that this is 1645 // a braced list. 1646 if (Style.Language == FormatStyle::LK_JavaScript) { 1647 nextToken(); 1648 break; 1649 } 1650 HasError = true; 1651 if (!ContinueOnSemicolons) 1652 return !HasError; 1653 nextToken(); 1654 break; 1655 case tok::comma: 1656 nextToken(); 1657 break; 1658 default: 1659 nextToken(); 1660 break; 1661 } 1662 } while (!eof()); 1663 return false; 1664 } 1665 1666 void UnwrappedLineParser::parseParens() { 1667 assert(FormatTok->Tok.is(tok::l_paren) && "'(' expected."); 1668 nextToken(); 1669 do { 1670 switch (FormatTok->Tok.getKind()) { 1671 case tok::l_paren: 1672 parseParens(); 1673 if (Style.Language == FormatStyle::LK_Java && FormatTok->is(tok::l_brace)) 1674 parseChildBlock(); 1675 break; 1676 case tok::r_paren: 1677 nextToken(); 1678 return; 1679 case tok::r_brace: 1680 // A "}" inside parenthesis is an error if there wasn't a matching "{". 1681 return; 1682 case tok::l_square: 1683 tryToParseLambda(); 1684 break; 1685 case tok::l_brace: 1686 if (!tryToParseBracedList()) 1687 parseChildBlock(); 1688 break; 1689 case tok::at: 1690 nextToken(); 1691 if (FormatTok->Tok.is(tok::l_brace)) { 1692 nextToken(); 1693 parseBracedList(); 1694 } 1695 break; 1696 case tok::kw_class: 1697 if (Style.Language == FormatStyle::LK_JavaScript) 1698 parseRecord(/*ParseAsExpr=*/true); 1699 else 1700 nextToken(); 1701 break; 1702 case tok::identifier: 1703 if (Style.Language == FormatStyle::LK_JavaScript && 1704 (FormatTok->is(Keywords.kw_function) || 1705 FormatTok->startsSequence(Keywords.kw_async, Keywords.kw_function))) 1706 tryToParseJSFunction(); 1707 else 1708 nextToken(); 1709 break; 1710 default: 1711 nextToken(); 1712 break; 1713 } 1714 } while (!eof()); 1715 } 1716 1717 void UnwrappedLineParser::parseSquare(bool LambdaIntroducer) { 1718 if (!LambdaIntroducer) { 1719 assert(FormatTok->Tok.is(tok::l_square) && "'[' expected."); 1720 if (tryToParseLambda()) 1721 return; 1722 } 1723 do { 1724 switch (FormatTok->Tok.getKind()) { 1725 case tok::l_paren: 1726 parseParens(); 1727 break; 1728 case tok::r_square: 1729 nextToken(); 1730 return; 1731 case tok::r_brace: 1732 // A "}" inside parenthesis is an error if there wasn't a matching "{". 1733 return; 1734 case tok::l_square: 1735 parseSquare(); 1736 break; 1737 case tok::l_brace: { 1738 if (!tryToParseBracedList()) 1739 parseChildBlock(); 1740 break; 1741 } 1742 case tok::at: 1743 nextToken(); 1744 if (FormatTok->Tok.is(tok::l_brace)) { 1745 nextToken(); 1746 parseBracedList(); 1747 } 1748 break; 1749 default: 1750 nextToken(); 1751 break; 1752 } 1753 } while (!eof()); 1754 } 1755 1756 void UnwrappedLineParser::parseIfThenElse() { 1757 assert(FormatTok->Tok.is(tok::kw_if) && "'if' expected"); 1758 nextToken(); 1759 if (FormatTok->Tok.isOneOf(tok::kw_constexpr, tok::identifier)) 1760 nextToken(); 1761 if (FormatTok->Tok.is(tok::l_paren)) 1762 parseParens(); 1763 bool NeedsUnwrappedLine = false; 1764 if (FormatTok->Tok.is(tok::l_brace)) { 1765 CompoundStatementIndenter Indenter(this, Style, Line->Level); 1766 parseBlock(/*MustBeDeclaration=*/false); 1767 if (Style.BraceWrapping.BeforeElse) 1768 addUnwrappedLine(); 1769 else 1770 NeedsUnwrappedLine = true; 1771 } else { 1772 addUnwrappedLine(); 1773 ++Line->Level; 1774 parseStructuralElement(); 1775 --Line->Level; 1776 } 1777 if (FormatTok->Tok.is(tok::kw_else)) { 1778 nextToken(); 1779 if (FormatTok->Tok.is(tok::l_brace)) { 1780 CompoundStatementIndenter Indenter(this, Style, Line->Level); 1781 parseBlock(/*MustBeDeclaration=*/false); 1782 addUnwrappedLine(); 1783 } else if (FormatTok->Tok.is(tok::kw_if)) { 1784 parseIfThenElse(); 1785 } else { 1786 addUnwrappedLine(); 1787 ++Line->Level; 1788 parseStructuralElement(); 1789 if (FormatTok->is(tok::eof)) 1790 addUnwrappedLine(); 1791 --Line->Level; 1792 } 1793 } else if (NeedsUnwrappedLine) { 1794 addUnwrappedLine(); 1795 } 1796 } 1797 1798 void UnwrappedLineParser::parseTryCatch() { 1799 assert(FormatTok->isOneOf(tok::kw_try, tok::kw___try) && "'try' expected"); 1800 nextToken(); 1801 bool NeedsUnwrappedLine = false; 1802 if (FormatTok->is(tok::colon)) { 1803 // We are in a function try block, what comes is an initializer list. 1804 nextToken(); 1805 while (FormatTok->is(tok::identifier)) { 1806 nextToken(); 1807 if (FormatTok->is(tok::l_paren)) 1808 parseParens(); 1809 if (FormatTok->is(tok::comma)) 1810 nextToken(); 1811 } 1812 } 1813 // Parse try with resource. 1814 if (Style.Language == FormatStyle::LK_Java && FormatTok->is(tok::l_paren)) { 1815 parseParens(); 1816 } 1817 if (FormatTok->is(tok::l_brace)) { 1818 CompoundStatementIndenter Indenter(this, Style, Line->Level); 1819 parseBlock(/*MustBeDeclaration=*/false); 1820 if (Style.BraceWrapping.BeforeCatch) { 1821 addUnwrappedLine(); 1822 } else { 1823 NeedsUnwrappedLine = true; 1824 } 1825 } else if (!FormatTok->is(tok::kw_catch)) { 1826 // The C++ standard requires a compound-statement after a try. 1827 // If there's none, we try to assume there's a structuralElement 1828 // and try to continue. 1829 addUnwrappedLine(); 1830 ++Line->Level; 1831 parseStructuralElement(); 1832 --Line->Level; 1833 } 1834 while (1) { 1835 if (FormatTok->is(tok::at)) 1836 nextToken(); 1837 if (!(FormatTok->isOneOf(tok::kw_catch, Keywords.kw___except, 1838 tok::kw___finally) || 1839 ((Style.Language == FormatStyle::LK_Java || 1840 Style.Language == FormatStyle::LK_JavaScript) && 1841 FormatTok->is(Keywords.kw_finally)) || 1842 (FormatTok->Tok.isObjCAtKeyword(tok::objc_catch) || 1843 FormatTok->Tok.isObjCAtKeyword(tok::objc_finally)))) 1844 break; 1845 nextToken(); 1846 while (FormatTok->isNot(tok::l_brace)) { 1847 if (FormatTok->is(tok::l_paren)) { 1848 parseParens(); 1849 continue; 1850 } 1851 if (FormatTok->isOneOf(tok::semi, tok::r_brace, tok::eof)) 1852 return; 1853 nextToken(); 1854 } 1855 NeedsUnwrappedLine = false; 1856 CompoundStatementIndenter Indenter(this, Style, Line->Level); 1857 parseBlock(/*MustBeDeclaration=*/false); 1858 if (Style.BraceWrapping.BeforeCatch) 1859 addUnwrappedLine(); 1860 else 1861 NeedsUnwrappedLine = true; 1862 } 1863 if (NeedsUnwrappedLine) 1864 addUnwrappedLine(); 1865 } 1866 1867 void UnwrappedLineParser::parseNamespace() { 1868 assert(FormatTok->isOneOf(tok::kw_namespace, TT_NamespaceMacro) && 1869 "'namespace' expected"); 1870 1871 const FormatToken &InitialToken = *FormatTok; 1872 nextToken(); 1873 if (InitialToken.is(TT_NamespaceMacro)) { 1874 parseParens(); 1875 } else { 1876 while (FormatTok->isOneOf(tok::identifier, tok::coloncolon, tok::kw_inline, 1877 tok::l_square)) { 1878 if (FormatTok->is(tok::l_square)) 1879 parseSquare(); 1880 else 1881 nextToken(); 1882 } 1883 } 1884 if (FormatTok->Tok.is(tok::l_brace)) { 1885 if (ShouldBreakBeforeBrace(Style, InitialToken)) 1886 addUnwrappedLine(); 1887 1888 bool AddLevel = Style.NamespaceIndentation == FormatStyle::NI_All || 1889 (Style.NamespaceIndentation == FormatStyle::NI_Inner && 1890 DeclarationScopeStack.size() > 1); 1891 parseBlock(/*MustBeDeclaration=*/true, AddLevel); 1892 // Munch the semicolon after a namespace. This is more common than one would 1893 // think. Puttin the semicolon into its own line is very ugly. 1894 if (FormatTok->Tok.is(tok::semi)) 1895 nextToken(); 1896 addUnwrappedLine(); 1897 } 1898 // FIXME: Add error handling. 1899 } 1900 1901 void UnwrappedLineParser::parseNew() { 1902 assert(FormatTok->is(tok::kw_new) && "'new' expected"); 1903 nextToken(); 1904 if (Style.Language != FormatStyle::LK_Java) 1905 return; 1906 1907 // In Java, we can parse everything up to the parens, which aren't optional. 1908 do { 1909 // There should not be a ;, { or } before the new's open paren. 1910 if (FormatTok->isOneOf(tok::semi, tok::l_brace, tok::r_brace)) 1911 return; 1912 1913 // Consume the parens. 1914 if (FormatTok->is(tok::l_paren)) { 1915 parseParens(); 1916 1917 // If there is a class body of an anonymous class, consume that as child. 1918 if (FormatTok->is(tok::l_brace)) 1919 parseChildBlock(); 1920 return; 1921 } 1922 nextToken(); 1923 } while (!eof()); 1924 } 1925 1926 void UnwrappedLineParser::parseForOrWhileLoop() { 1927 assert(FormatTok->isOneOf(tok::kw_for, tok::kw_while, TT_ForEachMacro) && 1928 "'for', 'while' or foreach macro expected"); 1929 nextToken(); 1930 // JS' for await ( ... 1931 if (Style.Language == FormatStyle::LK_JavaScript && 1932 FormatTok->is(Keywords.kw_await)) 1933 nextToken(); 1934 if (FormatTok->Tok.is(tok::l_paren)) 1935 parseParens(); 1936 if (FormatTok->Tok.is(tok::l_brace)) { 1937 CompoundStatementIndenter Indenter(this, Style, Line->Level); 1938 parseBlock(/*MustBeDeclaration=*/false); 1939 addUnwrappedLine(); 1940 } else { 1941 addUnwrappedLine(); 1942 ++Line->Level; 1943 parseStructuralElement(); 1944 --Line->Level; 1945 } 1946 } 1947 1948 void UnwrappedLineParser::parseDoWhile() { 1949 assert(FormatTok->Tok.is(tok::kw_do) && "'do' expected"); 1950 nextToken(); 1951 if (FormatTok->Tok.is(tok::l_brace)) { 1952 CompoundStatementIndenter Indenter(this, Style, Line->Level); 1953 parseBlock(/*MustBeDeclaration=*/false); 1954 if (Style.BraceWrapping.IndentBraces) 1955 addUnwrappedLine(); 1956 } else { 1957 addUnwrappedLine(); 1958 ++Line->Level; 1959 parseStructuralElement(); 1960 --Line->Level; 1961 } 1962 1963 // FIXME: Add error handling. 1964 if (!FormatTok->Tok.is(tok::kw_while)) { 1965 addUnwrappedLine(); 1966 return; 1967 } 1968 1969 nextToken(); 1970 parseStructuralElement(); 1971 } 1972 1973 void UnwrappedLineParser::parseLabel(bool LeftAlignLabel) { 1974 nextToken(); 1975 unsigned OldLineLevel = Line->Level; 1976 if (Line->Level > 1 || (!Line->InPPDirective && Line->Level > 0)) 1977 --Line->Level; 1978 if (LeftAlignLabel) 1979 Line->Level = 0; 1980 if (CommentsBeforeNextToken.empty() && FormatTok->Tok.is(tok::l_brace)) { 1981 CompoundStatementIndenter Indenter(this, Line->Level, 1982 Style.BraceWrapping.AfterCaseLabel, 1983 Style.BraceWrapping.IndentBraces); 1984 parseBlock(/*MustBeDeclaration=*/false); 1985 if (FormatTok->Tok.is(tok::kw_break)) { 1986 if (Style.BraceWrapping.AfterControlStatement) 1987 addUnwrappedLine(); 1988 parseStructuralElement(); 1989 } 1990 addUnwrappedLine(); 1991 } else { 1992 if (FormatTok->is(tok::semi)) 1993 nextToken(); 1994 addUnwrappedLine(); 1995 } 1996 Line->Level = OldLineLevel; 1997 if (FormatTok->isNot(tok::l_brace)) { 1998 parseStructuralElement(); 1999 addUnwrappedLine(); 2000 } 2001 } 2002 2003 void UnwrappedLineParser::parseCaseLabel() { 2004 assert(FormatTok->Tok.is(tok::kw_case) && "'case' expected"); 2005 // FIXME: fix handling of complex expressions here. 2006 do { 2007 nextToken(); 2008 } while (!eof() && !FormatTok->Tok.is(tok::colon)); 2009 parseLabel(); 2010 } 2011 2012 void UnwrappedLineParser::parseSwitch() { 2013 assert(FormatTok->Tok.is(tok::kw_switch) && "'switch' expected"); 2014 nextToken(); 2015 if (FormatTok->Tok.is(tok::l_paren)) 2016 parseParens(); 2017 if (FormatTok->Tok.is(tok::l_brace)) { 2018 CompoundStatementIndenter Indenter(this, Style, Line->Level); 2019 parseBlock(/*MustBeDeclaration=*/false); 2020 addUnwrappedLine(); 2021 } else { 2022 addUnwrappedLine(); 2023 ++Line->Level; 2024 parseStructuralElement(); 2025 --Line->Level; 2026 } 2027 } 2028 2029 void UnwrappedLineParser::parseAccessSpecifier() { 2030 nextToken(); 2031 // Understand Qt's slots. 2032 if (FormatTok->isOneOf(Keywords.kw_slots, Keywords.kw_qslots)) 2033 nextToken(); 2034 // Otherwise, we don't know what it is, and we'd better keep the next token. 2035 if (FormatTok->Tok.is(tok::colon)) 2036 nextToken(); 2037 addUnwrappedLine(); 2038 } 2039 2040 bool UnwrappedLineParser::parseEnum() { 2041 // Won't be 'enum' for NS_ENUMs. 2042 if (FormatTok->Tok.is(tok::kw_enum)) 2043 nextToken(); 2044 2045 // In TypeScript, "enum" can also be used as property name, e.g. in interface 2046 // declarations. An "enum" keyword followed by a colon would be a syntax 2047 // error and thus assume it is just an identifier. 2048 if (Style.Language == FormatStyle::LK_JavaScript && 2049 FormatTok->isOneOf(tok::colon, tok::question)) 2050 return false; 2051 2052 // In protobuf, "enum" can be used as a field name. 2053 if (Style.Language == FormatStyle::LK_Proto && FormatTok->is(tok::equal)) 2054 return false; 2055 2056 // Eat up enum class ... 2057 if (FormatTok->Tok.is(tok::kw_class) || FormatTok->Tok.is(tok::kw_struct)) 2058 nextToken(); 2059 2060 while (FormatTok->Tok.getIdentifierInfo() || 2061 FormatTok->isOneOf(tok::colon, tok::coloncolon, tok::less, 2062 tok::greater, tok::comma, tok::question)) { 2063 nextToken(); 2064 // We can have macros or attributes in between 'enum' and the enum name. 2065 if (FormatTok->is(tok::l_paren)) 2066 parseParens(); 2067 if (FormatTok->is(tok::identifier)) { 2068 nextToken(); 2069 // If there are two identifiers in a row, this is likely an elaborate 2070 // return type. In Java, this can be "implements", etc. 2071 if (Style.isCpp() && FormatTok->is(tok::identifier)) 2072 return false; 2073 } 2074 } 2075 2076 // Just a declaration or something is wrong. 2077 if (FormatTok->isNot(tok::l_brace)) 2078 return true; 2079 FormatTok->BlockKind = BK_Block; 2080 2081 if (Style.Language == FormatStyle::LK_Java) { 2082 // Java enums are different. 2083 parseJavaEnumBody(); 2084 return true; 2085 } 2086 if (Style.Language == FormatStyle::LK_Proto) { 2087 parseBlock(/*MustBeDeclaration=*/true); 2088 return true; 2089 } 2090 2091 // Parse enum body. 2092 nextToken(); 2093 bool HasError = !parseBracedList(/*ContinueOnSemicolons=*/true); 2094 if (HasError) { 2095 if (FormatTok->is(tok::semi)) 2096 nextToken(); 2097 addUnwrappedLine(); 2098 } 2099 return true; 2100 2101 // There is no addUnwrappedLine() here so that we fall through to parsing a 2102 // structural element afterwards. Thus, in "enum A {} n, m;", 2103 // "} n, m;" will end up in one unwrapped line. 2104 } 2105 2106 void UnwrappedLineParser::parseJavaEnumBody() { 2107 // Determine whether the enum is simple, i.e. does not have a semicolon or 2108 // constants with class bodies. Simple enums can be formatted like braced 2109 // lists, contracted to a single line, etc. 2110 unsigned StoredPosition = Tokens->getPosition(); 2111 bool IsSimple = true; 2112 FormatToken *Tok = Tokens->getNextToken(); 2113 while (Tok) { 2114 if (Tok->is(tok::r_brace)) 2115 break; 2116 if (Tok->isOneOf(tok::l_brace, tok::semi)) { 2117 IsSimple = false; 2118 break; 2119 } 2120 // FIXME: This will also mark enums with braces in the arguments to enum 2121 // constants as "not simple". This is probably fine in practice, though. 2122 Tok = Tokens->getNextToken(); 2123 } 2124 FormatTok = Tokens->setPosition(StoredPosition); 2125 2126 if (IsSimple) { 2127 nextToken(); 2128 parseBracedList(); 2129 addUnwrappedLine(); 2130 return; 2131 } 2132 2133 // Parse the body of a more complex enum. 2134 // First add a line for everything up to the "{". 2135 nextToken(); 2136 addUnwrappedLine(); 2137 ++Line->Level; 2138 2139 // Parse the enum constants. 2140 while (FormatTok) { 2141 if (FormatTok->is(tok::l_brace)) { 2142 // Parse the constant's class body. 2143 parseBlock(/*MustBeDeclaration=*/true, /*AddLevel=*/true, 2144 /*MunchSemi=*/false); 2145 } else if (FormatTok->is(tok::l_paren)) { 2146 parseParens(); 2147 } else if (FormatTok->is(tok::comma)) { 2148 nextToken(); 2149 addUnwrappedLine(); 2150 } else if (FormatTok->is(tok::semi)) { 2151 nextToken(); 2152 addUnwrappedLine(); 2153 break; 2154 } else if (FormatTok->is(tok::r_brace)) { 2155 addUnwrappedLine(); 2156 break; 2157 } else { 2158 nextToken(); 2159 } 2160 } 2161 2162 // Parse the class body after the enum's ";" if any. 2163 parseLevel(/*HasOpeningBrace=*/true); 2164 nextToken(); 2165 --Line->Level; 2166 addUnwrappedLine(); 2167 } 2168 2169 void UnwrappedLineParser::parseRecord(bool ParseAsExpr) { 2170 const FormatToken &InitialToken = *FormatTok; 2171 nextToken(); 2172 2173 // The actual identifier can be a nested name specifier, and in macros 2174 // it is often token-pasted. 2175 while (FormatTok->isOneOf(tok::identifier, tok::coloncolon, tok::hashhash, 2176 tok::kw___attribute, tok::kw___declspec, 2177 tok::kw_alignas) || 2178 ((Style.Language == FormatStyle::LK_Java || 2179 Style.Language == FormatStyle::LK_JavaScript) && 2180 FormatTok->isOneOf(tok::period, tok::comma))) { 2181 if (Style.Language == FormatStyle::LK_JavaScript && 2182 FormatTok->isOneOf(Keywords.kw_extends, Keywords.kw_implements)) { 2183 // JavaScript/TypeScript supports inline object types in 2184 // extends/implements positions: 2185 // class Foo implements {bar: number} { } 2186 nextToken(); 2187 if (FormatTok->is(tok::l_brace)) { 2188 tryToParseBracedList(); 2189 continue; 2190 } 2191 } 2192 bool IsNonMacroIdentifier = 2193 FormatTok->is(tok::identifier) && 2194 FormatTok->TokenText != FormatTok->TokenText.upper(); 2195 nextToken(); 2196 // We can have macros or attributes in between 'class' and the class name. 2197 if (!IsNonMacroIdentifier && FormatTok->Tok.is(tok::l_paren)) 2198 parseParens(); 2199 } 2200 2201 // Note that parsing away template declarations here leads to incorrectly 2202 // accepting function declarations as record declarations. 2203 // In general, we cannot solve this problem. Consider: 2204 // class A<int> B() {} 2205 // which can be a function definition or a class definition when B() is a 2206 // macro. If we find enough real-world cases where this is a problem, we 2207 // can parse for the 'template' keyword in the beginning of the statement, 2208 // and thus rule out the record production in case there is no template 2209 // (this would still leave us with an ambiguity between template function 2210 // and class declarations). 2211 if (FormatTok->isOneOf(tok::colon, tok::less)) { 2212 while (!eof()) { 2213 if (FormatTok->is(tok::l_brace)) { 2214 calculateBraceTypes(/*ExpectClassBody=*/true); 2215 if (!tryToParseBracedList()) 2216 break; 2217 } 2218 if (FormatTok->Tok.is(tok::semi)) 2219 return; 2220 nextToken(); 2221 } 2222 } 2223 if (FormatTok->Tok.is(tok::l_brace)) { 2224 if (ParseAsExpr) { 2225 parseChildBlock(); 2226 } else { 2227 if (ShouldBreakBeforeBrace(Style, InitialToken)) 2228 addUnwrappedLine(); 2229 2230 parseBlock(/*MustBeDeclaration=*/true, /*AddLevel=*/true, 2231 /*MunchSemi=*/false); 2232 } 2233 } 2234 // There is no addUnwrappedLine() here so that we fall through to parsing a 2235 // structural element afterwards. Thus, in "class A {} n, m;", 2236 // "} n, m;" will end up in one unwrapped line. 2237 } 2238 2239 void UnwrappedLineParser::parseObjCMethod() { 2240 assert(FormatTok->Tok.isOneOf(tok::l_paren, tok::identifier) && 2241 "'(' or identifier expected."); 2242 do { 2243 if (FormatTok->Tok.is(tok::semi)) { 2244 nextToken(); 2245 addUnwrappedLine(); 2246 return; 2247 } else if (FormatTok->Tok.is(tok::l_brace)) { 2248 if (Style.BraceWrapping.AfterFunction) 2249 addUnwrappedLine(); 2250 parseBlock(/*MustBeDeclaration=*/false); 2251 addUnwrappedLine(); 2252 return; 2253 } else { 2254 nextToken(); 2255 } 2256 } while (!eof()); 2257 } 2258 2259 void UnwrappedLineParser::parseObjCProtocolList() { 2260 assert(FormatTok->Tok.is(tok::less) && "'<' expected."); 2261 do { 2262 nextToken(); 2263 // Early exit in case someone forgot a close angle. 2264 if (FormatTok->isOneOf(tok::semi, tok::l_brace) || 2265 FormatTok->Tok.isObjCAtKeyword(tok::objc_end)) 2266 return; 2267 } while (!eof() && FormatTok->Tok.isNot(tok::greater)); 2268 nextToken(); // Skip '>'. 2269 } 2270 2271 void UnwrappedLineParser::parseObjCUntilAtEnd() { 2272 do { 2273 if (FormatTok->Tok.isObjCAtKeyword(tok::objc_end)) { 2274 nextToken(); 2275 addUnwrappedLine(); 2276 break; 2277 } 2278 if (FormatTok->is(tok::l_brace)) { 2279 parseBlock(/*MustBeDeclaration=*/false); 2280 // In ObjC interfaces, nothing should be following the "}". 2281 addUnwrappedLine(); 2282 } else if (FormatTok->is(tok::r_brace)) { 2283 // Ignore stray "}". parseStructuralElement doesn't consume them. 2284 nextToken(); 2285 addUnwrappedLine(); 2286 } else if (FormatTok->isOneOf(tok::minus, tok::plus)) { 2287 nextToken(); 2288 parseObjCMethod(); 2289 } else { 2290 parseStructuralElement(); 2291 } 2292 } while (!eof()); 2293 } 2294 2295 void UnwrappedLineParser::parseObjCInterfaceOrImplementation() { 2296 assert(FormatTok->Tok.getObjCKeywordID() == tok::objc_interface || 2297 FormatTok->Tok.getObjCKeywordID() == tok::objc_implementation); 2298 nextToken(); 2299 nextToken(); // interface name 2300 2301 // @interface can be followed by a lightweight generic 2302 // specialization list, then either a base class or a category. 2303 if (FormatTok->Tok.is(tok::less)) { 2304 // Unlike protocol lists, generic parameterizations support 2305 // nested angles: 2306 // 2307 // @interface Foo<ValueType : id <NSCopying, NSSecureCoding>> : 2308 // NSObject <NSCopying, NSSecureCoding> 2309 // 2310 // so we need to count how many open angles we have left. 2311 unsigned NumOpenAngles = 1; 2312 do { 2313 nextToken(); 2314 // Early exit in case someone forgot a close angle. 2315 if (FormatTok->isOneOf(tok::semi, tok::l_brace) || 2316 FormatTok->Tok.isObjCAtKeyword(tok::objc_end)) 2317 break; 2318 if (FormatTok->Tok.is(tok::less)) 2319 ++NumOpenAngles; 2320 else if (FormatTok->Tok.is(tok::greater)) { 2321 assert(NumOpenAngles > 0 && "'>' makes NumOpenAngles negative"); 2322 --NumOpenAngles; 2323 } 2324 } while (!eof() && NumOpenAngles != 0); 2325 nextToken(); // Skip '>'. 2326 } 2327 if (FormatTok->Tok.is(tok::colon)) { 2328 nextToken(); 2329 nextToken(); // base class name 2330 } else if (FormatTok->Tok.is(tok::l_paren)) 2331 // Skip category, if present. 2332 parseParens(); 2333 2334 if (FormatTok->Tok.is(tok::less)) 2335 parseObjCProtocolList(); 2336 2337 if (FormatTok->Tok.is(tok::l_brace)) { 2338 if (Style.BraceWrapping.AfterObjCDeclaration) 2339 addUnwrappedLine(); 2340 parseBlock(/*MustBeDeclaration=*/true); 2341 } 2342 2343 // With instance variables, this puts '}' on its own line. Without instance 2344 // variables, this ends the @interface line. 2345 addUnwrappedLine(); 2346 2347 parseObjCUntilAtEnd(); 2348 } 2349 2350 // Returns true for the declaration/definition form of @protocol, 2351 // false for the expression form. 2352 bool UnwrappedLineParser::parseObjCProtocol() { 2353 assert(FormatTok->Tok.getObjCKeywordID() == tok::objc_protocol); 2354 nextToken(); 2355 2356 if (FormatTok->is(tok::l_paren)) 2357 // The expression form of @protocol, e.g. "Protocol* p = @protocol(foo);". 2358 return false; 2359 2360 // The definition/declaration form, 2361 // @protocol Foo 2362 // - (int)someMethod; 2363 // @end 2364 2365 nextToken(); // protocol name 2366 2367 if (FormatTok->Tok.is(tok::less)) 2368 parseObjCProtocolList(); 2369 2370 // Check for protocol declaration. 2371 if (FormatTok->Tok.is(tok::semi)) { 2372 nextToken(); 2373 addUnwrappedLine(); 2374 return true; 2375 } 2376 2377 addUnwrappedLine(); 2378 parseObjCUntilAtEnd(); 2379 return true; 2380 } 2381 2382 void UnwrappedLineParser::parseJavaScriptEs6ImportExport() { 2383 bool IsImport = FormatTok->is(Keywords.kw_import); 2384 assert(IsImport || FormatTok->is(tok::kw_export)); 2385 nextToken(); 2386 2387 // Consume the "default" in "export default class/function". 2388 if (FormatTok->is(tok::kw_default)) 2389 nextToken(); 2390 2391 // Consume "async function", "function" and "default function", so that these 2392 // get parsed as free-standing JS functions, i.e. do not require a trailing 2393 // semicolon. 2394 if (FormatTok->is(Keywords.kw_async)) 2395 nextToken(); 2396 if (FormatTok->is(Keywords.kw_function)) { 2397 nextToken(); 2398 return; 2399 } 2400 2401 // For imports, `export *`, `export {...}`, consume the rest of the line up 2402 // to the terminating `;`. For everything else, just return and continue 2403 // parsing the structural element, i.e. the declaration or expression for 2404 // `export default`. 2405 if (!IsImport && !FormatTok->isOneOf(tok::l_brace, tok::star) && 2406 !FormatTok->isStringLiteral()) 2407 return; 2408 2409 while (!eof()) { 2410 if (FormatTok->is(tok::semi)) 2411 return; 2412 if (Line->Tokens.empty()) { 2413 // Common issue: Automatic Semicolon Insertion wrapped the line, so the 2414 // import statement should terminate. 2415 return; 2416 } 2417 if (FormatTok->is(tok::l_brace)) { 2418 FormatTok->BlockKind = BK_Block; 2419 nextToken(); 2420 parseBracedList(); 2421 } else { 2422 nextToken(); 2423 } 2424 } 2425 } 2426 2427 void UnwrappedLineParser::parseStatementMacro() { 2428 nextToken(); 2429 if (FormatTok->is(tok::l_paren)) 2430 parseParens(); 2431 if (FormatTok->is(tok::semi)) 2432 nextToken(); 2433 addUnwrappedLine(); 2434 } 2435 2436 LLVM_ATTRIBUTE_UNUSED static void printDebugInfo(const UnwrappedLine &Line, 2437 StringRef Prefix = "") { 2438 llvm::dbgs() << Prefix << "Line(" << Line.Level 2439 << ", FSC=" << Line.FirstStartColumn << ")" 2440 << (Line.InPPDirective ? " MACRO" : "") << ": "; 2441 for (std::list<UnwrappedLineNode>::const_iterator I = Line.Tokens.begin(), 2442 E = Line.Tokens.end(); 2443 I != E; ++I) { 2444 llvm::dbgs() << I->Tok->Tok.getName() << "[" 2445 << "T=" << I->Tok->Type << ", OC=" << I->Tok->OriginalColumn 2446 << "] "; 2447 } 2448 for (std::list<UnwrappedLineNode>::const_iterator I = Line.Tokens.begin(), 2449 E = Line.Tokens.end(); 2450 I != E; ++I) { 2451 const UnwrappedLineNode &Node = *I; 2452 for (SmallVectorImpl<UnwrappedLine>::const_iterator 2453 I = Node.Children.begin(), 2454 E = Node.Children.end(); 2455 I != E; ++I) { 2456 printDebugInfo(*I, "\nChild: "); 2457 } 2458 } 2459 llvm::dbgs() << "\n"; 2460 } 2461 2462 void UnwrappedLineParser::addUnwrappedLine() { 2463 if (Line->Tokens.empty()) 2464 return; 2465 LLVM_DEBUG({ 2466 if (CurrentLines == &Lines) 2467 printDebugInfo(*Line); 2468 }); 2469 CurrentLines->push_back(std::move(*Line)); 2470 Line->Tokens.clear(); 2471 Line->MatchingOpeningBlockLineIndex = UnwrappedLine::kInvalidIndex; 2472 Line->FirstStartColumn = 0; 2473 if (CurrentLines == &Lines && !PreprocessorDirectives.empty()) { 2474 CurrentLines->append( 2475 std::make_move_iterator(PreprocessorDirectives.begin()), 2476 std::make_move_iterator(PreprocessorDirectives.end())); 2477 PreprocessorDirectives.clear(); 2478 } 2479 // Disconnect the current token from the last token on the previous line. 2480 FormatTok->Previous = nullptr; 2481 } 2482 2483 bool UnwrappedLineParser::eof() const { return FormatTok->Tok.is(tok::eof); } 2484 2485 bool UnwrappedLineParser::isOnNewLine(const FormatToken &FormatTok) { 2486 return (Line->InPPDirective || FormatTok.HasUnescapedNewline) && 2487 FormatTok.NewlinesBefore > 0; 2488 } 2489 2490 // Checks if \p FormatTok is a line comment that continues the line comment 2491 // section on \p Line. 2492 static bool continuesLineCommentSection(const FormatToken &FormatTok, 2493 const UnwrappedLine &Line, 2494 llvm::Regex &CommentPragmasRegex) { 2495 if (Line.Tokens.empty()) 2496 return false; 2497 2498 StringRef IndentContent = FormatTok.TokenText; 2499 if (FormatTok.TokenText.startswith("//") || 2500 FormatTok.TokenText.startswith("/*")) 2501 IndentContent = FormatTok.TokenText.substr(2); 2502 if (CommentPragmasRegex.match(IndentContent)) 2503 return false; 2504 2505 // If Line starts with a line comment, then FormatTok continues the comment 2506 // section if its original column is greater or equal to the original start 2507 // column of the line. 2508 // 2509 // Define the min column token of a line as follows: if a line ends in '{' or 2510 // contains a '{' followed by a line comment, then the min column token is 2511 // that '{'. Otherwise, the min column token of the line is the first token of 2512 // the line. 2513 // 2514 // If Line starts with a token other than a line comment, then FormatTok 2515 // continues the comment section if its original column is greater than the 2516 // original start column of the min column token of the line. 2517 // 2518 // For example, the second line comment continues the first in these cases: 2519 // 2520 // // first line 2521 // // second line 2522 // 2523 // and: 2524 // 2525 // // first line 2526 // // second line 2527 // 2528 // and: 2529 // 2530 // int i; // first line 2531 // // second line 2532 // 2533 // and: 2534 // 2535 // do { // first line 2536 // // second line 2537 // int i; 2538 // } while (true); 2539 // 2540 // and: 2541 // 2542 // enum { 2543 // a, // first line 2544 // // second line 2545 // b 2546 // }; 2547 // 2548 // The second line comment doesn't continue the first in these cases: 2549 // 2550 // // first line 2551 // // second line 2552 // 2553 // and: 2554 // 2555 // int i; // first line 2556 // // second line 2557 // 2558 // and: 2559 // 2560 // do { // first line 2561 // // second line 2562 // int i; 2563 // } while (true); 2564 // 2565 // and: 2566 // 2567 // enum { 2568 // a, // first line 2569 // // second line 2570 // }; 2571 const FormatToken *MinColumnToken = Line.Tokens.front().Tok; 2572 2573 // Scan for '{//'. If found, use the column of '{' as a min column for line 2574 // comment section continuation. 2575 const FormatToken *PreviousToken = nullptr; 2576 for (const UnwrappedLineNode &Node : Line.Tokens) { 2577 if (PreviousToken && PreviousToken->is(tok::l_brace) && 2578 isLineComment(*Node.Tok)) { 2579 MinColumnToken = PreviousToken; 2580 break; 2581 } 2582 PreviousToken = Node.Tok; 2583 2584 // Grab the last newline preceding a token in this unwrapped line. 2585 if (Node.Tok->NewlinesBefore > 0) { 2586 MinColumnToken = Node.Tok; 2587 } 2588 } 2589 if (PreviousToken && PreviousToken->is(tok::l_brace)) { 2590 MinColumnToken = PreviousToken; 2591 } 2592 2593 return continuesLineComment(FormatTok, /*Previous=*/Line.Tokens.back().Tok, 2594 MinColumnToken); 2595 } 2596 2597 void UnwrappedLineParser::flushComments(bool NewlineBeforeNext) { 2598 bool JustComments = Line->Tokens.empty(); 2599 for (SmallVectorImpl<FormatToken *>::const_iterator 2600 I = CommentsBeforeNextToken.begin(), 2601 E = CommentsBeforeNextToken.end(); 2602 I != E; ++I) { 2603 // Line comments that belong to the same line comment section are put on the 2604 // same line since later we might want to reflow content between them. 2605 // Additional fine-grained breaking of line comment sections is controlled 2606 // by the class BreakableLineCommentSection in case it is desirable to keep 2607 // several line comment sections in the same unwrapped line. 2608 // 2609 // FIXME: Consider putting separate line comment sections as children to the 2610 // unwrapped line instead. 2611 (*I)->ContinuesLineCommentSection = 2612 continuesLineCommentSection(**I, *Line, CommentPragmasRegex); 2613 if (isOnNewLine(**I) && JustComments && !(*I)->ContinuesLineCommentSection) 2614 addUnwrappedLine(); 2615 pushToken(*I); 2616 } 2617 if (NewlineBeforeNext && JustComments) 2618 addUnwrappedLine(); 2619 CommentsBeforeNextToken.clear(); 2620 } 2621 2622 void UnwrappedLineParser::nextToken(int LevelDifference) { 2623 if (eof()) 2624 return; 2625 flushComments(isOnNewLine(*FormatTok)); 2626 pushToken(FormatTok); 2627 FormatToken *Previous = FormatTok; 2628 if (Style.Language != FormatStyle::LK_JavaScript) 2629 readToken(LevelDifference); 2630 else 2631 readTokenWithJavaScriptASI(); 2632 FormatTok->Previous = Previous; 2633 } 2634 2635 void UnwrappedLineParser::distributeComments( 2636 const SmallVectorImpl<FormatToken *> &Comments, 2637 const FormatToken *NextTok) { 2638 // Whether or not a line comment token continues a line is controlled by 2639 // the method continuesLineCommentSection, with the following caveat: 2640 // 2641 // Define a trail of Comments to be a nonempty proper postfix of Comments such 2642 // that each comment line from the trail is aligned with the next token, if 2643 // the next token exists. If a trail exists, the beginning of the maximal 2644 // trail is marked as a start of a new comment section. 2645 // 2646 // For example in this code: 2647 // 2648 // int a; // line about a 2649 // // line 1 about b 2650 // // line 2 about b 2651 // int b; 2652 // 2653 // the two lines about b form a maximal trail, so there are two sections, the 2654 // first one consisting of the single comment "// line about a" and the 2655 // second one consisting of the next two comments. 2656 if (Comments.empty()) 2657 return; 2658 bool ShouldPushCommentsInCurrentLine = true; 2659 bool HasTrailAlignedWithNextToken = false; 2660 unsigned StartOfTrailAlignedWithNextToken = 0; 2661 if (NextTok) { 2662 // We are skipping the first element intentionally. 2663 for (unsigned i = Comments.size() - 1; i > 0; --i) { 2664 if (Comments[i]->OriginalColumn == NextTok->OriginalColumn) { 2665 HasTrailAlignedWithNextToken = true; 2666 StartOfTrailAlignedWithNextToken = i; 2667 } 2668 } 2669 } 2670 for (unsigned i = 0, e = Comments.size(); i < e; ++i) { 2671 FormatToken *FormatTok = Comments[i]; 2672 if (HasTrailAlignedWithNextToken && i == StartOfTrailAlignedWithNextToken) { 2673 FormatTok->ContinuesLineCommentSection = false; 2674 } else { 2675 FormatTok->ContinuesLineCommentSection = 2676 continuesLineCommentSection(*FormatTok, *Line, CommentPragmasRegex); 2677 } 2678 if (!FormatTok->ContinuesLineCommentSection && 2679 (isOnNewLine(*FormatTok) || FormatTok->IsFirst)) { 2680 ShouldPushCommentsInCurrentLine = false; 2681 } 2682 if (ShouldPushCommentsInCurrentLine) { 2683 pushToken(FormatTok); 2684 } else { 2685 CommentsBeforeNextToken.push_back(FormatTok); 2686 } 2687 } 2688 } 2689 2690 void UnwrappedLineParser::readToken(int LevelDifference) { 2691 SmallVector<FormatToken *, 1> Comments; 2692 do { 2693 FormatTok = Tokens->getNextToken(); 2694 assert(FormatTok); 2695 while (!Line->InPPDirective && FormatTok->Tok.is(tok::hash) && 2696 (FormatTok->HasUnescapedNewline || FormatTok->IsFirst)) { 2697 distributeComments(Comments, FormatTok); 2698 Comments.clear(); 2699 // If there is an unfinished unwrapped line, we flush the preprocessor 2700 // directives only after that unwrapped line was finished later. 2701 bool SwitchToPreprocessorLines = !Line->Tokens.empty(); 2702 ScopedLineState BlockState(*this, SwitchToPreprocessorLines); 2703 assert((LevelDifference >= 0 || 2704 static_cast<unsigned>(-LevelDifference) <= Line->Level) && 2705 "LevelDifference makes Line->Level negative"); 2706 Line->Level += LevelDifference; 2707 // Comments stored before the preprocessor directive need to be output 2708 // before the preprocessor directive, at the same level as the 2709 // preprocessor directive, as we consider them to apply to the directive. 2710 if (Style.IndentPPDirectives == FormatStyle::PPDIS_BeforeHash && 2711 PPBranchLevel > 0) 2712 Line->Level += PPBranchLevel; 2713 flushComments(isOnNewLine(*FormatTok)); 2714 parsePPDirective(); 2715 } 2716 while (FormatTok->Type == TT_ConflictStart || 2717 FormatTok->Type == TT_ConflictEnd || 2718 FormatTok->Type == TT_ConflictAlternative) { 2719 if (FormatTok->Type == TT_ConflictStart) { 2720 conditionalCompilationStart(/*Unreachable=*/false); 2721 } else if (FormatTok->Type == TT_ConflictAlternative) { 2722 conditionalCompilationAlternative(); 2723 } else if (FormatTok->Type == TT_ConflictEnd) { 2724 conditionalCompilationEnd(); 2725 } 2726 FormatTok = Tokens->getNextToken(); 2727 FormatTok->MustBreakBefore = true; 2728 } 2729 2730 if (!PPStack.empty() && (PPStack.back().Kind == PP_Unreachable) && 2731 !Line->InPPDirective) { 2732 continue; 2733 } 2734 2735 if (!FormatTok->Tok.is(tok::comment)) { 2736 distributeComments(Comments, FormatTok); 2737 Comments.clear(); 2738 return; 2739 } 2740 2741 Comments.push_back(FormatTok); 2742 } while (!eof()); 2743 2744 distributeComments(Comments, nullptr); 2745 Comments.clear(); 2746 } 2747 2748 void UnwrappedLineParser::pushToken(FormatToken *Tok) { 2749 Line->Tokens.push_back(UnwrappedLineNode(Tok)); 2750 if (MustBreakBeforeNextToken) { 2751 Line->Tokens.back().Tok->MustBreakBefore = true; 2752 MustBreakBeforeNextToken = false; 2753 } 2754 } 2755 2756 } // end namespace format 2757 } // end namespace clang 2758