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