1 //===--- TokenAnnotator.cpp - Format C++ code -----------------------------===// 2 // 3 // The LLVM Compiler Infrastructure 4 // 5 // This file is distributed under the University of Illinois Open Source 6 // License. See LICENSE.TXT for details. 7 // 8 //===----------------------------------------------------------------------===// 9 /// 10 /// \file 11 /// \brief This file implements a token annotator, i.e. creates 12 /// \c AnnotatedTokens out of \c FormatTokens with required extra information. 13 /// 14 //===----------------------------------------------------------------------===// 15 16 #include "TokenAnnotator.h" 17 #include "clang/Basic/SourceManager.h" 18 #include "llvm/ADT/SmallPtrSet.h" 19 #include "llvm/Support/Debug.h" 20 21 #define DEBUG_TYPE "format-token-annotator" 22 23 namespace clang { 24 namespace format { 25 26 namespace { 27 28 /// \brief A parser that gathers additional information about tokens. 29 /// 30 /// The \c TokenAnnotator tries to match parenthesis and square brakets and 31 /// store a parenthesis levels. It also tries to resolve matching "<" and ">" 32 /// into template parameter lists. 33 class AnnotatingParser { 34 public: 35 AnnotatingParser(const FormatStyle &Style, AnnotatedLine &Line, 36 const AdditionalKeywords &Keywords) 37 : Style(Style), Line(Line), CurrentToken(Line.First), AutoFound(false), 38 Keywords(Keywords) { 39 Contexts.push_back(Context(tok::unknown, 1, /*IsExpression=*/false)); 40 resetTokenMetadata(CurrentToken); 41 } 42 43 private: 44 bool parseAngle() { 45 if (!CurrentToken) 46 return false; 47 FormatToken *Left = CurrentToken->Previous; 48 Left->ParentBracket = Contexts.back().ContextKind; 49 ScopedContextCreator ContextCreator(*this, tok::less, 10); 50 51 // If this angle is in the context of an expression, we need to be more 52 // hesitant to detect it as opening template parameters. 53 bool InExprContext = Contexts.back().IsExpression; 54 55 Contexts.back().IsExpression = false; 56 // If there's a template keyword before the opening angle bracket, this is a 57 // template parameter, not an argument. 58 Contexts.back().InTemplateArgument = 59 Left->Previous && Left->Previous->Tok.isNot(tok::kw_template); 60 61 if (Style.Language == FormatStyle::LK_Java && 62 CurrentToken->is(tok::question)) 63 next(); 64 65 while (CurrentToken) { 66 if (CurrentToken->is(tok::greater)) { 67 Left->MatchingParen = CurrentToken; 68 CurrentToken->MatchingParen = Left; 69 CurrentToken->Type = TT_TemplateCloser; 70 next(); 71 return true; 72 } 73 if (CurrentToken->is(tok::question) && 74 Style.Language == FormatStyle::LK_Java) { 75 next(); 76 continue; 77 } 78 if (CurrentToken->isOneOf(tok::r_paren, tok::r_square, tok::r_brace) || 79 (CurrentToken->isOneOf(tok::colon, tok::question) && InExprContext)) 80 return false; 81 // If a && or || is found and interpreted as a binary operator, this set 82 // of angles is likely part of something like "a < b && c > d". If the 83 // angles are inside an expression, the ||/&& might also be a binary 84 // operator that was misinterpreted because we are parsing template 85 // parameters. 86 // FIXME: This is getting out of hand, write a decent parser. 87 if (CurrentToken->Previous->isOneOf(tok::pipepipe, tok::ampamp) && 88 CurrentToken->Previous->is(TT_BinaryOperator) && 89 Contexts[Contexts.size() - 2].IsExpression && 90 !Line.startsWith(tok::kw_template)) 91 return false; 92 updateParameterCount(Left, CurrentToken); 93 if (!consumeToken()) 94 return false; 95 } 96 return false; 97 } 98 99 bool parseParens(bool LookForDecls = false) { 100 if (!CurrentToken) 101 return false; 102 FormatToken *Left = CurrentToken->Previous; 103 Left->ParentBracket = Contexts.back().ContextKind; 104 ScopedContextCreator ContextCreator(*this, tok::l_paren, 1); 105 106 // FIXME: This is a bit of a hack. Do better. 107 Contexts.back().ColonIsForRangeExpr = 108 Contexts.size() == 2 && Contexts[0].ColonIsForRangeExpr; 109 110 bool StartsObjCMethodExpr = false; 111 if (CurrentToken->is(tok::caret)) { 112 // (^ can start a block type. 113 Left->Type = TT_ObjCBlockLParen; 114 } else if (FormatToken *MaybeSel = Left->Previous) { 115 // @selector( starts a selector. 116 if (MaybeSel->isObjCAtKeyword(tok::objc_selector) && MaybeSel->Previous && 117 MaybeSel->Previous->is(tok::at)) { 118 StartsObjCMethodExpr = true; 119 } 120 } 121 122 if (Left->Previous && 123 (Left->Previous->isOneOf(tok::kw_static_assert, tok::kw_decltype, 124 tok::kw_if, tok::kw_while, tok::l_paren, 125 tok::comma) || 126 Left->Previous->is(TT_BinaryOperator))) { 127 // static_assert, if and while usually contain expressions. 128 Contexts.back().IsExpression = true; 129 } else if (Left->Previous && Left->Previous->is(tok::r_square) && 130 Left->Previous->MatchingParen && 131 Left->Previous->MatchingParen->is(TT_LambdaLSquare)) { 132 // This is a parameter list of a lambda expression. 133 Contexts.back().IsExpression = false; 134 } else if (Line.InPPDirective && 135 (!Left->Previous || 136 !Left->Previous->isOneOf(tok::identifier, 137 TT_OverloadedOperator))) { 138 Contexts.back().IsExpression = true; 139 } else if (Contexts[Contexts.size() - 2].CaretFound) { 140 // This is the parameter list of an ObjC block. 141 Contexts.back().IsExpression = false; 142 } else if (Left->Previous && Left->Previous->is(tok::kw___attribute)) { 143 Left->Type = TT_AttributeParen; 144 } else if (Left->Previous && Left->Previous->is(TT_ForEachMacro)) { 145 // The first argument to a foreach macro is a declaration. 146 Contexts.back().IsForEachMacro = true; 147 Contexts.back().IsExpression = false; 148 } else if (Left->Previous && Left->Previous->MatchingParen && 149 Left->Previous->MatchingParen->is(TT_ObjCBlockLParen)) { 150 Contexts.back().IsExpression = false; 151 } 152 153 if (StartsObjCMethodExpr) { 154 Contexts.back().ColonIsObjCMethodExpr = true; 155 Left->Type = TT_ObjCMethodExpr; 156 } 157 158 bool MightBeFunctionType = CurrentToken->isOneOf(tok::star, tok::amp); 159 bool HasMultipleLines = false; 160 bool HasMultipleParametersOnALine = false; 161 bool MightBeObjCForRangeLoop = 162 Left->Previous && Left->Previous->is(tok::kw_for); 163 while (CurrentToken) { 164 // LookForDecls is set when "if (" has been seen. Check for 165 // 'identifier' '*' 'identifier' followed by not '=' -- this 166 // '*' has to be a binary operator but determineStarAmpUsage() will 167 // categorize it as an unary operator, so set the right type here. 168 if (LookForDecls && CurrentToken->Next) { 169 FormatToken *Prev = CurrentToken->getPreviousNonComment(); 170 if (Prev) { 171 FormatToken *PrevPrev = Prev->getPreviousNonComment(); 172 FormatToken *Next = CurrentToken->Next; 173 if (PrevPrev && PrevPrev->is(tok::identifier) && 174 Prev->isOneOf(tok::star, tok::amp, tok::ampamp) && 175 CurrentToken->is(tok::identifier) && Next->isNot(tok::equal)) { 176 Prev->Type = TT_BinaryOperator; 177 LookForDecls = false; 178 } 179 } 180 } 181 182 if (CurrentToken->Previous->is(TT_PointerOrReference) && 183 CurrentToken->Previous->Previous->isOneOf(tok::l_paren, 184 tok::coloncolon)) 185 MightBeFunctionType = true; 186 if (CurrentToken->Previous->is(TT_BinaryOperator)) 187 Contexts.back().IsExpression = true; 188 if (CurrentToken->is(tok::r_paren)) { 189 if (MightBeFunctionType && CurrentToken->Next && 190 (CurrentToken->Next->is(tok::l_paren) || 191 (CurrentToken->Next->is(tok::l_square) && 192 !Contexts.back().IsExpression))) 193 Left->Type = TT_FunctionTypeLParen; 194 Left->MatchingParen = CurrentToken; 195 CurrentToken->MatchingParen = Left; 196 197 if (StartsObjCMethodExpr) { 198 CurrentToken->Type = TT_ObjCMethodExpr; 199 if (Contexts.back().FirstObjCSelectorName) { 200 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName = 201 Contexts.back().LongestObjCSelectorName; 202 } 203 } 204 205 if (Left->is(TT_AttributeParen)) 206 CurrentToken->Type = TT_AttributeParen; 207 if (Left->Previous && Left->Previous->is(TT_JavaAnnotation)) 208 CurrentToken->Type = TT_JavaAnnotation; 209 if (Left->Previous && Left->Previous->is(TT_LeadingJavaAnnotation)) 210 CurrentToken->Type = TT_LeadingJavaAnnotation; 211 212 if (!HasMultipleLines) 213 Left->PackingKind = PPK_Inconclusive; 214 else if (HasMultipleParametersOnALine) 215 Left->PackingKind = PPK_BinPacked; 216 else 217 Left->PackingKind = PPK_OnePerLine; 218 219 next(); 220 return true; 221 } 222 if (CurrentToken->isOneOf(tok::r_square, tok::r_brace)) 223 return false; 224 225 if (CurrentToken->is(tok::l_brace)) 226 Left->Type = TT_Unknown; // Not TT_ObjCBlockLParen 227 if (CurrentToken->is(tok::comma) && CurrentToken->Next && 228 !CurrentToken->Next->HasUnescapedNewline && 229 !CurrentToken->Next->isTrailingComment()) 230 HasMultipleParametersOnALine = true; 231 if (CurrentToken->isOneOf(tok::kw_const, tok::kw_auto) || 232 CurrentToken->isSimpleTypeSpecifier()) 233 Contexts.back().IsExpression = false; 234 if (CurrentToken->isOneOf(tok::semi, tok::colon)) 235 MightBeObjCForRangeLoop = false; 236 if (MightBeObjCForRangeLoop && CurrentToken->is(Keywords.kw_in)) 237 CurrentToken->Type = TT_ObjCForIn; 238 // When we discover a 'new', we set CanBeExpression to 'false' in order to 239 // parse the type correctly. Reset that after a comma. 240 if (CurrentToken->is(tok::comma)) 241 Contexts.back().CanBeExpression = true; 242 243 FormatToken *Tok = CurrentToken; 244 if (!consumeToken()) 245 return false; 246 updateParameterCount(Left, Tok); 247 if (CurrentToken && CurrentToken->HasUnescapedNewline) 248 HasMultipleLines = true; 249 } 250 return false; 251 } 252 253 bool parseSquare() { 254 if (!CurrentToken) 255 return false; 256 257 // A '[' could be an index subscript (after an identifier or after 258 // ')' or ']'), it could be the start of an Objective-C method 259 // expression, or it could the start of an Objective-C array literal. 260 FormatToken *Left = CurrentToken->Previous; 261 Left->ParentBracket = Contexts.back().ContextKind; 262 FormatToken *Parent = Left->getPreviousNonComment(); 263 bool StartsObjCMethodExpr = 264 Style.Language == FormatStyle::LK_Cpp && 265 Contexts.back().CanBeExpression && Left->isNot(TT_LambdaLSquare) && 266 CurrentToken->isNot(tok::l_brace) && 267 (!Parent || 268 Parent->isOneOf(tok::colon, tok::l_square, tok::l_paren, 269 tok::kw_return, tok::kw_throw) || 270 Parent->isUnaryOperator() || 271 Parent->isOneOf(TT_ObjCForIn, TT_CastRParen) || 272 getBinOpPrecedence(Parent->Tok.getKind(), true, true) > prec::Unknown); 273 bool ColonFound = false; 274 275 unsigned BindingIncrease = 1; 276 if (Left->is(TT_Unknown)) { 277 if (StartsObjCMethodExpr) { 278 Left->Type = TT_ObjCMethodExpr; 279 } else if (Style.Language == FormatStyle::LK_JavaScript && Parent && 280 Contexts.back().ContextKind == tok::l_brace && 281 Parent->isOneOf(tok::l_brace, tok::comma)) { 282 Left->Type = TT_JsComputedPropertyName; 283 } else if (Parent && 284 Parent->isOneOf(tok::at, tok::equal, tok::comma, tok::l_paren, 285 tok::l_square, tok::question, tok::colon, 286 tok::kw_return)) { 287 Left->Type = TT_ArrayInitializerLSquare; 288 } else { 289 BindingIncrease = 10; 290 Left->Type = TT_ArraySubscriptLSquare; 291 } 292 } 293 294 ScopedContextCreator ContextCreator(*this, tok::l_square, BindingIncrease); 295 Contexts.back().IsExpression = true; 296 Contexts.back().ColonIsObjCMethodExpr = StartsObjCMethodExpr; 297 298 while (CurrentToken) { 299 if (CurrentToken->is(tok::r_square)) { 300 if (CurrentToken->Next && CurrentToken->Next->is(tok::l_paren) && 301 Left->is(TT_ObjCMethodExpr)) { 302 // An ObjC method call is rarely followed by an open parenthesis. 303 // FIXME: Do we incorrectly label ":" with this? 304 StartsObjCMethodExpr = false; 305 Left->Type = TT_Unknown; 306 } 307 if (StartsObjCMethodExpr && CurrentToken->Previous != Left) { 308 CurrentToken->Type = TT_ObjCMethodExpr; 309 // determineStarAmpUsage() thinks that '*' '[' is allocating an 310 // array of pointers, but if '[' starts a selector then '*' is a 311 // binary operator. 312 if (Parent && Parent->is(TT_PointerOrReference)) 313 Parent->Type = TT_BinaryOperator; 314 } 315 Left->MatchingParen = CurrentToken; 316 CurrentToken->MatchingParen = Left; 317 if (Contexts.back().FirstObjCSelectorName) { 318 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName = 319 Contexts.back().LongestObjCSelectorName; 320 if (Left->BlockParameterCount > 1) 321 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName = 0; 322 } 323 next(); 324 return true; 325 } 326 if (CurrentToken->isOneOf(tok::r_paren, tok::r_brace)) 327 return false; 328 if (CurrentToken->is(tok::colon)) { 329 if (Left->is(TT_ArraySubscriptLSquare)) { 330 Left->Type = TT_ObjCMethodExpr; 331 StartsObjCMethodExpr = true; 332 Contexts.back().ColonIsObjCMethodExpr = true; 333 if (Parent && Parent->is(tok::r_paren)) 334 Parent->Type = TT_CastRParen; 335 } 336 ColonFound = true; 337 } 338 if (CurrentToken->is(tok::comma) && Left->is(TT_ObjCMethodExpr) && 339 !ColonFound) 340 Left->Type = TT_ArrayInitializerLSquare; 341 FormatToken *Tok = CurrentToken; 342 if (!consumeToken()) 343 return false; 344 updateParameterCount(Left, Tok); 345 } 346 return false; 347 } 348 349 bool parseBrace() { 350 if (CurrentToken) { 351 FormatToken *Left = CurrentToken->Previous; 352 Left->ParentBracket = Contexts.back().ContextKind; 353 354 if (Contexts.back().CaretFound) 355 Left->Type = TT_ObjCBlockLBrace; 356 Contexts.back().CaretFound = false; 357 358 ScopedContextCreator ContextCreator(*this, tok::l_brace, 1); 359 Contexts.back().ColonIsDictLiteral = true; 360 if (Left->BlockKind == BK_BracedInit) 361 Contexts.back().IsExpression = true; 362 363 while (CurrentToken) { 364 if (CurrentToken->is(tok::r_brace)) { 365 Left->MatchingParen = CurrentToken; 366 CurrentToken->MatchingParen = Left; 367 next(); 368 return true; 369 } 370 if (CurrentToken->isOneOf(tok::r_paren, tok::r_square)) 371 return false; 372 updateParameterCount(Left, CurrentToken); 373 if (CurrentToken->isOneOf(tok::colon, tok::l_brace)) { 374 FormatToken *Previous = CurrentToken->getPreviousNonComment(); 375 if (((CurrentToken->is(tok::colon) && 376 (!Contexts.back().ColonIsDictLiteral || 377 Style.Language != FormatStyle::LK_Cpp)) || 378 Style.Language == FormatStyle::LK_Proto) && 379 Previous->Tok.getIdentifierInfo()) 380 Previous->Type = TT_SelectorName; 381 if (CurrentToken->is(tok::colon) || 382 Style.Language == FormatStyle::LK_JavaScript) 383 Left->Type = TT_DictLiteral; 384 } 385 if (!consumeToken()) 386 return false; 387 } 388 } 389 return true; 390 } 391 392 void updateParameterCount(FormatToken *Left, FormatToken *Current) { 393 if (Current->is(tok::l_brace) && !Current->is(TT_DictLiteral)) 394 ++Left->BlockParameterCount; 395 if (Current->is(tok::comma)) { 396 ++Left->ParameterCount; 397 if (!Left->Role) 398 Left->Role.reset(new CommaSeparatedList(Style)); 399 Left->Role->CommaFound(Current); 400 } else if (Left->ParameterCount == 0 && Current->isNot(tok::comment)) { 401 Left->ParameterCount = 1; 402 } 403 } 404 405 bool parseConditional() { 406 while (CurrentToken) { 407 if (CurrentToken->is(tok::colon)) { 408 CurrentToken->Type = TT_ConditionalExpr; 409 next(); 410 return true; 411 } 412 if (!consumeToken()) 413 return false; 414 } 415 return false; 416 } 417 418 bool parseTemplateDeclaration() { 419 if (CurrentToken && CurrentToken->is(tok::less)) { 420 CurrentToken->Type = TT_TemplateOpener; 421 next(); 422 if (!parseAngle()) 423 return false; 424 if (CurrentToken) 425 CurrentToken->Previous->ClosesTemplateDeclaration = true; 426 return true; 427 } 428 return false; 429 } 430 431 bool consumeToken() { 432 FormatToken *Tok = CurrentToken; 433 next(); 434 switch (Tok->Tok.getKind()) { 435 case tok::plus: 436 case tok::minus: 437 if (!Tok->Previous && Line.MustBeDeclaration) 438 Tok->Type = TT_ObjCMethodSpecifier; 439 break; 440 case tok::colon: 441 if (!Tok->Previous) 442 return false; 443 // Colons from ?: are handled in parseConditional(). 444 if (Style.Language == FormatStyle::LK_JavaScript) { 445 if (Contexts.back().ColonIsForRangeExpr || // colon in for loop 446 (Contexts.size() == 1 && // switch/case labels 447 !Line.First->isOneOf(tok::kw_enum, tok::kw_case)) || 448 Contexts.back().ContextKind == tok::l_paren || // function params 449 Contexts.back().ContextKind == tok::l_square || // array type 450 (Contexts.size() == 1 && 451 Line.MustBeDeclaration)) { // method/property declaration 452 Tok->Type = TT_JsTypeColon; 453 break; 454 } 455 } 456 if (Contexts.back().ColonIsDictLiteral) { 457 Tok->Type = TT_DictLiteral; 458 } else if (Contexts.back().ColonIsObjCMethodExpr || 459 Line.startsWith(TT_ObjCMethodSpecifier)) { 460 Tok->Type = TT_ObjCMethodExpr; 461 Tok->Previous->Type = TT_SelectorName; 462 if (Tok->Previous->ColumnWidth > 463 Contexts.back().LongestObjCSelectorName) { 464 Contexts.back().LongestObjCSelectorName = Tok->Previous->ColumnWidth; 465 } 466 if (!Contexts.back().FirstObjCSelectorName) 467 Contexts.back().FirstObjCSelectorName = Tok->Previous; 468 } else if (Contexts.back().ColonIsForRangeExpr) { 469 Tok->Type = TT_RangeBasedForLoopColon; 470 } else if (CurrentToken && CurrentToken->is(tok::numeric_constant)) { 471 Tok->Type = TT_BitFieldColon; 472 } else if (Contexts.size() == 1 && 473 !Line.First->isOneOf(tok::kw_enum, tok::kw_case)) { 474 if (Tok->Previous->is(tok::r_paren)) 475 Tok->Type = TT_CtorInitializerColon; 476 else 477 Tok->Type = TT_InheritanceColon; 478 } else if (Tok->Previous->is(tok::identifier) && Tok->Next && 479 Tok->Next->isOneOf(tok::r_paren, tok::comma)) { 480 // This handles a special macro in ObjC code where selectors including 481 // the colon are passed as macro arguments. 482 Tok->Type = TT_ObjCMethodExpr; 483 } else if (Contexts.back().ContextKind == tok::l_paren) { 484 Tok->Type = TT_InlineASMColon; 485 } 486 break; 487 case tok::kw_if: 488 case tok::kw_while: 489 if (CurrentToken && CurrentToken->is(tok::l_paren)) { 490 next(); 491 if (!parseParens(/*LookForDecls=*/true)) 492 return false; 493 } 494 break; 495 case tok::kw_for: 496 Contexts.back().ColonIsForRangeExpr = true; 497 next(); 498 if (!parseParens()) 499 return false; 500 break; 501 case tok::l_paren: 502 // When faced with 'operator()()', the kw_operator handler incorrectly 503 // marks the first l_paren as a OverloadedOperatorLParen. Here, we make 504 // the first two parens OverloadedOperators and the second l_paren an 505 // OverloadedOperatorLParen. 506 if (Tok->Previous && 507 Tok->Previous->is(tok::r_paren) && 508 Tok->Previous->MatchingParen && 509 Tok->Previous->MatchingParen->is(TT_OverloadedOperatorLParen)) { 510 Tok->Previous->Type = TT_OverloadedOperator; 511 Tok->Previous->MatchingParen->Type = TT_OverloadedOperator; 512 Tok->Type = TT_OverloadedOperatorLParen; 513 } 514 515 if (!parseParens()) 516 return false; 517 if (Line.MustBeDeclaration && Contexts.size() == 1 && 518 !Contexts.back().IsExpression && !Line.startsWith(TT_ObjCProperty) && 519 (!Tok->Previous || 520 !Tok->Previous->isOneOf(tok::kw_decltype, tok::kw___attribute, 521 TT_LeadingJavaAnnotation))) 522 Line.MightBeFunctionDecl = true; 523 break; 524 case tok::l_square: 525 if (!parseSquare()) 526 return false; 527 break; 528 case tok::l_brace: 529 if (!parseBrace()) 530 return false; 531 break; 532 case tok::less: 533 if (!NonTemplateLess.count(Tok) && 534 (!Tok->Previous || 535 (!Tok->Previous->Tok.isLiteral() && 536 !(Tok->Previous->is(tok::r_paren) && Contexts.size() > 1))) && 537 parseAngle()) { 538 Tok->Type = TT_TemplateOpener; 539 } else { 540 Tok->Type = TT_BinaryOperator; 541 NonTemplateLess.insert(Tok); 542 CurrentToken = Tok; 543 next(); 544 } 545 break; 546 case tok::r_paren: 547 case tok::r_square: 548 return false; 549 case tok::r_brace: 550 // Lines can start with '}'. 551 if (Tok->Previous) 552 return false; 553 break; 554 case tok::greater: 555 Tok->Type = TT_BinaryOperator; 556 break; 557 case tok::kw_operator: 558 while (CurrentToken && 559 !CurrentToken->isOneOf(tok::l_paren, tok::semi, tok::r_paren)) { 560 if (CurrentToken->isOneOf(tok::star, tok::amp)) 561 CurrentToken->Type = TT_PointerOrReference; 562 consumeToken(); 563 if (CurrentToken && CurrentToken->Previous->is(TT_BinaryOperator)) 564 CurrentToken->Previous->Type = TT_OverloadedOperator; 565 } 566 if (CurrentToken) { 567 CurrentToken->Type = TT_OverloadedOperatorLParen; 568 if (CurrentToken->Previous->is(TT_BinaryOperator)) 569 CurrentToken->Previous->Type = TT_OverloadedOperator; 570 } 571 break; 572 case tok::question: 573 if (Style.Language == FormatStyle::LK_JavaScript && Tok->Next && 574 Tok->Next->isOneOf(tok::semi, tok::comma, tok::colon, tok::r_paren, 575 tok::r_brace)) { 576 // Question marks before semicolons, colons, etc. indicate optional 577 // types (fields, parameters), e.g. 578 // function(x?: string, y?) {...} 579 // class X { y?; } 580 Tok->Type = TT_JsTypeOptionalQuestion; 581 break; 582 } 583 // Declarations cannot be conditional expressions, this can only be part 584 // of a type declaration. 585 if (Line.MustBeDeclaration && 586 Style.Language == FormatStyle::LK_JavaScript) 587 break; 588 parseConditional(); 589 break; 590 case tok::kw_template: 591 parseTemplateDeclaration(); 592 break; 593 case tok::comma: 594 if (Contexts.back().InCtorInitializer) 595 Tok->Type = TT_CtorInitializerComma; 596 else if (Contexts.back().FirstStartOfName && 597 (Contexts.size() == 1 || Line.startsWith(tok::kw_for))) { 598 Contexts.back().FirstStartOfName->PartOfMultiVariableDeclStmt = true; 599 Line.IsMultiVariableDeclStmt = true; 600 } 601 if (Contexts.back().IsForEachMacro) 602 Contexts.back().IsExpression = true; 603 break; 604 default: 605 break; 606 } 607 return true; 608 } 609 610 void parseIncludeDirective() { 611 if (CurrentToken && CurrentToken->is(tok::less)) { 612 next(); 613 while (CurrentToken) { 614 if (CurrentToken->isNot(tok::comment) || CurrentToken->Next) 615 CurrentToken->Type = TT_ImplicitStringLiteral; 616 next(); 617 } 618 } 619 } 620 621 void parseWarningOrError() { 622 next(); 623 // We still want to format the whitespace left of the first token of the 624 // warning or error. 625 next(); 626 while (CurrentToken) { 627 CurrentToken->Type = TT_ImplicitStringLiteral; 628 next(); 629 } 630 } 631 632 void parsePragma() { 633 next(); // Consume "pragma". 634 if (CurrentToken && 635 CurrentToken->isOneOf(Keywords.kw_mark, Keywords.kw_option)) { 636 bool IsMark = CurrentToken->is(Keywords.kw_mark); 637 next(); // Consume "mark". 638 next(); // Consume first token (so we fix leading whitespace). 639 while (CurrentToken) { 640 if (IsMark || CurrentToken->Previous->is(TT_BinaryOperator)) 641 CurrentToken->Type = TT_ImplicitStringLiteral; 642 next(); 643 } 644 } 645 } 646 647 LineType parsePreprocessorDirective() { 648 LineType Type = LT_PreprocessorDirective; 649 next(); 650 if (!CurrentToken) 651 return Type; 652 if (CurrentToken->Tok.is(tok::numeric_constant)) { 653 CurrentToken->SpacesRequiredBefore = 1; 654 return Type; 655 } 656 // Hashes in the middle of a line can lead to any strange token 657 // sequence. 658 if (!CurrentToken->Tok.getIdentifierInfo()) 659 return Type; 660 switch (CurrentToken->Tok.getIdentifierInfo()->getPPKeywordID()) { 661 case tok::pp_include: 662 case tok::pp_include_next: 663 case tok::pp_import: 664 next(); 665 parseIncludeDirective(); 666 Type = LT_ImportStatement; 667 break; 668 case tok::pp_error: 669 case tok::pp_warning: 670 parseWarningOrError(); 671 break; 672 case tok::pp_pragma: 673 parsePragma(); 674 break; 675 case tok::pp_if: 676 case tok::pp_elif: 677 Contexts.back().IsExpression = true; 678 parseLine(); 679 break; 680 default: 681 break; 682 } 683 while (CurrentToken) 684 next(); 685 return Type; 686 } 687 688 public: 689 LineType parseLine() { 690 NonTemplateLess.clear(); 691 if (CurrentToken->is(tok::hash)) 692 return parsePreprocessorDirective(); 693 694 // Directly allow to 'import <string-literal>' to support protocol buffer 695 // definitions (code.google.com/p/protobuf) or missing "#" (either way we 696 // should not break the line). 697 IdentifierInfo *Info = CurrentToken->Tok.getIdentifierInfo(); 698 if ((Style.Language == FormatStyle::LK_Java && 699 CurrentToken->is(Keywords.kw_package)) || 700 (Info && Info->getPPKeywordID() == tok::pp_import && 701 CurrentToken->Next && 702 CurrentToken->Next->isOneOf(tok::string_literal, tok::identifier, 703 tok::kw_static))) { 704 next(); 705 parseIncludeDirective(); 706 return LT_ImportStatement; 707 } 708 709 // If this line starts and ends in '<' and '>', respectively, it is likely 710 // part of "#define <a/b.h>". 711 if (CurrentToken->is(tok::less) && Line.Last->is(tok::greater)) { 712 parseIncludeDirective(); 713 return LT_ImportStatement; 714 } 715 716 // In .proto files, top-level options are very similar to import statements 717 // and should not be line-wrapped. 718 if (Style.Language == FormatStyle::LK_Proto && Line.Level == 0 && 719 CurrentToken->is(Keywords.kw_option)) { 720 next(); 721 if (CurrentToken && CurrentToken->is(tok::identifier)) 722 return LT_ImportStatement; 723 } 724 725 bool KeywordVirtualFound = false; 726 bool ImportStatement = false; 727 while (CurrentToken) { 728 if (CurrentToken->is(tok::kw_virtual)) 729 KeywordVirtualFound = true; 730 if (isImportStatement(*CurrentToken)) 731 ImportStatement = true; 732 if (!consumeToken()) 733 return LT_Invalid; 734 } 735 if (KeywordVirtualFound) 736 return LT_VirtualFunctionDecl; 737 if (ImportStatement) 738 return LT_ImportStatement; 739 740 if (Line.startsWith(TT_ObjCMethodSpecifier)) { 741 if (Contexts.back().FirstObjCSelectorName) 742 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName = 743 Contexts.back().LongestObjCSelectorName; 744 return LT_ObjCMethodDecl; 745 } 746 747 return LT_Other; 748 } 749 750 private: 751 bool isImportStatement(const FormatToken &Tok) { 752 // FIXME: Closure-library specific stuff should not be hard-coded but be 753 // configurable. 754 return Style.Language == FormatStyle::LK_JavaScript && 755 Tok.TokenText == "goog" && Tok.Next && Tok.Next->is(tok::period) && 756 Tok.Next->Next && (Tok.Next->Next->TokenText == "module" || 757 Tok.Next->Next->TokenText == "provide" || 758 Tok.Next->Next->TokenText == "require" || 759 Tok.Next->Next->TokenText == "setTestOnly") && 760 Tok.Next->Next->Next && Tok.Next->Next->Next->is(tok::l_paren); 761 } 762 763 void resetTokenMetadata(FormatToken *Token) { 764 if (!Token) 765 return; 766 767 // Reset token type in case we have already looked at it and then 768 // recovered from an error (e.g. failure to find the matching >). 769 if (!CurrentToken->isOneOf(TT_LambdaLSquare, TT_ForEachMacro, 770 TT_FunctionLBrace, TT_ImplicitStringLiteral, 771 TT_InlineASMBrace, TT_JsFatArrow, TT_LambdaArrow, 772 TT_RegexLiteral)) 773 CurrentToken->Type = TT_Unknown; 774 CurrentToken->Role.reset(); 775 CurrentToken->MatchingParen = nullptr; 776 CurrentToken->FakeLParens.clear(); 777 CurrentToken->FakeRParens = 0; 778 } 779 780 void next() { 781 if (CurrentToken) { 782 CurrentToken->NestingLevel = Contexts.size() - 1; 783 CurrentToken->BindingStrength = Contexts.back().BindingStrength; 784 modifyContext(*CurrentToken); 785 determineTokenType(*CurrentToken); 786 CurrentToken = CurrentToken->Next; 787 } 788 789 resetTokenMetadata(CurrentToken); 790 } 791 792 /// \brief A struct to hold information valid in a specific context, e.g. 793 /// a pair of parenthesis. 794 struct Context { 795 Context(tok::TokenKind ContextKind, unsigned BindingStrength, 796 bool IsExpression) 797 : ContextKind(ContextKind), BindingStrength(BindingStrength), 798 IsExpression(IsExpression) {} 799 800 tok::TokenKind ContextKind; 801 unsigned BindingStrength; 802 bool IsExpression; 803 unsigned LongestObjCSelectorName = 0; 804 bool ColonIsForRangeExpr = false; 805 bool ColonIsDictLiteral = false; 806 bool ColonIsObjCMethodExpr = false; 807 FormatToken *FirstObjCSelectorName = nullptr; 808 FormatToken *FirstStartOfName = nullptr; 809 bool CanBeExpression = true; 810 bool InTemplateArgument = false; 811 bool InCtorInitializer = false; 812 bool CaretFound = false; 813 bool IsForEachMacro = false; 814 }; 815 816 /// \brief Puts a new \c Context onto the stack \c Contexts for the lifetime 817 /// of each instance. 818 struct ScopedContextCreator { 819 AnnotatingParser &P; 820 821 ScopedContextCreator(AnnotatingParser &P, tok::TokenKind ContextKind, 822 unsigned Increase) 823 : P(P) { 824 P.Contexts.push_back(Context(ContextKind, 825 P.Contexts.back().BindingStrength + Increase, 826 P.Contexts.back().IsExpression)); 827 } 828 829 ~ScopedContextCreator() { P.Contexts.pop_back(); } 830 }; 831 832 void modifyContext(const FormatToken &Current) { 833 if (Current.getPrecedence() == prec::Assignment && 834 !Line.First->isOneOf(tok::kw_template, tok::kw_using) && 835 (!Current.Previous || Current.Previous->isNot(tok::kw_operator))) { 836 Contexts.back().IsExpression = true; 837 if (!Line.startsWith(TT_UnaryOperator)) { 838 for (FormatToken *Previous = Current.Previous; 839 Previous && Previous->Previous && 840 !Previous->Previous->isOneOf(tok::comma, tok::semi); 841 Previous = Previous->Previous) { 842 if (Previous->isOneOf(tok::r_square, tok::r_paren)) { 843 Previous = Previous->MatchingParen; 844 if (!Previous) 845 break; 846 } 847 if (Previous->opensScope()) 848 break; 849 if (Previous->isOneOf(TT_BinaryOperator, TT_UnaryOperator) && 850 Previous->isOneOf(tok::star, tok::amp, tok::ampamp) && 851 Previous->Previous && Previous->Previous->isNot(tok::equal)) 852 Previous->Type = TT_PointerOrReference; 853 } 854 } 855 } else if (Current.is(tok::lessless) && 856 (!Current.Previous || !Current.Previous->is(tok::kw_operator))) { 857 Contexts.back().IsExpression = true; 858 } else if (Current.isOneOf(tok::kw_return, tok::kw_throw)) { 859 Contexts.back().IsExpression = true; 860 } else if (Current.is(TT_TrailingReturnArrow)) { 861 Contexts.back().IsExpression = false; 862 } else if (Current.is(TT_LambdaArrow) || Current.is(Keywords.kw_assert)) { 863 Contexts.back().IsExpression = Style.Language == FormatStyle::LK_Java; 864 } else if (Current.is(tok::l_paren) && !Line.MustBeDeclaration && 865 !Line.InPPDirective && 866 (!Current.Previous || 867 Current.Previous->isNot(tok::kw_decltype))) { 868 bool ParametersOfFunctionType = 869 Current.Previous && Current.Previous->is(tok::r_paren) && 870 Current.Previous->MatchingParen && 871 Current.Previous->MatchingParen->is(TT_FunctionTypeLParen); 872 bool IsForOrCatch = Current.Previous && 873 Current.Previous->isOneOf(tok::kw_for, tok::kw_catch); 874 Contexts.back().IsExpression = !ParametersOfFunctionType && !IsForOrCatch; 875 } else if (Current.isOneOf(tok::r_paren, tok::greater, tok::comma)) { 876 for (FormatToken *Previous = Current.Previous; 877 Previous && Previous->isOneOf(tok::star, tok::amp); 878 Previous = Previous->Previous) 879 Previous->Type = TT_PointerOrReference; 880 if (Line.MustBeDeclaration) 881 Contexts.back().IsExpression = Contexts.front().InCtorInitializer; 882 } else if (Current.Previous && 883 Current.Previous->is(TT_CtorInitializerColon)) { 884 Contexts.back().IsExpression = true; 885 Contexts.back().InCtorInitializer = true; 886 } else if (Current.is(tok::kw_new)) { 887 Contexts.back().CanBeExpression = false; 888 } else if (Current.isOneOf(tok::semi, tok::exclaim)) { 889 // This should be the condition or increment in a for-loop. 890 Contexts.back().IsExpression = true; 891 } 892 } 893 894 void determineTokenType(FormatToken &Current) { 895 if (!Current.is(TT_Unknown)) 896 // The token type is already known. 897 return; 898 899 // Line.MightBeFunctionDecl can only be true after the parentheses of a 900 // function declaration have been found. In this case, 'Current' is a 901 // trailing token of this declaration and thus cannot be a name. 902 if (Current.is(Keywords.kw_instanceof)) { 903 Current.Type = TT_BinaryOperator; 904 } else if (isStartOfName(Current) && 905 (!Line.MightBeFunctionDecl || Current.NestingLevel != 0)) { 906 Contexts.back().FirstStartOfName = &Current; 907 Current.Type = TT_StartOfName; 908 } else if (Current.isOneOf(tok::kw_auto, tok::kw___auto_type)) { 909 AutoFound = true; 910 } else if (Current.is(tok::arrow) && 911 Style.Language == FormatStyle::LK_Java) { 912 Current.Type = TT_LambdaArrow; 913 } else if (Current.is(tok::arrow) && AutoFound && Line.MustBeDeclaration && 914 Current.NestingLevel == 0) { 915 Current.Type = TT_TrailingReturnArrow; 916 } else if (Current.isOneOf(tok::star, tok::amp, tok::ampamp)) { 917 Current.Type = 918 determineStarAmpUsage(Current, Contexts.back().CanBeExpression && 919 Contexts.back().IsExpression, 920 Contexts.back().InTemplateArgument); 921 } else if (Current.isOneOf(tok::minus, tok::plus, tok::caret)) { 922 Current.Type = determinePlusMinusCaretUsage(Current); 923 if (Current.is(TT_UnaryOperator) && Current.is(tok::caret)) 924 Contexts.back().CaretFound = true; 925 } else if (Current.isOneOf(tok::minusminus, tok::plusplus)) { 926 Current.Type = determineIncrementUsage(Current); 927 } else if (Current.isOneOf(tok::exclaim, tok::tilde)) { 928 Current.Type = TT_UnaryOperator; 929 } else if (Current.is(tok::question)) { 930 if (Style.Language == FormatStyle::LK_JavaScript && 931 Line.MustBeDeclaration) { 932 // In JavaScript, `interface X { foo?(): bar; }` is an optional method 933 // on the interface, not a ternary expression. 934 Current.Type = TT_JsTypeOptionalQuestion; 935 } else { 936 Current.Type = TT_ConditionalExpr; 937 } 938 } else if (Current.isBinaryOperator() && 939 (!Current.Previous || Current.Previous->isNot(tok::l_square))) { 940 Current.Type = TT_BinaryOperator; 941 } else if (Current.is(tok::comment)) { 942 if (Current.TokenText.startswith("/*")) { 943 if (Current.TokenText.endswith("*/")) 944 Current.Type = TT_BlockComment; 945 else 946 // The lexer has for some reason determined a comment here. But we 947 // cannot really handle it, if it isn't properly terminated. 948 Current.Tok.setKind(tok::unknown); 949 } else { 950 Current.Type = TT_LineComment; 951 } 952 } else if (Current.is(tok::r_paren)) { 953 if (rParenEndsCast(Current)) 954 Current.Type = TT_CastRParen; 955 if (Current.MatchingParen && Current.Next && 956 !Current.Next->isBinaryOperator() && 957 !Current.Next->isOneOf(tok::semi, tok::colon, tok::l_brace)) 958 if (FormatToken *BeforeParen = Current.MatchingParen->Previous) 959 if (BeforeParen->is(tok::identifier) && 960 BeforeParen->TokenText == BeforeParen->TokenText.upper() && 961 (!BeforeParen->Previous || 962 BeforeParen->Previous->ClosesTemplateDeclaration)) 963 Current.Type = TT_FunctionAnnotationRParen; 964 } else if (Current.is(tok::at) && Current.Next) { 965 if (Current.Next->isStringLiteral()) { 966 Current.Type = TT_ObjCStringLiteral; 967 } else { 968 switch (Current.Next->Tok.getObjCKeywordID()) { 969 case tok::objc_interface: 970 case tok::objc_implementation: 971 case tok::objc_protocol: 972 Current.Type = TT_ObjCDecl; 973 break; 974 case tok::objc_property: 975 Current.Type = TT_ObjCProperty; 976 break; 977 default: 978 break; 979 } 980 } 981 } else if (Current.is(tok::period)) { 982 FormatToken *PreviousNoComment = Current.getPreviousNonComment(); 983 if (PreviousNoComment && 984 PreviousNoComment->isOneOf(tok::comma, tok::l_brace)) 985 Current.Type = TT_DesignatedInitializerPeriod; 986 else if (Style.Language == FormatStyle::LK_Java && Current.Previous && 987 Current.Previous->isOneOf(TT_JavaAnnotation, 988 TT_LeadingJavaAnnotation)) { 989 Current.Type = Current.Previous->Type; 990 } 991 } else if (Current.isOneOf(tok::identifier, tok::kw_const) && 992 Current.Previous && 993 !Current.Previous->isOneOf(tok::equal, tok::at) && 994 Line.MightBeFunctionDecl && Contexts.size() == 1) { 995 // Line.MightBeFunctionDecl can only be true after the parentheses of a 996 // function declaration have been found. 997 Current.Type = TT_TrailingAnnotation; 998 } else if ((Style.Language == FormatStyle::LK_Java || 999 Style.Language == FormatStyle::LK_JavaScript) && 1000 Current.Previous) { 1001 if (Current.Previous->is(tok::at) && 1002 Current.isNot(Keywords.kw_interface)) { 1003 const FormatToken &AtToken = *Current.Previous; 1004 const FormatToken *Previous = AtToken.getPreviousNonComment(); 1005 if (!Previous || Previous->is(TT_LeadingJavaAnnotation)) 1006 Current.Type = TT_LeadingJavaAnnotation; 1007 else 1008 Current.Type = TT_JavaAnnotation; 1009 } else if (Current.Previous->is(tok::period) && 1010 Current.Previous->isOneOf(TT_JavaAnnotation, 1011 TT_LeadingJavaAnnotation)) { 1012 Current.Type = Current.Previous->Type; 1013 } 1014 } 1015 } 1016 1017 /// \brief Take a guess at whether \p Tok starts a name of a function or 1018 /// variable declaration. 1019 /// 1020 /// This is a heuristic based on whether \p Tok is an identifier following 1021 /// something that is likely a type. 1022 bool isStartOfName(const FormatToken &Tok) { 1023 if (Tok.isNot(tok::identifier) || !Tok.Previous) 1024 return false; 1025 1026 if (Tok.Previous->isOneOf(TT_LeadingJavaAnnotation, Keywords.kw_instanceof)) 1027 return false; 1028 1029 // Skip "const" as it does not have an influence on whether this is a name. 1030 FormatToken *PreviousNotConst = Tok.Previous; 1031 while (PreviousNotConst && PreviousNotConst->is(tok::kw_const)) 1032 PreviousNotConst = PreviousNotConst->Previous; 1033 1034 if (!PreviousNotConst) 1035 return false; 1036 1037 bool IsPPKeyword = PreviousNotConst->is(tok::identifier) && 1038 PreviousNotConst->Previous && 1039 PreviousNotConst->Previous->is(tok::hash); 1040 1041 if (PreviousNotConst->is(TT_TemplateCloser)) 1042 return PreviousNotConst && PreviousNotConst->MatchingParen && 1043 PreviousNotConst->MatchingParen->Previous && 1044 PreviousNotConst->MatchingParen->Previous->isNot(tok::period) && 1045 PreviousNotConst->MatchingParen->Previous->isNot(tok::kw_template); 1046 1047 if (PreviousNotConst->is(tok::r_paren) && PreviousNotConst->MatchingParen && 1048 PreviousNotConst->MatchingParen->Previous && 1049 PreviousNotConst->MatchingParen->Previous->is(tok::kw_decltype)) 1050 return true; 1051 1052 return (!IsPPKeyword && 1053 PreviousNotConst->isOneOf(tok::identifier, tok::kw_auto)) || 1054 PreviousNotConst->is(TT_PointerOrReference) || 1055 PreviousNotConst->isSimpleTypeSpecifier(); 1056 } 1057 1058 /// \brief Determine whether ')' is ending a cast. 1059 bool rParenEndsCast(const FormatToken &Tok) { 1060 // C-style casts are only used in C++ and Java. 1061 if (Style.Language != FormatStyle::LK_Cpp && 1062 Style.Language != FormatStyle::LK_Java) 1063 return false; 1064 1065 // Empty parens aren't casts and there are no casts at the end of the line. 1066 if (Tok.Previous == Tok.MatchingParen || !Tok.Next || !Tok.MatchingParen) 1067 return false; 1068 1069 FormatToken *LeftOfParens = Tok.MatchingParen->getPreviousNonComment(); 1070 if (LeftOfParens) { 1071 // If there is an opening parenthesis left of the current parentheses, 1072 // look past it as these might be chained casts. 1073 if (LeftOfParens->is(tok::r_paren)) { 1074 if (!LeftOfParens->MatchingParen || 1075 !LeftOfParens->MatchingParen->Previous) 1076 return false; 1077 LeftOfParens = LeftOfParens->MatchingParen->Previous; 1078 } 1079 1080 // If there is an identifier (or with a few exceptions a keyword) right 1081 // before the parentheses, this is unlikely to be a cast. 1082 if (LeftOfParens->Tok.getIdentifierInfo() && 1083 !LeftOfParens->isOneOf(Keywords.kw_in, tok::kw_return, tok::kw_case, 1084 tok::kw_delete)) 1085 return false; 1086 1087 // Certain other tokens right before the parentheses are also signals that 1088 // this cannot be a cast. 1089 if (LeftOfParens->isOneOf(tok::at, tok::r_square, TT_OverloadedOperator, 1090 TT_TemplateCloser)) 1091 return false; 1092 } 1093 1094 if (Tok.Next->is(tok::question)) 1095 return false; 1096 1097 // As Java has no function types, a "(" after the ")" likely means that this 1098 // is a cast. 1099 if (Style.Language == FormatStyle::LK_Java && Tok.Next->is(tok::l_paren)) 1100 return true; 1101 1102 // If a (non-string) literal follows, this is likely a cast. 1103 if (Tok.Next->isNot(tok::string_literal) && 1104 (Tok.Next->Tok.isLiteral() || 1105 Tok.Next->isOneOf(tok::kw_sizeof, tok::kw_alignof))) 1106 return true; 1107 1108 // Heuristically try to determine whether the parentheses contain a type. 1109 bool ParensAreType = 1110 !Tok.Previous || 1111 Tok.Previous->isOneOf(TT_PointerOrReference, TT_TemplateCloser) || 1112 Tok.Previous->isSimpleTypeSpecifier(); 1113 bool ParensCouldEndDecl = 1114 Tok.Next->isOneOf(tok::equal, tok::semi, tok::l_brace, tok::greater); 1115 if (ParensAreType && !ParensCouldEndDecl && 1116 (Contexts.size() > 1 && Contexts[Contexts.size() - 2].IsExpression)) 1117 return true; 1118 1119 // At this point, we heuristically assume that there are no casts at the 1120 // start of the line. We assume that we have found most cases where there 1121 // are by the logic above, e.g. "(void)x;". 1122 if (!LeftOfParens) 1123 return false; 1124 1125 // If the following token is an identifier, this is a cast. All cases where 1126 // this can be something else are handled above. 1127 if (Tok.Next->is(tok::identifier)) 1128 return true; 1129 1130 if (!Tok.Next->Next) 1131 return false; 1132 1133 // If the next token after the parenthesis is a unary operator, assume 1134 // that this is cast, unless there are unexpected tokens inside the 1135 // parenthesis. 1136 bool NextIsUnary = 1137 Tok.Next->isUnaryOperator() || Tok.Next->isOneOf(tok::amp, tok::star); 1138 if (!NextIsUnary || Tok.Next->is(tok::plus) || 1139 !Tok.Next->Next->isOneOf(tok::identifier, tok::numeric_constant)) 1140 return false; 1141 // Search for unexpected tokens. 1142 for (FormatToken *Prev = Tok.Previous; Prev != Tok.MatchingParen; 1143 Prev = Prev->Previous) { 1144 if (!Prev->isOneOf(tok::kw_const, tok::identifier, tok::coloncolon)) 1145 return false; 1146 } 1147 return true; 1148 } 1149 1150 /// \brief Return the type of the given token assuming it is * or &. 1151 TokenType determineStarAmpUsage(const FormatToken &Tok, bool IsExpression, 1152 bool InTemplateArgument) { 1153 if (Style.Language == FormatStyle::LK_JavaScript) 1154 return TT_BinaryOperator; 1155 1156 const FormatToken *PrevToken = Tok.getPreviousNonComment(); 1157 if (!PrevToken) 1158 return TT_UnaryOperator; 1159 1160 const FormatToken *NextToken = Tok.getNextNonComment(); 1161 if (!NextToken || 1162 NextToken->isOneOf(tok::arrow, Keywords.kw_final, 1163 Keywords.kw_override) || 1164 (NextToken->is(tok::l_brace) && !NextToken->getNextNonComment())) 1165 return TT_PointerOrReference; 1166 1167 if (PrevToken->is(tok::coloncolon)) 1168 return TT_PointerOrReference; 1169 1170 if (PrevToken->isOneOf(tok::l_paren, tok::l_square, tok::l_brace, 1171 tok::comma, tok::semi, tok::kw_return, tok::colon, 1172 tok::equal, tok::kw_delete, tok::kw_sizeof) || 1173 PrevToken->isOneOf(TT_BinaryOperator, TT_ConditionalExpr, 1174 TT_UnaryOperator, TT_CastRParen)) 1175 return TT_UnaryOperator; 1176 1177 if (NextToken->is(tok::l_square) && NextToken->isNot(TT_LambdaLSquare)) 1178 return TT_PointerOrReference; 1179 if (NextToken->is(tok::kw_operator) && !IsExpression) 1180 return TT_PointerOrReference; 1181 if (NextToken->isOneOf(tok::comma, tok::semi)) 1182 return TT_PointerOrReference; 1183 1184 if (PrevToken->is(tok::r_paren) && PrevToken->MatchingParen && 1185 PrevToken->MatchingParen->Previous && 1186 PrevToken->MatchingParen->Previous->isOneOf(tok::kw_typeof, 1187 tok::kw_decltype)) 1188 return TT_PointerOrReference; 1189 1190 if (PrevToken->Tok.isLiteral() || 1191 PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::kw_true, 1192 tok::kw_false, tok::r_brace) || 1193 NextToken->Tok.isLiteral() || 1194 NextToken->isOneOf(tok::kw_true, tok::kw_false) || 1195 NextToken->isUnaryOperator() || 1196 // If we know we're in a template argument, there are no named 1197 // declarations. Thus, having an identifier on the right-hand side 1198 // indicates a binary operator. 1199 (InTemplateArgument && NextToken->Tok.isAnyIdentifier())) 1200 return TT_BinaryOperator; 1201 1202 // "&&(" is quite unlikely to be two successive unary "&". 1203 if (Tok.is(tok::ampamp) && NextToken && NextToken->is(tok::l_paren)) 1204 return TT_BinaryOperator; 1205 1206 // This catches some cases where evaluation order is used as control flow: 1207 // aaa && aaa->f(); 1208 const FormatToken *NextNextToken = NextToken->getNextNonComment(); 1209 if (NextNextToken && NextNextToken->is(tok::arrow)) 1210 return TT_BinaryOperator; 1211 1212 // It is very unlikely that we are going to find a pointer or reference type 1213 // definition on the RHS of an assignment. 1214 if (IsExpression && !Contexts.back().CaretFound) 1215 return TT_BinaryOperator; 1216 1217 return TT_PointerOrReference; 1218 } 1219 1220 TokenType determinePlusMinusCaretUsage(const FormatToken &Tok) { 1221 const FormatToken *PrevToken = Tok.getPreviousNonComment(); 1222 if (!PrevToken || PrevToken->is(TT_CastRParen)) 1223 return TT_UnaryOperator; 1224 1225 // Use heuristics to recognize unary operators. 1226 if (PrevToken->isOneOf(tok::equal, tok::l_paren, tok::comma, tok::l_square, 1227 tok::question, tok::colon, tok::kw_return, 1228 tok::kw_case, tok::at, tok::l_brace)) 1229 return TT_UnaryOperator; 1230 1231 // There can't be two consecutive binary operators. 1232 if (PrevToken->is(TT_BinaryOperator)) 1233 return TT_UnaryOperator; 1234 1235 // Fall back to marking the token as binary operator. 1236 return TT_BinaryOperator; 1237 } 1238 1239 /// \brief Determine whether ++/-- are pre- or post-increments/-decrements. 1240 TokenType determineIncrementUsage(const FormatToken &Tok) { 1241 const FormatToken *PrevToken = Tok.getPreviousNonComment(); 1242 if (!PrevToken || PrevToken->is(TT_CastRParen)) 1243 return TT_UnaryOperator; 1244 if (PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::identifier)) 1245 return TT_TrailingUnaryOperator; 1246 1247 return TT_UnaryOperator; 1248 } 1249 1250 SmallVector<Context, 8> Contexts; 1251 1252 const FormatStyle &Style; 1253 AnnotatedLine &Line; 1254 FormatToken *CurrentToken; 1255 bool AutoFound; 1256 const AdditionalKeywords &Keywords; 1257 1258 // Set of "<" tokens that do not open a template parameter list. If parseAngle 1259 // determines that a specific token can't be a template opener, it will make 1260 // same decision irrespective of the decisions for tokens leading up to it. 1261 // Store this information to prevent this from causing exponential runtime. 1262 llvm::SmallPtrSet<FormatToken *, 16> NonTemplateLess; 1263 }; 1264 1265 static const int PrecedenceUnaryOperator = prec::PointerToMember + 1; 1266 static const int PrecedenceArrowAndPeriod = prec::PointerToMember + 2; 1267 1268 /// \brief Parses binary expressions by inserting fake parenthesis based on 1269 /// operator precedence. 1270 class ExpressionParser { 1271 public: 1272 ExpressionParser(const FormatStyle &Style, const AdditionalKeywords &Keywords, 1273 AnnotatedLine &Line) 1274 : Style(Style), Keywords(Keywords), Current(Line.First) {} 1275 1276 /// \brief Parse expressions with the given operatore precedence. 1277 void parse(int Precedence = 0) { 1278 // Skip 'return' and ObjC selector colons as they are not part of a binary 1279 // expression. 1280 while (Current && (Current->is(tok::kw_return) || 1281 (Current->is(tok::colon) && 1282 Current->isOneOf(TT_ObjCMethodExpr, TT_DictLiteral)))) 1283 next(); 1284 1285 if (!Current || Precedence > PrecedenceArrowAndPeriod) 1286 return; 1287 1288 // Conditional expressions need to be parsed separately for proper nesting. 1289 if (Precedence == prec::Conditional) { 1290 parseConditionalExpr(); 1291 return; 1292 } 1293 1294 // Parse unary operators, which all have a higher precedence than binary 1295 // operators. 1296 if (Precedence == PrecedenceUnaryOperator) { 1297 parseUnaryOperator(); 1298 return; 1299 } 1300 1301 FormatToken *Start = Current; 1302 FormatToken *LatestOperator = nullptr; 1303 unsigned OperatorIndex = 0; 1304 1305 while (Current) { 1306 // Consume operators with higher precedence. 1307 parse(Precedence + 1); 1308 1309 int CurrentPrecedence = getCurrentPrecedence(); 1310 1311 if (Current && Current->is(TT_SelectorName) && 1312 Precedence == CurrentPrecedence) { 1313 if (LatestOperator) 1314 addFakeParenthesis(Start, prec::Level(Precedence)); 1315 Start = Current; 1316 } 1317 1318 // At the end of the line or when an operator with higher precedence is 1319 // found, insert fake parenthesis and return. 1320 if (!Current || (Current->closesScope() && Current->MatchingParen) || 1321 (CurrentPrecedence != -1 && CurrentPrecedence < Precedence) || 1322 (CurrentPrecedence == prec::Conditional && 1323 Precedence == prec::Assignment && Current->is(tok::colon))) { 1324 break; 1325 } 1326 1327 // Consume scopes: (), [], <> and {} 1328 if (Current->opensScope()) { 1329 while (Current && !Current->closesScope()) { 1330 next(); 1331 parse(); 1332 } 1333 next(); 1334 } else { 1335 // Operator found. 1336 if (CurrentPrecedence == Precedence) { 1337 LatestOperator = Current; 1338 Current->OperatorIndex = OperatorIndex; 1339 ++OperatorIndex; 1340 } 1341 next(/*SkipPastLeadingComments=*/Precedence > 0); 1342 } 1343 } 1344 1345 if (LatestOperator && (Current || Precedence > 0)) { 1346 LatestOperator->LastOperator = true; 1347 if (Precedence == PrecedenceArrowAndPeriod) { 1348 // Call expressions don't have a binary operator precedence. 1349 addFakeParenthesis(Start, prec::Unknown); 1350 } else { 1351 addFakeParenthesis(Start, prec::Level(Precedence)); 1352 } 1353 } 1354 } 1355 1356 private: 1357 /// \brief Gets the precedence (+1) of the given token for binary operators 1358 /// and other tokens that we treat like binary operators. 1359 int getCurrentPrecedence() { 1360 if (Current) { 1361 const FormatToken *NextNonComment = Current->getNextNonComment(); 1362 if (Current->is(TT_ConditionalExpr)) 1363 return prec::Conditional; 1364 if (NextNonComment && NextNonComment->is(tok::colon) && 1365 NextNonComment->is(TT_DictLiteral)) 1366 return prec::Comma; 1367 if (Current->is(TT_LambdaArrow)) 1368 return prec::Comma; 1369 if (Current->is(TT_JsFatArrow)) 1370 return prec::Assignment; 1371 if (Current->isOneOf(tok::semi, TT_InlineASMColon, TT_SelectorName, 1372 TT_JsComputedPropertyName) || 1373 (Current->is(tok::comment) && NextNonComment && 1374 NextNonComment->is(TT_SelectorName))) 1375 return 0; 1376 if (Current->is(TT_RangeBasedForLoopColon)) 1377 return prec::Comma; 1378 if ((Style.Language == FormatStyle::LK_Java || 1379 Style.Language == FormatStyle::LK_JavaScript) && 1380 Current->is(Keywords.kw_instanceof)) 1381 return prec::Relational; 1382 if (Current->is(TT_BinaryOperator) || Current->is(tok::comma)) 1383 return Current->getPrecedence(); 1384 if (Current->isOneOf(tok::period, tok::arrow)) 1385 return PrecedenceArrowAndPeriod; 1386 if (Style.Language == FormatStyle::LK_Java && 1387 Current->isOneOf(Keywords.kw_extends, Keywords.kw_implements, 1388 Keywords.kw_throws)) 1389 return 0; 1390 } 1391 return -1; 1392 } 1393 1394 void addFakeParenthesis(FormatToken *Start, prec::Level Precedence) { 1395 Start->FakeLParens.push_back(Precedence); 1396 if (Precedence > prec::Unknown) 1397 Start->StartsBinaryExpression = true; 1398 if (Current) { 1399 FormatToken *Previous = Current->Previous; 1400 while (Previous->is(tok::comment) && Previous->Previous) 1401 Previous = Previous->Previous; 1402 ++Previous->FakeRParens; 1403 if (Precedence > prec::Unknown) 1404 Previous->EndsBinaryExpression = true; 1405 } 1406 } 1407 1408 /// \brief Parse unary operator expressions and surround them with fake 1409 /// parentheses if appropriate. 1410 void parseUnaryOperator() { 1411 if (!Current || Current->isNot(TT_UnaryOperator)) { 1412 parse(PrecedenceArrowAndPeriod); 1413 return; 1414 } 1415 1416 FormatToken *Start = Current; 1417 next(); 1418 parseUnaryOperator(); 1419 1420 // The actual precedence doesn't matter. 1421 addFakeParenthesis(Start, prec::Unknown); 1422 } 1423 1424 void parseConditionalExpr() { 1425 while (Current && Current->isTrailingComment()) { 1426 next(); 1427 } 1428 FormatToken *Start = Current; 1429 parse(prec::LogicalOr); 1430 if (!Current || !Current->is(tok::question)) 1431 return; 1432 next(); 1433 parse(prec::Assignment); 1434 if (!Current || Current->isNot(TT_ConditionalExpr)) 1435 return; 1436 next(); 1437 parse(prec::Assignment); 1438 addFakeParenthesis(Start, prec::Conditional); 1439 } 1440 1441 void next(bool SkipPastLeadingComments = true) { 1442 if (Current) 1443 Current = Current->Next; 1444 while (Current && 1445 (Current->NewlinesBefore == 0 || SkipPastLeadingComments) && 1446 Current->isTrailingComment()) 1447 Current = Current->Next; 1448 } 1449 1450 const FormatStyle &Style; 1451 const AdditionalKeywords &Keywords; 1452 FormatToken *Current; 1453 }; 1454 1455 } // end anonymous namespace 1456 1457 void TokenAnnotator::setCommentLineLevels( 1458 SmallVectorImpl<AnnotatedLine *> &Lines) { 1459 const AnnotatedLine *NextNonCommentLine = nullptr; 1460 for (SmallVectorImpl<AnnotatedLine *>::reverse_iterator I = Lines.rbegin(), 1461 E = Lines.rend(); 1462 I != E; ++I) { 1463 if (NextNonCommentLine && (*I)->First->is(tok::comment) && 1464 (*I)->First->Next == nullptr) 1465 (*I)->Level = NextNonCommentLine->Level; 1466 else 1467 NextNonCommentLine = (*I)->First->isNot(tok::r_brace) ? (*I) : nullptr; 1468 1469 setCommentLineLevels((*I)->Children); 1470 } 1471 } 1472 1473 void TokenAnnotator::annotate(AnnotatedLine &Line) { 1474 for (SmallVectorImpl<AnnotatedLine *>::iterator I = Line.Children.begin(), 1475 E = Line.Children.end(); 1476 I != E; ++I) { 1477 annotate(**I); 1478 } 1479 AnnotatingParser Parser(Style, Line, Keywords); 1480 Line.Type = Parser.parseLine(); 1481 if (Line.Type == LT_Invalid) 1482 return; 1483 1484 ExpressionParser ExprParser(Style, Keywords, Line); 1485 ExprParser.parse(); 1486 1487 if (Line.startsWith(TT_ObjCMethodSpecifier)) 1488 Line.Type = LT_ObjCMethodDecl; 1489 else if (Line.startsWith(TT_ObjCDecl)) 1490 Line.Type = LT_ObjCDecl; 1491 else if (Line.startsWith(TT_ObjCProperty)) 1492 Line.Type = LT_ObjCProperty; 1493 1494 Line.First->SpacesRequiredBefore = 1; 1495 Line.First->CanBreakBefore = Line.First->MustBreakBefore; 1496 } 1497 1498 // This function heuristically determines whether 'Current' starts the name of a 1499 // function declaration. 1500 static bool isFunctionDeclarationName(const FormatToken &Current) { 1501 auto skipOperatorName = [](const FormatToken* Next) -> const FormatToken* { 1502 for (; Next; Next = Next->Next) { 1503 if (Next->is(TT_OverloadedOperatorLParen)) 1504 return Next; 1505 if (Next->is(TT_OverloadedOperator)) 1506 continue; 1507 if (Next->isOneOf(tok::kw_new, tok::kw_delete)) { 1508 // For 'new[]' and 'delete[]'. 1509 if (Next->Next && Next->Next->is(tok::l_square) && 1510 Next->Next->Next && Next->Next->Next->is(tok::r_square)) 1511 Next = Next->Next->Next; 1512 continue; 1513 } 1514 1515 break; 1516 } 1517 return nullptr; 1518 }; 1519 1520 const FormatToken *Next = Current.Next; 1521 if (Current.is(tok::kw_operator)) { 1522 if (Current.Previous && Current.Previous->is(tok::coloncolon)) 1523 return false; 1524 Next = skipOperatorName(Next); 1525 } else { 1526 if (!Current.is(TT_StartOfName) || Current.NestingLevel != 0) 1527 return false; 1528 for (; Next; Next = Next->Next) { 1529 if (Next->is(TT_TemplateOpener)) { 1530 Next = Next->MatchingParen; 1531 } else if (Next->is(tok::coloncolon)) { 1532 Next = Next->Next; 1533 if (!Next) 1534 return false; 1535 if (Next->is(tok::kw_operator)) { 1536 Next = skipOperatorName(Next->Next); 1537 break; 1538 } 1539 if (!Next->is(tok::identifier)) 1540 return false; 1541 } else if (Next->is(tok::l_paren)) { 1542 break; 1543 } else { 1544 return false; 1545 } 1546 } 1547 } 1548 1549 if (!Next || !Next->is(tok::l_paren)) 1550 return false; 1551 if (Next->Next == Next->MatchingParen) 1552 return true; 1553 for (const FormatToken *Tok = Next->Next; Tok && Tok != Next->MatchingParen; 1554 Tok = Tok->Next) { 1555 if (Tok->is(tok::kw_const) || Tok->isSimpleTypeSpecifier() || 1556 Tok->isOneOf(TT_PointerOrReference, TT_StartOfName)) 1557 return true; 1558 if (Tok->isOneOf(tok::l_brace, tok::string_literal, TT_ObjCMethodExpr) || 1559 Tok->Tok.isLiteral()) 1560 return false; 1561 } 1562 return false; 1563 } 1564 1565 void TokenAnnotator::calculateFormattingInformation(AnnotatedLine &Line) { 1566 for (SmallVectorImpl<AnnotatedLine *>::iterator I = Line.Children.begin(), 1567 E = Line.Children.end(); 1568 I != E; ++I) { 1569 calculateFormattingInformation(**I); 1570 } 1571 1572 Line.First->TotalLength = 1573 Line.First->IsMultiline ? Style.ColumnLimit : Line.First->ColumnWidth; 1574 if (!Line.First->Next) 1575 return; 1576 FormatToken *Current = Line.First->Next; 1577 bool InFunctionDecl = Line.MightBeFunctionDecl; 1578 while (Current) { 1579 if (isFunctionDeclarationName(*Current)) 1580 Current->Type = TT_FunctionDeclarationName; 1581 if (Current->is(TT_LineComment)) { 1582 if (Current->Previous->BlockKind == BK_BracedInit && 1583 Current->Previous->opensScope()) 1584 Current->SpacesRequiredBefore = Style.Cpp11BracedListStyle ? 0 : 1; 1585 else 1586 Current->SpacesRequiredBefore = Style.SpacesBeforeTrailingComments; 1587 1588 // If we find a trailing comment, iterate backwards to determine whether 1589 // it seems to relate to a specific parameter. If so, break before that 1590 // parameter to avoid changing the comment's meaning. E.g. don't move 'b' 1591 // to the previous line in: 1592 // SomeFunction(a, 1593 // b, // comment 1594 // c); 1595 if (!Current->HasUnescapedNewline) { 1596 for (FormatToken *Parameter = Current->Previous; Parameter; 1597 Parameter = Parameter->Previous) { 1598 if (Parameter->isOneOf(tok::comment, tok::r_brace)) 1599 break; 1600 if (Parameter->Previous && Parameter->Previous->is(tok::comma)) { 1601 if (!Parameter->Previous->is(TT_CtorInitializerComma) && 1602 Parameter->HasUnescapedNewline) 1603 Parameter->MustBreakBefore = true; 1604 break; 1605 } 1606 } 1607 } 1608 } else if (Current->SpacesRequiredBefore == 0 && 1609 spaceRequiredBefore(Line, *Current)) { 1610 Current->SpacesRequiredBefore = 1; 1611 } 1612 1613 Current->MustBreakBefore = 1614 Current->MustBreakBefore || mustBreakBefore(Line, *Current); 1615 1616 if ((Style.AlwaysBreakAfterDefinitionReturnType == FormatStyle::DRTBS_All || 1617 (Style.AlwaysBreakAfterDefinitionReturnType == 1618 FormatStyle::DRTBS_TopLevel && 1619 Line.Level == 0)) && 1620 InFunctionDecl && Current->is(TT_FunctionDeclarationName) && 1621 !Line.Last->isOneOf(tok::semi, tok::comment)) // Only for definitions. 1622 // FIXME: Line.Last points to other characters than tok::semi 1623 // and tok::lbrace. 1624 Current->MustBreakBefore = true; 1625 1626 Current->CanBreakBefore = 1627 Current->MustBreakBefore || canBreakBefore(Line, *Current); 1628 unsigned ChildSize = 0; 1629 if (Current->Previous->Children.size() == 1) { 1630 FormatToken &LastOfChild = *Current->Previous->Children[0]->Last; 1631 ChildSize = LastOfChild.isTrailingComment() ? Style.ColumnLimit 1632 : LastOfChild.TotalLength + 1; 1633 } 1634 const FormatToken *Prev = Current->Previous; 1635 if (Current->MustBreakBefore || Prev->Children.size() > 1 || 1636 (Prev->Children.size() == 1 && 1637 Prev->Children[0]->First->MustBreakBefore) || 1638 Current->IsMultiline) 1639 Current->TotalLength = Prev->TotalLength + Style.ColumnLimit; 1640 else 1641 Current->TotalLength = Prev->TotalLength + Current->ColumnWidth + 1642 ChildSize + Current->SpacesRequiredBefore; 1643 1644 if (Current->is(TT_CtorInitializerColon)) 1645 InFunctionDecl = false; 1646 1647 // FIXME: Only calculate this if CanBreakBefore is true once static 1648 // initializers etc. are sorted out. 1649 // FIXME: Move magic numbers to a better place. 1650 Current->SplitPenalty = 20 * Current->BindingStrength + 1651 splitPenalty(Line, *Current, InFunctionDecl); 1652 1653 Current = Current->Next; 1654 } 1655 1656 calculateUnbreakableTailLengths(Line); 1657 for (Current = Line.First; Current != nullptr; Current = Current->Next) { 1658 if (Current->Role) 1659 Current->Role->precomputeFormattingInfos(Current); 1660 } 1661 1662 DEBUG({ printDebugInfo(Line); }); 1663 } 1664 1665 void TokenAnnotator::calculateUnbreakableTailLengths(AnnotatedLine &Line) { 1666 unsigned UnbreakableTailLength = 0; 1667 FormatToken *Current = Line.Last; 1668 while (Current) { 1669 Current->UnbreakableTailLength = UnbreakableTailLength; 1670 if (Current->CanBreakBefore || 1671 Current->isOneOf(tok::comment, tok::string_literal)) { 1672 UnbreakableTailLength = 0; 1673 } else { 1674 UnbreakableTailLength += 1675 Current->ColumnWidth + Current->SpacesRequiredBefore; 1676 } 1677 Current = Current->Previous; 1678 } 1679 } 1680 1681 unsigned TokenAnnotator::splitPenalty(const AnnotatedLine &Line, 1682 const FormatToken &Tok, 1683 bool InFunctionDecl) { 1684 const FormatToken &Left = *Tok.Previous; 1685 const FormatToken &Right = Tok; 1686 1687 if (Left.is(tok::semi)) 1688 return 0; 1689 1690 if (Style.Language == FormatStyle::LK_Java) { 1691 if (Right.isOneOf(Keywords.kw_extends, Keywords.kw_throws)) 1692 return 1; 1693 if (Right.is(Keywords.kw_implements)) 1694 return 2; 1695 if (Left.is(tok::comma) && Left.NestingLevel == 0) 1696 return 3; 1697 } else if (Style.Language == FormatStyle::LK_JavaScript) { 1698 if (Right.is(Keywords.kw_function) && Left.isNot(tok::comma)) 1699 return 100; 1700 if (Left.is(TT_JsTypeColon)) 1701 return 100; 1702 } 1703 1704 if (Left.is(tok::comma) || (Right.is(tok::identifier) && Right.Next && 1705 Right.Next->is(TT_DictLiteral))) 1706 return 1; 1707 if (Right.is(tok::l_square)) { 1708 if (Style.Language == FormatStyle::LK_Proto) 1709 return 1; 1710 // Slightly prefer formatting local lambda definitions like functions. 1711 if (Right.is(TT_LambdaLSquare) && Left.is(tok::equal)) 1712 return 50; 1713 if (!Right.isOneOf(TT_ObjCMethodExpr, TT_LambdaLSquare, 1714 TT_ArrayInitializerLSquare)) 1715 return 500; 1716 } 1717 1718 if (Right.isOneOf(TT_StartOfName, TT_FunctionDeclarationName) || 1719 Right.is(tok::kw_operator)) { 1720 if (Line.startsWith(tok::kw_for) && Right.PartOfMultiVariableDeclStmt) 1721 return 3; 1722 if (Left.is(TT_StartOfName)) 1723 return 110; 1724 if (InFunctionDecl && Right.NestingLevel == 0) 1725 return Style.PenaltyReturnTypeOnItsOwnLine; 1726 return 200; 1727 } 1728 if (Right.is(TT_PointerOrReference)) 1729 return 190; 1730 if (Right.is(TT_LambdaArrow)) 1731 return 110; 1732 if (Left.is(tok::equal) && Right.is(tok::l_brace)) 1733 return 150; 1734 if (Left.is(TT_CastRParen)) 1735 return 100; 1736 if (Left.is(tok::coloncolon) || 1737 (Right.is(tok::period) && Style.Language == FormatStyle::LK_Proto)) 1738 return 500; 1739 if (Left.isOneOf(tok::kw_class, tok::kw_struct)) 1740 return 5000; 1741 1742 if (Left.isOneOf(TT_RangeBasedForLoopColon, TT_InheritanceColon)) 1743 return 2; 1744 1745 if (Right.isMemberAccess()) { 1746 if (Left.is(tok::r_paren) && Left.MatchingParen && 1747 Left.MatchingParen->ParameterCount > 0) 1748 return 20; // Should be smaller than breaking at a nested comma. 1749 return 150; 1750 } 1751 1752 if (Right.is(TT_TrailingAnnotation) && 1753 (!Right.Next || Right.Next->isNot(tok::l_paren))) { 1754 // Moving trailing annotations to the next line is fine for ObjC method 1755 // declarations. 1756 if (Line.startsWith(TT_ObjCMethodSpecifier)) 1757 return 10; 1758 // Generally, breaking before a trailing annotation is bad unless it is 1759 // function-like. It seems to be especially preferable to keep standard 1760 // annotations (i.e. "const", "final" and "override") on the same line. 1761 // Use a slightly higher penalty after ")" so that annotations like 1762 // "const override" are kept together. 1763 bool is_short_annotation = Right.TokenText.size() < 10; 1764 return (Left.is(tok::r_paren) ? 100 : 120) + (is_short_annotation ? 50 : 0); 1765 } 1766 1767 // In for-loops, prefer breaking at ',' and ';'. 1768 if (Line.startsWith(tok::kw_for) && Left.is(tok::equal)) 1769 return 4; 1770 1771 // In Objective-C method expressions, prefer breaking before "param:" over 1772 // breaking after it. 1773 if (Right.is(TT_SelectorName)) 1774 return 0; 1775 if (Left.is(tok::colon) && Left.is(TT_ObjCMethodExpr)) 1776 return Line.MightBeFunctionDecl ? 50 : 500; 1777 1778 if (Left.is(tok::l_paren) && InFunctionDecl && 1779 Style.AlignAfterOpenBracket != FormatStyle::BAS_DontAlign) 1780 return 100; 1781 if (Left.is(tok::l_paren) && Left.Previous && 1782 Left.Previous->isOneOf(tok::kw_if, tok::kw_for)) 1783 return 1000; 1784 if (Left.is(tok::equal) && InFunctionDecl) 1785 return 110; 1786 if (Right.is(tok::r_brace)) 1787 return 1; 1788 if (Left.is(TT_TemplateOpener)) 1789 return 100; 1790 if (Left.opensScope()) { 1791 if (Style.AlignAfterOpenBracket == FormatStyle::BAS_DontAlign) 1792 return 0; 1793 return Left.ParameterCount > 1 ? Style.PenaltyBreakBeforeFirstCallParameter 1794 : 19; 1795 } 1796 if (Left.is(TT_JavaAnnotation)) 1797 return 50; 1798 1799 if (Right.is(tok::lessless)) { 1800 if (Left.is(tok::string_literal) && 1801 (!Right.LastOperator || Right.OperatorIndex != 1)) { 1802 StringRef Content = Left.TokenText; 1803 if (Content.startswith("\"")) 1804 Content = Content.drop_front(1); 1805 if (Content.endswith("\"")) 1806 Content = Content.drop_back(1); 1807 Content = Content.trim(); 1808 if (Content.size() > 1 && 1809 (Content.back() == ':' || Content.back() == '=')) 1810 return 25; 1811 } 1812 return 1; // Breaking at a << is really cheap. 1813 } 1814 if (Left.is(TT_ConditionalExpr)) 1815 return prec::Conditional; 1816 prec::Level Level = Left.getPrecedence(); 1817 if (Level != prec::Unknown) 1818 return Level; 1819 Level = Right.getPrecedence(); 1820 if (Level != prec::Unknown) 1821 return Level; 1822 1823 return 3; 1824 } 1825 1826 bool TokenAnnotator::spaceRequiredBetween(const AnnotatedLine &Line, 1827 const FormatToken &Left, 1828 const FormatToken &Right) { 1829 if (Left.is(tok::kw_return) && Right.isNot(tok::semi)) 1830 return true; 1831 if (Style.ObjCSpaceAfterProperty && Line.Type == LT_ObjCProperty && 1832 Left.Tok.getObjCKeywordID() == tok::objc_property) 1833 return true; 1834 if (Right.is(tok::hashhash)) 1835 return Left.is(tok::hash); 1836 if (Left.isOneOf(tok::hashhash, tok::hash)) 1837 return Right.is(tok::hash); 1838 if (Left.is(tok::l_paren) && Right.is(tok::r_paren)) 1839 return Style.SpaceInEmptyParentheses; 1840 if (Left.is(tok::l_paren) || Right.is(tok::r_paren)) 1841 return (Right.is(TT_CastRParen) || 1842 (Left.MatchingParen && Left.MatchingParen->is(TT_CastRParen))) 1843 ? Style.SpacesInCStyleCastParentheses 1844 : Style.SpacesInParentheses; 1845 if (Right.isOneOf(tok::semi, tok::comma)) 1846 return false; 1847 if (Right.is(tok::less) && 1848 (Left.is(tok::kw_template) || 1849 (Line.Type == LT_ObjCDecl && Style.ObjCSpaceBeforeProtocolList))) 1850 return true; 1851 if (Left.isOneOf(tok::exclaim, tok::tilde)) 1852 return false; 1853 if (Left.is(tok::at) && 1854 Right.isOneOf(tok::identifier, tok::string_literal, tok::char_constant, 1855 tok::numeric_constant, tok::l_paren, tok::l_brace, 1856 tok::kw_true, tok::kw_false)) 1857 return false; 1858 if (Left.is(tok::coloncolon)) 1859 return false; 1860 if (Left.is(tok::less) || Right.isOneOf(tok::greater, tok::less)) 1861 return false; 1862 if (Right.is(tok::ellipsis)) 1863 return Left.Tok.isLiteral(); 1864 if (Left.is(tok::l_square) && Right.is(tok::amp)) 1865 return false; 1866 if (Right.is(TT_PointerOrReference)) 1867 return (Left.is(tok::r_paren) && Left.MatchingParen && 1868 (Left.MatchingParen->is(TT_OverloadedOperatorLParen) || 1869 (Left.MatchingParen->Previous && 1870 Left.MatchingParen->Previous->is(TT_FunctionDeclarationName)))) || 1871 (Left.Tok.isLiteral() || 1872 (!Left.isOneOf(TT_PointerOrReference, tok::l_paren) && 1873 (Style.PointerAlignment != FormatStyle::PAS_Left || 1874 Line.IsMultiVariableDeclStmt))); 1875 if (Right.is(TT_FunctionTypeLParen) && Left.isNot(tok::l_paren) && 1876 (!Left.is(TT_PointerOrReference) || 1877 (Style.PointerAlignment != FormatStyle::PAS_Right && 1878 !Line.IsMultiVariableDeclStmt))) 1879 return true; 1880 if (Left.is(TT_PointerOrReference)) 1881 return Right.Tok.isLiteral() || 1882 Right.isOneOf(TT_BlockComment, Keywords.kw_final, 1883 Keywords.kw_override) || 1884 (Right.is(tok::l_brace) && Right.BlockKind == BK_Block) || 1885 (!Right.isOneOf(TT_PointerOrReference, TT_ArraySubscriptLSquare, 1886 tok::l_paren) && 1887 (Style.PointerAlignment != FormatStyle::PAS_Right && 1888 !Line.IsMultiVariableDeclStmt) && 1889 Left.Previous && 1890 !Left.Previous->isOneOf(tok::l_paren, tok::coloncolon)); 1891 if (Right.is(tok::star) && Left.is(tok::l_paren)) 1892 return false; 1893 if (Left.is(tok::l_square)) 1894 return (Left.is(TT_ArrayInitializerLSquare) && 1895 Style.SpacesInContainerLiterals && Right.isNot(tok::r_square)) || 1896 (Left.is(TT_ArraySubscriptLSquare) && Style.SpacesInSquareBrackets && 1897 Right.isNot(tok::r_square)); 1898 if (Right.is(tok::r_square)) 1899 return Right.MatchingParen && 1900 ((Style.SpacesInContainerLiterals && 1901 Right.MatchingParen->is(TT_ArrayInitializerLSquare)) || 1902 (Style.SpacesInSquareBrackets && 1903 Right.MatchingParen->is(TT_ArraySubscriptLSquare))); 1904 if (Right.is(tok::l_square) && 1905 !Right.isOneOf(TT_ObjCMethodExpr, TT_LambdaLSquare) && 1906 !Left.isOneOf(tok::numeric_constant, TT_DictLiteral)) 1907 return false; 1908 if (Left.is(tok::colon)) 1909 return !Left.is(TT_ObjCMethodExpr); 1910 if (Left.is(tok::l_brace) && Right.is(tok::r_brace)) 1911 return !Left.Children.empty(); // No spaces in "{}". 1912 if ((Left.is(tok::l_brace) && Left.BlockKind != BK_Block) || 1913 (Right.is(tok::r_brace) && Right.MatchingParen && 1914 Right.MatchingParen->BlockKind != BK_Block)) 1915 return !Style.Cpp11BracedListStyle; 1916 if (Left.is(TT_BlockComment)) 1917 return !Left.TokenText.endswith("=*/"); 1918 if (Right.is(tok::l_paren)) { 1919 if (Left.is(tok::r_paren) && Left.is(TT_AttributeParen)) 1920 return true; 1921 return Line.Type == LT_ObjCDecl || Left.is(tok::semi) || 1922 (Style.SpaceBeforeParens != FormatStyle::SBPO_Never && 1923 (Left.isOneOf(tok::kw_if, tok::pp_elif, tok::kw_for, tok::kw_while, 1924 tok::kw_switch, tok::kw_case, TT_ForEachMacro, 1925 TT_ObjCForIn) || 1926 (Left.isOneOf(tok::kw_try, Keywords.kw___except, tok::kw_catch, 1927 tok::kw_new, tok::kw_delete) && 1928 (!Left.Previous || Left.Previous->isNot(tok::period))))) || 1929 (Style.SpaceBeforeParens == FormatStyle::SBPO_Always && 1930 (Left.is(tok::identifier) || Left.isFunctionLikeKeyword() || 1931 Left.is(tok::r_paren)) && 1932 Line.Type != LT_PreprocessorDirective); 1933 } 1934 if (Left.is(tok::at) && Right.Tok.getObjCKeywordID() != tok::objc_not_keyword) 1935 return false; 1936 if (Right.is(TT_UnaryOperator)) 1937 return !Left.isOneOf(tok::l_paren, tok::l_square, tok::at) && 1938 (Left.isNot(tok::colon) || Left.isNot(TT_ObjCMethodExpr)); 1939 if ((Left.isOneOf(tok::identifier, tok::greater, tok::r_square, 1940 tok::r_paren) || 1941 Left.isSimpleTypeSpecifier()) && 1942 Right.is(tok::l_brace) && Right.getNextNonComment() && 1943 Right.BlockKind != BK_Block) 1944 return false; 1945 if (Left.is(tok::period) || Right.is(tok::period)) 1946 return false; 1947 if (Right.is(tok::hash) && Left.is(tok::identifier) && Left.TokenText == "L") 1948 return false; 1949 if (Left.is(TT_TemplateCloser) && Left.MatchingParen && 1950 Left.MatchingParen->Previous && 1951 Left.MatchingParen->Previous->is(tok::period)) 1952 // A.<B>DoSomething(); 1953 return false; 1954 if (Left.is(TT_TemplateCloser) && Right.is(tok::l_square)) 1955 return false; 1956 return true; 1957 } 1958 1959 bool TokenAnnotator::spaceRequiredBefore(const AnnotatedLine &Line, 1960 const FormatToken &Right) { 1961 const FormatToken &Left = *Right.Previous; 1962 if (Right.Tok.getIdentifierInfo() && Left.Tok.getIdentifierInfo()) 1963 return true; // Never ever merge two identifiers. 1964 if (Style.Language == FormatStyle::LK_Cpp) { 1965 if (Left.is(tok::kw_operator)) 1966 return Right.is(tok::coloncolon); 1967 } else if (Style.Language == FormatStyle::LK_Proto) { 1968 if (Right.is(tok::period) && 1969 Left.isOneOf(Keywords.kw_optional, Keywords.kw_required, 1970 Keywords.kw_repeated, Keywords.kw_extend)) 1971 return true; 1972 if (Right.is(tok::l_paren) && 1973 Left.isOneOf(Keywords.kw_returns, Keywords.kw_option)) 1974 return true; 1975 } else if (Style.Language == FormatStyle::LK_JavaScript) { 1976 if (Left.isOneOf(Keywords.kw_let, Keywords.kw_var, TT_JsFatArrow, 1977 Keywords.kw_in)) 1978 return true; 1979 if (Right.isOneOf(TT_JsTypeColon, TT_JsTypeOptionalQuestion)) 1980 return false; 1981 if ((Left.is(tok::l_brace) || Right.is(tok::r_brace)) && 1982 Line.First->isOneOf(Keywords.kw_import, tok::kw_export)) 1983 return false; 1984 if (Left.is(tok::ellipsis)) 1985 return false; 1986 if (Left.is(TT_TemplateCloser) && 1987 !Right.isOneOf(tok::equal, tok::l_brace, tok::comma, tok::l_square, 1988 Keywords.kw_implements, Keywords.kw_extends)) 1989 // Type assertions ('<type>expr') are not followed by whitespace. Other 1990 // locations that should have whitespace following are identified by the 1991 // above set of follower tokens. 1992 return false; 1993 } else if (Style.Language == FormatStyle::LK_Java) { 1994 if (Left.is(tok::r_square) && Right.is(tok::l_brace)) 1995 return true; 1996 if (Left.is(Keywords.kw_synchronized) && Right.is(tok::l_paren)) 1997 return Style.SpaceBeforeParens != FormatStyle::SBPO_Never; 1998 if ((Left.isOneOf(tok::kw_static, tok::kw_public, tok::kw_private, 1999 tok::kw_protected) || 2000 Left.isOneOf(Keywords.kw_final, Keywords.kw_abstract, 2001 Keywords.kw_native)) && 2002 Right.is(TT_TemplateOpener)) 2003 return true; 2004 } 2005 if (Left.is(TT_ImplicitStringLiteral)) 2006 return Right.WhitespaceRange.getBegin() != Right.WhitespaceRange.getEnd(); 2007 if (Line.Type == LT_ObjCMethodDecl) { 2008 if (Left.is(TT_ObjCMethodSpecifier)) 2009 return true; 2010 if (Left.is(tok::r_paren) && Right.is(tok::identifier)) 2011 // Don't space between ')' and <id> 2012 return false; 2013 } 2014 if (Line.Type == LT_ObjCProperty && 2015 (Right.is(tok::equal) || Left.is(tok::equal))) 2016 return false; 2017 2018 if (Right.isOneOf(TT_TrailingReturnArrow, TT_LambdaArrow) || 2019 Left.isOneOf(TT_TrailingReturnArrow, TT_LambdaArrow)) 2020 return true; 2021 if (Left.is(tok::comma)) 2022 return true; 2023 if (Right.is(tok::comma)) 2024 return false; 2025 if (Right.isOneOf(TT_CtorInitializerColon, TT_ObjCBlockLParen)) 2026 return true; 2027 if (Right.is(TT_OverloadedOperatorLParen)) 2028 return Style.SpaceBeforeParens == FormatStyle::SBPO_Always; 2029 if (Right.is(tok::colon)) { 2030 if (Line.First->isOneOf(tok::kw_case, tok::kw_default) || 2031 !Right.getNextNonComment() || Right.getNextNonComment()->is(tok::semi)) 2032 return false; 2033 if (Right.is(TT_ObjCMethodExpr)) 2034 return false; 2035 if (Left.is(tok::question)) 2036 return false; 2037 if (Right.is(TT_InlineASMColon) && Left.is(tok::coloncolon)) 2038 return false; 2039 if (Right.is(TT_DictLiteral)) 2040 return Style.SpacesInContainerLiterals; 2041 return true; 2042 } 2043 if (Left.is(TT_UnaryOperator)) 2044 return Right.is(TT_BinaryOperator); 2045 2046 // If the next token is a binary operator or a selector name, we have 2047 // incorrectly classified the parenthesis as a cast. FIXME: Detect correctly. 2048 if (Left.is(TT_CastRParen)) 2049 return Style.SpaceAfterCStyleCast || 2050 Right.isOneOf(TT_BinaryOperator, TT_SelectorName); 2051 2052 if (Left.is(tok::greater) && Right.is(tok::greater)) 2053 return Right.is(TT_TemplateCloser) && Left.is(TT_TemplateCloser) && 2054 (Style.Standard != FormatStyle::LS_Cpp11 || Style.SpacesInAngles); 2055 if (Right.isOneOf(tok::arrow, tok::period, tok::arrowstar, tok::periodstar) || 2056 Left.isOneOf(tok::arrow, tok::period, tok::arrowstar, tok::periodstar)) 2057 return false; 2058 if (!Style.SpaceBeforeAssignmentOperators && 2059 Right.getPrecedence() == prec::Assignment) 2060 return false; 2061 if (Right.is(tok::coloncolon) && Left.isNot(tok::l_brace)) 2062 return (Left.is(TT_TemplateOpener) && 2063 Style.Standard == FormatStyle::LS_Cpp03) || 2064 !(Left.isOneOf(tok::identifier, tok::l_paren, tok::r_paren) || 2065 Left.isOneOf(TT_TemplateCloser, TT_TemplateOpener)); 2066 if ((Left.is(TT_TemplateOpener)) != (Right.is(TT_TemplateCloser))) 2067 return Style.SpacesInAngles; 2068 if ((Right.is(TT_BinaryOperator) && !Left.is(tok::l_paren)) || 2069 (Left.isOneOf(TT_BinaryOperator, TT_ConditionalExpr) && 2070 !Right.is(tok::r_paren))) 2071 return true; 2072 if (Left.is(TT_TemplateCloser) && Right.is(tok::l_paren) && 2073 Right.isNot(TT_FunctionTypeLParen)) 2074 return Style.SpaceBeforeParens == FormatStyle::SBPO_Always; 2075 if (Right.is(TT_TemplateOpener) && Left.is(tok::r_paren) && 2076 Left.MatchingParen && Left.MatchingParen->is(TT_OverloadedOperatorLParen)) 2077 return false; 2078 if (Right.is(tok::less) && Left.isNot(tok::l_paren) && 2079 Line.startsWith(tok::hash)) 2080 return true; 2081 if (Right.is(TT_TrailingUnaryOperator)) 2082 return false; 2083 if (Left.is(TT_RegexLiteral)) 2084 return false; 2085 return spaceRequiredBetween(Line, Left, Right); 2086 } 2087 2088 // Returns 'true' if 'Tok' is a brace we'd want to break before in Allman style. 2089 static bool isAllmanBrace(const FormatToken &Tok) { 2090 return Tok.is(tok::l_brace) && Tok.BlockKind == BK_Block && 2091 !Tok.isOneOf(TT_ObjCBlockLBrace, TT_DictLiteral); 2092 } 2093 2094 bool TokenAnnotator::mustBreakBefore(const AnnotatedLine &Line, 2095 const FormatToken &Right) { 2096 const FormatToken &Left = *Right.Previous; 2097 if (Right.NewlinesBefore > 1 && Style.MaxEmptyLinesToKeep > 0) 2098 return true; 2099 2100 if (Style.Language == FormatStyle::LK_JavaScript) { 2101 // FIXME: This might apply to other languages and token kinds. 2102 if (Right.is(tok::char_constant) && Left.is(tok::plus) && Left.Previous && 2103 Left.Previous->is(tok::char_constant)) 2104 return true; 2105 if (Left.is(TT_DictLiteral) && Left.is(tok::l_brace) && Line.Level == 0 && 2106 Left.Previous && Left.Previous->is(tok::equal) && 2107 Line.First->isOneOf(tok::identifier, Keywords.kw_import, tok::kw_export, 2108 tok::kw_const) && 2109 // kw_var/kw_let are pseudo-tokens that are tok::identifier, so match 2110 // above. 2111 !Line.First->isOneOf(Keywords.kw_var, Keywords.kw_let)) 2112 // Object literals on the top level of a file are treated as "enum-style". 2113 // Each key/value pair is put on a separate line, instead of bin-packing. 2114 return true; 2115 if (Left.is(tok::l_brace) && Line.Level == 0 && 2116 (Line.startsWith(tok::kw_enum) || 2117 Line.startsWith(tok::kw_export, tok::kw_enum))) 2118 // JavaScript top-level enum key/value pairs are put on separate lines 2119 // instead of bin-packing. 2120 return true; 2121 if (Right.is(tok::r_brace) && Left.is(tok::l_brace) && 2122 !Left.Children.empty()) 2123 // Support AllowShortFunctionsOnASingleLine for JavaScript. 2124 return Style.AllowShortFunctionsOnASingleLine == FormatStyle::SFS_None || 2125 Style.AllowShortFunctionsOnASingleLine == FormatStyle::SFS_Empty || 2126 (Left.NestingLevel == 0 && Line.Level == 0 && 2127 Style.AllowShortFunctionsOnASingleLine == 2128 FormatStyle::SFS_Inline); 2129 } else if (Style.Language == FormatStyle::LK_Java) { 2130 if (Right.is(tok::plus) && Left.is(tok::string_literal) && Right.Next && 2131 Right.Next->is(tok::string_literal)) 2132 return true; 2133 } 2134 2135 // If the last token before a '}' is a comma or a trailing comment, the 2136 // intention is to insert a line break after it in order to make shuffling 2137 // around entries easier. 2138 const FormatToken *BeforeClosingBrace = nullptr; 2139 if (Left.isOneOf(tok::l_brace, TT_ArrayInitializerLSquare) && 2140 Left.BlockKind != BK_Block && Left.MatchingParen) 2141 BeforeClosingBrace = Left.MatchingParen->Previous; 2142 else if (Right.MatchingParen && 2143 Right.MatchingParen->isOneOf(tok::l_brace, 2144 TT_ArrayInitializerLSquare)) 2145 BeforeClosingBrace = &Left; 2146 if (BeforeClosingBrace && (BeforeClosingBrace->is(tok::comma) || 2147 BeforeClosingBrace->isTrailingComment())) 2148 return true; 2149 2150 if (Right.is(tok::comment)) 2151 return Left.BlockKind != BK_BracedInit && 2152 Left.isNot(TT_CtorInitializerColon) && 2153 (Right.NewlinesBefore > 0 && Right.HasUnescapedNewline); 2154 if (Left.isTrailingComment()) 2155 return true; 2156 if (Left.isStringLiteral() && 2157 (Right.isStringLiteral() || Right.is(TT_ObjCStringLiteral))) 2158 return true; 2159 if (Right.Previous->IsUnterminatedLiteral) 2160 return true; 2161 if (Right.is(tok::lessless) && Right.Next && 2162 Right.Previous->is(tok::string_literal) && 2163 Right.Next->is(tok::string_literal)) 2164 return true; 2165 if (Right.Previous->ClosesTemplateDeclaration && 2166 Right.Previous->MatchingParen && 2167 Right.Previous->MatchingParen->NestingLevel == 0 && 2168 Style.AlwaysBreakTemplateDeclarations) 2169 return true; 2170 if ((Right.isOneOf(TT_CtorInitializerComma, TT_CtorInitializerColon)) && 2171 Style.BreakConstructorInitializersBeforeComma && 2172 !Style.ConstructorInitializerAllOnOneLineOrOnePerLine) 2173 return true; 2174 if (Right.is(tok::string_literal) && Right.TokenText.startswith("R\"")) 2175 // Raw string literals are special wrt. line breaks. The author has made a 2176 // deliberate choice and might have aligned the contents of the string 2177 // literal accordingly. Thus, we try keep existing line breaks. 2178 return Right.NewlinesBefore > 0; 2179 if (Right.Previous->is(tok::l_brace) && Right.NestingLevel == 1 && 2180 Style.Language == FormatStyle::LK_Proto) 2181 // Don't put enums onto single lines in protocol buffers. 2182 return true; 2183 if (Right.is(TT_InlineASMBrace)) 2184 return Right.HasUnescapedNewline; 2185 if (isAllmanBrace(Left) || isAllmanBrace(Right)) 2186 return (Line.startsWith(tok::kw_enum) && Style.BraceWrapping.AfterEnum) || 2187 (Line.startsWith(tok::kw_class) && Style.BraceWrapping.AfterClass) || 2188 (Line.startsWith(tok::kw_struct) && Style.BraceWrapping.AfterStruct); 2189 if (Style.Language == FormatStyle::LK_Proto && Left.isNot(tok::l_brace) && 2190 Right.is(TT_SelectorName)) 2191 return true; 2192 if (Left.is(TT_ObjCBlockLBrace) && !Style.AllowShortBlocksOnASingleLine) 2193 return true; 2194 2195 if ((Style.Language == FormatStyle::LK_Java || 2196 Style.Language == FormatStyle::LK_JavaScript) && 2197 Left.is(TT_LeadingJavaAnnotation) && 2198 Right.isNot(TT_LeadingJavaAnnotation) && Right.isNot(tok::l_paren) && 2199 (Line.Last->is(tok::l_brace) || Style.BreakAfterJavaFieldAnnotations)) 2200 return true; 2201 2202 return false; 2203 } 2204 2205 bool TokenAnnotator::canBreakBefore(const AnnotatedLine &Line, 2206 const FormatToken &Right) { 2207 const FormatToken &Left = *Right.Previous; 2208 2209 // Language-specific stuff. 2210 if (Style.Language == FormatStyle::LK_Java) { 2211 if (Left.isOneOf(Keywords.kw_throws, Keywords.kw_extends, 2212 Keywords.kw_implements)) 2213 return false; 2214 if (Right.isOneOf(Keywords.kw_throws, Keywords.kw_extends, 2215 Keywords.kw_implements)) 2216 return true; 2217 } else if (Style.Language == FormatStyle::LK_JavaScript) { 2218 if (Left.is(TT_JsFatArrow) && Right.is(tok::l_brace)) 2219 return false; 2220 if (Left.is(TT_JsTypeColon)) 2221 return true; 2222 } 2223 2224 if (Left.is(tok::at)) 2225 return false; 2226 if (Left.Tok.getObjCKeywordID() == tok::objc_interface) 2227 return false; 2228 if (Left.isOneOf(TT_JavaAnnotation, TT_LeadingJavaAnnotation)) 2229 return !Right.is(tok::l_paren); 2230 if (Right.is(TT_PointerOrReference)) 2231 return Line.IsMultiVariableDeclStmt || 2232 (Style.PointerAlignment == FormatStyle::PAS_Right && 2233 (!Right.Next || Right.Next->isNot(TT_FunctionDeclarationName))); 2234 if (Right.isOneOf(TT_StartOfName, TT_FunctionDeclarationName) || 2235 Right.is(tok::kw_operator)) 2236 return true; 2237 if (Left.is(TT_PointerOrReference)) 2238 return false; 2239 if (Right.isTrailingComment()) 2240 // We rely on MustBreakBefore being set correctly here as we should not 2241 // change the "binding" behavior of a comment. 2242 // The first comment in a braced lists is always interpreted as belonging to 2243 // the first list element. Otherwise, it should be placed outside of the 2244 // list. 2245 return Left.BlockKind == BK_BracedInit; 2246 if (Left.is(tok::question) && Right.is(tok::colon)) 2247 return false; 2248 if (Right.is(TT_ConditionalExpr) || Right.is(tok::question)) 2249 return Style.BreakBeforeTernaryOperators; 2250 if (Left.is(TT_ConditionalExpr) || Left.is(tok::question)) 2251 return !Style.BreakBeforeTernaryOperators; 2252 if (Right.is(TT_InheritanceColon)) 2253 return true; 2254 if (Right.is(tok::colon) && 2255 !Right.isOneOf(TT_CtorInitializerColon, TT_InlineASMColon)) 2256 return false; 2257 if (Left.is(tok::colon) && (Left.isOneOf(TT_DictLiteral, TT_ObjCMethodExpr))) 2258 return true; 2259 if (Right.is(TT_SelectorName) || (Right.is(tok::identifier) && Right.Next && 2260 Right.Next->is(TT_ObjCMethodExpr))) 2261 return Left.isNot(tok::period); // FIXME: Properly parse ObjC calls. 2262 if (Left.is(tok::r_paren) && Line.Type == LT_ObjCProperty) 2263 return true; 2264 if (Left.ClosesTemplateDeclaration || Left.is(TT_FunctionAnnotationRParen)) 2265 return true; 2266 if (Right.isOneOf(TT_RangeBasedForLoopColon, TT_OverloadedOperatorLParen, 2267 TT_OverloadedOperator)) 2268 return false; 2269 if (Left.is(TT_RangeBasedForLoopColon)) 2270 return true; 2271 if (Right.is(TT_RangeBasedForLoopColon)) 2272 return false; 2273 if (Left.isOneOf(TT_TemplateCloser, TT_UnaryOperator) || 2274 Left.is(tok::kw_operator)) 2275 return false; 2276 if (Left.is(tok::equal) && !Right.isOneOf(tok::kw_default, tok::kw_delete) && 2277 Line.Type == LT_VirtualFunctionDecl && Left.NestingLevel == 0) 2278 return false; 2279 if (Left.is(tok::l_paren) && Left.is(TT_AttributeParen)) 2280 return false; 2281 if (Left.is(tok::l_paren) && Left.Previous && 2282 (Left.Previous->isOneOf(TT_BinaryOperator, TT_CastRParen))) 2283 return false; 2284 if (Right.is(TT_ImplicitStringLiteral)) 2285 return false; 2286 2287 if (Right.is(tok::r_paren) || Right.is(TT_TemplateCloser)) 2288 return false; 2289 if (Right.is(tok::r_square) && Right.MatchingParen && 2290 Right.MatchingParen->is(TT_LambdaLSquare)) 2291 return false; 2292 2293 // We only break before r_brace if there was a corresponding break before 2294 // the l_brace, which is tracked by BreakBeforeClosingBrace. 2295 if (Right.is(tok::r_brace)) 2296 return Right.MatchingParen && Right.MatchingParen->BlockKind == BK_Block; 2297 2298 // Allow breaking after a trailing annotation, e.g. after a method 2299 // declaration. 2300 if (Left.is(TT_TrailingAnnotation)) 2301 return !Right.isOneOf(tok::l_brace, tok::semi, tok::equal, tok::l_paren, 2302 tok::less, tok::coloncolon); 2303 2304 if (Right.is(tok::kw___attribute)) 2305 return true; 2306 2307 if (Left.is(tok::identifier) && Right.is(tok::string_literal)) 2308 return true; 2309 2310 if (Right.is(tok::identifier) && Right.Next && Right.Next->is(TT_DictLiteral)) 2311 return true; 2312 2313 if (Left.is(TT_CtorInitializerComma) && 2314 Style.BreakConstructorInitializersBeforeComma) 2315 return false; 2316 if (Right.is(TT_CtorInitializerComma) && 2317 Style.BreakConstructorInitializersBeforeComma) 2318 return true; 2319 if ((Left.is(tok::greater) && Right.is(tok::greater)) || 2320 (Left.is(tok::less) && Right.is(tok::less))) 2321 return false; 2322 if (Right.is(TT_BinaryOperator) && 2323 Style.BreakBeforeBinaryOperators != FormatStyle::BOS_None && 2324 (Style.BreakBeforeBinaryOperators == FormatStyle::BOS_All || 2325 Right.getPrecedence() != prec::Assignment)) 2326 return true; 2327 if (Left.is(TT_ArrayInitializerLSquare)) 2328 return true; 2329 if (Right.is(tok::kw_typename) && Left.isNot(tok::kw_const)) 2330 return true; 2331 if ((Left.isBinaryOperator() || Left.is(TT_BinaryOperator)) && 2332 !Left.isOneOf(tok::arrowstar, tok::lessless) && 2333 Style.BreakBeforeBinaryOperators != FormatStyle::BOS_All && 2334 (Style.BreakBeforeBinaryOperators == FormatStyle::BOS_None || 2335 Left.getPrecedence() == prec::Assignment)) 2336 return true; 2337 return Left.isOneOf(tok::comma, tok::coloncolon, tok::semi, tok::l_brace, 2338 tok::kw_class, tok::kw_struct) || 2339 Right.isMemberAccess() || 2340 Right.isOneOf(TT_TrailingReturnArrow, TT_LambdaArrow, tok::lessless, 2341 tok::colon, tok::l_square, tok::at) || 2342 (Left.is(tok::r_paren) && 2343 Right.isOneOf(tok::identifier, tok::kw_const)) || 2344 (Left.is(tok::l_paren) && !Right.is(tok::r_paren)); 2345 } 2346 2347 void TokenAnnotator::printDebugInfo(const AnnotatedLine &Line) { 2348 llvm::errs() << "AnnotatedTokens:\n"; 2349 const FormatToken *Tok = Line.First; 2350 while (Tok) { 2351 llvm::errs() << " M=" << Tok->MustBreakBefore 2352 << " C=" << Tok->CanBreakBefore 2353 << " T=" << getTokenTypeName(Tok->Type) 2354 << " S=" << Tok->SpacesRequiredBefore 2355 << " B=" << Tok->BlockParameterCount 2356 << " P=" << Tok->SplitPenalty << " Name=" << Tok->Tok.getName() 2357 << " L=" << Tok->TotalLength << " PPK=" << Tok->PackingKind 2358 << " FakeLParens="; 2359 for (unsigned i = 0, e = Tok->FakeLParens.size(); i != e; ++i) 2360 llvm::errs() << Tok->FakeLParens[i] << "/"; 2361 llvm::errs() << " FakeRParens=" << Tok->FakeRParens << "\n"; 2362 if (!Tok->Next) 2363 assert(Tok == Line.Last); 2364 Tok = Tok->Next; 2365 } 2366 llvm::errs() << "----\n"; 2367 } 2368 2369 } // namespace format 2370 } // namespace clang 2371