blob: b57faaad8bbdb39d3e1e413dbfcb93c16527d637 [file] [log] [blame]
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001//===--- 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"
Daniel Jasper4d9ec172015-05-06 08:38:24 +000018#include "llvm/ADT/SmallPtrSet.h"
Daniel Jasper6bee6822013-04-08 20:33:42 +000019#include "llvm/Support/Debug.h"
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000020
Chandler Carruth57f5fbe2014-04-21 22:55:36 +000021#define DEBUG_TYPE "format-token-annotator"
22
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000023namespace clang {
24namespace format {
25
Craig Topper318ed7c2013-07-01 04:03:19 +000026namespace {
27
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000028/// \brief A parser that gathers additional information about tokens.
29///
Alexander Kornienkoa5151272013-03-12 16:28:18 +000030/// The \c TokenAnnotator tries to match parenthesis and square brakets and
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000031/// store a parenthesis levels. It also tries to resolve matching "<" and ">"
32/// into template parameter lists.
33class AnnotatingParser {
34public:
Daniel Jasper8de9ed02013-08-22 15:00:41 +000035 AnnotatingParser(const FormatStyle &Style, AnnotatedLine &Line,
Daniel Jasperd0ec0d62014-11-04 12:41:02 +000036 const AdditionalKeywords &Keywords)
Daniel Jasper616de8642014-11-23 16:46:28 +000037 : Style(Style), Line(Line), CurrentToken(Line.First), AutoFound(false),
38 Keywords(Keywords) {
Nico Weber9096fc02013-06-26 00:30:14 +000039 Contexts.push_back(Context(tok::unknown, 1, /*IsExpression=*/false));
Manuel Klimek819788d2014-03-18 11:22:45 +000040 resetTokenMetadata(CurrentToken);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000041 }
42
Nico Weber44449172013-02-12 16:17:07 +000043private:
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000044 bool parseAngle() {
Daniel Jasper0c9772e2016-02-05 14:17:16 +000045 if (!CurrentToken || !CurrentToken->Previous)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000046 return false;
Daniel Jasper0c9772e2016-02-05 14:17:16 +000047 if (NonTemplateLess.count(CurrentToken->Previous))
48 return false;
49
50 const FormatToken& Previous = *CurrentToken->Previous;
51 if (Previous.Previous) {
52 if (Previous.Previous->Tok.isLiteral())
53 return false;
54 if (Previous.Previous->is(tok::r_paren) && Contexts.size() > 1 &&
55 (!Previous.Previous->MatchingParen ||
56 !Previous.Previous->MatchingParen->is(TT_OverloadedOperatorLParen)))
57 return false;
58 }
59
Manuel Klimek6e6310e2013-05-29 14:47:47 +000060 FormatToken *Left = CurrentToken->Previous;
Daniel Jasperde7ca752015-05-04 07:39:00 +000061 Left->ParentBracket = Contexts.back().ContextKind;
Daniel Jasper88db7602016-02-11 06:43:01 +000062 ScopedContextCreator ContextCreator(*this, tok::less, 12);
Daniel Jasper112b50e2015-05-06 14:53:50 +000063
64 // If this angle is in the context of an expression, we need to be more
Daniel Jasper9c950132015-05-07 14:19:59 +000065 // hesitant to detect it as opening template parameters.
Daniel Jasper112b50e2015-05-06 14:53:50 +000066 bool InExprContext = Contexts.back().IsExpression;
67
Daniel Jasperc697ad22013-02-06 10:05:46 +000068 Contexts.back().IsExpression = false;
Manuel Klimekf81e5c02014-03-27 11:17:36 +000069 // If there's a template keyword before the opening angle bracket, this is a
70 // template parameter, not an argument.
71 Contexts.back().InTemplateArgument =
Craig Topper2145bc02014-05-09 08:15:10 +000072 Left->Previous && Left->Previous->Tok.isNot(tok::kw_template);
Manuel Klimekf81e5c02014-03-27 11:17:36 +000073
Daniel Jasper16b107e2014-10-21 09:57:09 +000074 if (Style.Language == FormatStyle::LK_Java &&
75 CurrentToken->is(tok::question))
76 next();
77
Craig Topper2145bc02014-05-09 08:15:10 +000078 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000079 if (CurrentToken->is(tok::greater)) {
80 Left->MatchingParen = CurrentToken;
81 CurrentToken->MatchingParen = Left;
82 CurrentToken->Type = TT_TemplateCloser;
83 next();
84 return true;
85 }
Daniel Jasper7bd618f2014-11-02 21:52:57 +000086 if (CurrentToken->is(tok::question) &&
Daniel Jasper61d81972014-11-14 08:22:46 +000087 Style.Language == FormatStyle::LK_Java) {
88 next();
89 continue;
90 }
Daniel Jasper112b50e2015-05-06 14:53:50 +000091 if (CurrentToken->isOneOf(tok::r_paren, tok::r_square, tok::r_brace) ||
92 (CurrentToken->isOneOf(tok::colon, tok::question) && InExprContext))
Daniel Jasper6f05e592013-05-15 13:46:48 +000093 return false;
Daniel Jasperd5893912013-06-01 18:56:00 +000094 // If a && or || is found and interpreted as a binary operator, this set
Daniel Jasper1027c6e2013-06-03 16:16:41 +000095 // of angles is likely part of something like "a < b && c > d". If the
Daniel Jasperd5893912013-06-01 18:56:00 +000096 // angles are inside an expression, the ||/&& might also be a binary
97 // operator that was misinterpreted because we are parsing template
98 // parameters.
99 // FIXME: This is getting out of hand, write a decent parser.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000100 if (CurrentToken->Previous->isOneOf(tok::pipepipe, tok::ampamp) &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000101 CurrentToken->Previous->is(TT_BinaryOperator) &&
Daniel Jasper6ba16382014-07-28 13:19:58 +0000102 Contexts[Contexts.size() - 2].IsExpression &&
Daniel Jaspere285b8d2015-06-17 09:43:56 +0000103 !Line.startsWith(tok::kw_template))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000104 return false;
Daniel Jaspere11095a2013-02-14 15:01:34 +0000105 updateParameterCount(Left, CurrentToken);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000106 if (!consumeToken())
107 return false;
108 }
109 return false;
110 }
111
112 bool parseParens(bool LookForDecls = false) {
Craig Topper2145bc02014-05-09 08:15:10 +0000113 if (!CurrentToken)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000114 return false;
Daniel Jasperde7ca752015-05-04 07:39:00 +0000115 FormatToken *Left = CurrentToken->Previous;
116 Left->ParentBracket = Contexts.back().ContextKind;
Daniel Jasper40aacf42013-03-14 13:45:21 +0000117 ScopedContextCreator ContextCreator(*this, tok::l_paren, 1);
Daniel Jasperc697ad22013-02-06 10:05:46 +0000118
119 // FIXME: This is a bit of a hack. Do better.
120 Contexts.back().ColonIsForRangeExpr =
121 Contexts.size() == 2 && Contexts[0].ColonIsForRangeExpr;
122
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000123 bool StartsObjCMethodExpr = false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000124 if (CurrentToken->is(tok::caret)) {
Daniel Jasperb88b25f2013-12-23 07:29:06 +0000125 // (^ can start a block type.
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000126 Left->Type = TT_ObjCBlockLParen;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000127 } else if (FormatToken *MaybeSel = Left->Previous) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000128 // @selector( starts a selector.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000129 if (MaybeSel->isObjCAtKeyword(tok::objc_selector) && MaybeSel->Previous &&
130 MaybeSel->Previous->is(tok::at)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000131 StartsObjCMethodExpr = true;
132 }
133 }
134
Daniel Jasperdf51f2e62016-01-11 12:55:33 +0000135 if (Left->is(TT_OverloadedOperatorLParen)) {
136 Contexts.back().IsExpression = false;
137 } else if (Left->Previous &&
Daniel Jasper033181b2015-08-13 13:43:51 +0000138 (Left->Previous->isOneOf(tok::kw_static_assert, tok::kw_decltype,
139 tok::kw_if, tok::kw_while, tok::l_paren,
140 tok::comma) ||
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000141 Left->Previous->is(TT_BinaryOperator))) {
Daniel Jasperd46e07e2013-10-20 18:15:30 +0000142 // static_assert, if and while usually contain expressions.
Daniel Jasper8b1c6352013-08-01 17:58:23 +0000143 Contexts.back().IsExpression = true;
Daniel Jasper91b1d1a2016-03-21 17:57:31 +0000144 } else if (Style.Language == FormatStyle::LK_JavaScript && Left->Previous &&
145 Left->Previous->is(Keywords.kw_function)) {
146 Contexts.back().IsExpression = false;
Daniel Jasperd46e07e2013-10-20 18:15:30 +0000147 } else if (Left->Previous && Left->Previous->is(tok::r_square) &&
148 Left->Previous->MatchingParen &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000149 Left->Previous->MatchingParen->is(TT_LambdaLSquare)) {
Daniel Jasperd46e07e2013-10-20 18:15:30 +0000150 // This is a parameter list of a lambda expression.
151 Contexts.back().IsExpression = false;
Daniel Jasper99b5a462015-05-12 10:20:32 +0000152 } else if (Line.InPPDirective &&
Daniel Jasperdf51f2e62016-01-11 12:55:33 +0000153 (!Left->Previous || !Left->Previous->is(tok::identifier))) {
Daniel Jasper99b5a462015-05-12 10:20:32 +0000154 Contexts.back().IsExpression = true;
Daniel Jasperc13ee342014-03-27 09:43:54 +0000155 } else if (Contexts[Contexts.size() - 2].CaretFound) {
Daniel Jasperb88b25f2013-12-23 07:29:06 +0000156 // This is the parameter list of an ObjC block.
157 Contexts.back().IsExpression = false;
Daniel Jasper559b63c2014-01-28 20:13:43 +0000158 } else if (Left->Previous && Left->Previous->is(tok::kw___attribute)) {
159 Left->Type = TT_AttributeParen;
Daniel Jasper66cb8c52015-05-04 09:22:29 +0000160 } else if (Left->Previous && Left->Previous->is(TT_ForEachMacro)) {
Daniel Jaspere1e43192014-04-01 12:55:11 +0000161 // The first argument to a foreach macro is a declaration.
162 Contexts.back().IsForEachMacro = true;
163 Contexts.back().IsExpression = false;
Daniel Jasperf1f267b2014-10-21 07:57:50 +0000164 } else if (Left->Previous && Left->Previous->MatchingParen &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000165 Left->Previous->MatchingParen->is(TT_ObjCBlockLParen)) {
Daniel Jasperf1f267b2014-10-21 07:57:50 +0000166 Contexts.back().IsExpression = false;
Daniel Jaspera85c3312015-12-28 07:44:25 +0000167 } else if (!Line.MustBeDeclaration && !Line.InPPDirective) {
168 bool IsForOrCatch =
169 Left->Previous && Left->Previous->isOneOf(tok::kw_for, tok::kw_catch);
170 Contexts.back().IsExpression = !IsForOrCatch;
Daniel Jasperd46e07e2013-10-20 18:15:30 +0000171 }
Daniel Jasper8b1c6352013-08-01 17:58:23 +0000172
Daniel Jasperc697ad22013-02-06 10:05:46 +0000173 if (StartsObjCMethodExpr) {
174 Contexts.back().ColonIsObjCMethodExpr = true;
175 Left->Type = TT_ObjCMethodExpr;
176 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000177
Daniel Jaspera85c3312015-12-28 07:44:25 +0000178 bool MightBeFunctionType = CurrentToken->isOneOf(tok::star, tok::amp) &&
179 !Contexts[Contexts.size() - 2].IsExpression;
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000180 bool HasMultipleLines = false;
181 bool HasMultipleParametersOnALine = false;
Daniel Jasper2b1865c2015-04-15 07:26:18 +0000182 bool MightBeObjCForRangeLoop =
183 Left->Previous && Left->Previous->is(tok::kw_for);
Craig Topper2145bc02014-05-09 08:15:10 +0000184 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000185 // LookForDecls is set when "if (" has been seen. Check for
186 // 'identifier' '*' 'identifier' followed by not '=' -- this
187 // '*' has to be a binary operator but determineStarAmpUsage() will
188 // categorize it as an unary operator, so set the right type here.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000189 if (LookForDecls && CurrentToken->Next) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000190 FormatToken *Prev = CurrentToken->getPreviousNonComment();
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000191 if (Prev) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000192 FormatToken *PrevPrev = Prev->getPreviousNonComment();
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000193 FormatToken *Next = CurrentToken->Next;
194 if (PrevPrev && PrevPrev->is(tok::identifier) &&
195 Prev->isOneOf(tok::star, tok::amp, tok::ampamp) &&
196 CurrentToken->is(tok::identifier) && Next->isNot(tok::equal)) {
197 Prev->Type = TT_BinaryOperator;
198 LookForDecls = false;
199 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000200 }
201 }
202
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000203 if (CurrentToken->Previous->is(TT_PointerOrReference) &&
Daniel Jasper59036852013-08-12 12:16:34 +0000204 CurrentToken->Previous->Previous->isOneOf(tok::l_paren,
205 tok::coloncolon))
206 MightBeFunctionType = true;
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000207 if (CurrentToken->Previous->is(TT_BinaryOperator))
Daniel Jasper91beebd2014-06-30 13:44:47 +0000208 Contexts.back().IsExpression = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000209 if (CurrentToken->is(tok::r_paren)) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000210 if (MightBeFunctionType && CurrentToken->Next &&
Daniel Jasper655d96a2013-07-16 11:37:21 +0000211 (CurrentToken->Next->is(tok::l_paren) ||
212 (CurrentToken->Next->is(tok::l_square) &&
Daniel Jaspera85c3312015-12-28 07:44:25 +0000213 Line.MustBeDeclaration)))
Daniel Jasper37194282013-05-28 08:33:00 +0000214 Left->Type = TT_FunctionTypeLParen;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000215 Left->MatchingParen = CurrentToken;
216 CurrentToken->MatchingParen = Left;
217
Daniel Jasper54353da2016-01-07 14:36:11 +0000218 if (CurrentToken->Next && CurrentToken->Next->is(tok::l_brace) &&
219 Left->Previous && Left->Previous->is(tok::l_paren)) {
220 // Detect the case where macros are used to generate lambdas or
221 // function bodies, e.g.:
222 // auto my_lambda = MARCO((Type *type, int i) { .. body .. });
223 for (FormatToken *Tok = Left; Tok != CurrentToken; Tok = Tok->Next) {
224 if (Tok->is(TT_BinaryOperator) &&
225 Tok->isOneOf(tok::star, tok::amp, tok::ampamp))
226 Tok->Type = TT_PointerOrReference;
227 }
228 }
229
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000230 if (StartsObjCMethodExpr) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000231 CurrentToken->Type = TT_ObjCMethodExpr;
Craig Topper2145bc02014-05-09 08:15:10 +0000232 if (Contexts.back().FirstObjCSelectorName) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000233 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
234 Contexts.back().LongestObjCSelectorName;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000235 }
236 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000237
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000238 if (Left->is(TT_AttributeParen))
Daniel Jasper559b63c2014-01-28 20:13:43 +0000239 CurrentToken->Type = TT_AttributeParen;
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000240 if (Left->Previous && Left->Previous->is(TT_JavaAnnotation))
Daniel Jasperf1f0c352014-10-21 09:25:39 +0000241 CurrentToken->Type = TT_JavaAnnotation;
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000242 if (Left->Previous && Left->Previous->is(TT_LeadingJavaAnnotation))
Daniel Jaspere9ab42d2014-10-31 18:23:49 +0000243 CurrentToken->Type = TT_LeadingJavaAnnotation;
Daniel Jasper559b63c2014-01-28 20:13:43 +0000244
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000245 if (!HasMultipleLines)
246 Left->PackingKind = PPK_Inconclusive;
247 else if (HasMultipleParametersOnALine)
248 Left->PackingKind = PPK_BinPacked;
249 else
250 Left->PackingKind = PPK_OnePerLine;
251
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000252 next();
253 return true;
254 }
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000255 if (CurrentToken->isOneOf(tok::r_square, tok::r_brace))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000256 return false;
Daniel Jasper2b1865c2015-04-15 07:26:18 +0000257
258 if (CurrentToken->is(tok::l_brace))
Daniel Jasper31745732014-01-19 07:46:32 +0000259 Left->Type = TT_Unknown; // Not TT_ObjCBlockLParen
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000260 if (CurrentToken->is(tok::comma) && CurrentToken->Next &&
261 !CurrentToken->Next->HasUnescapedNewline &&
262 !CurrentToken->Next->isTrailingComment())
263 HasMultipleParametersOnALine = true;
Daniel Jaspercc7bf7f2014-04-03 09:00:49 +0000264 if (CurrentToken->isOneOf(tok::kw_const, tok::kw_auto) ||
Daniel Jasperc580af92014-03-11 09:29:46 +0000265 CurrentToken->isSimpleTypeSpecifier())
266 Contexts.back().IsExpression = false;
Daniel Jasper2b1865c2015-04-15 07:26:18 +0000267 if (CurrentToken->isOneOf(tok::semi, tok::colon))
268 MightBeObjCForRangeLoop = false;
269 if (MightBeObjCForRangeLoop && CurrentToken->is(Keywords.kw_in))
270 CurrentToken->Type = TT_ObjCForIn;
Daniel Jasper3a26a8d2015-05-13 12:54:30 +0000271 // When we discover a 'new', we set CanBeExpression to 'false' in order to
272 // parse the type correctly. Reset that after a comma.
273 if (CurrentToken->is(tok::comma))
274 Contexts.back().CanBeExpression = true;
Daniel Jasper2b1865c2015-04-15 07:26:18 +0000275
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000276 FormatToken *Tok = CurrentToken;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000277 if (!consumeToken())
278 return false;
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000279 updateParameterCount(Left, Tok);
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000280 if (CurrentToken && CurrentToken->HasUnescapedNewline)
281 HasMultipleLines = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000282 }
283 return false;
284 }
285
286 bool parseSquare() {
287 if (!CurrentToken)
288 return false;
289
Alexander Kornienkoafaa8f52013-06-17 13:19:53 +0000290 // A '[' could be an index subscript (after an identifier or after
Nico Weber2a726b62013-02-10 02:08:05 +0000291 // ')' or ']'), it could be the start of an Objective-C method
Eric Christopher2c4555a2015-06-19 01:52:53 +0000292 // expression, or it could the start of an Objective-C array literal.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000293 FormatToken *Left = CurrentToken->Previous;
Daniel Jasperde7ca752015-05-04 07:39:00 +0000294 Left->ParentBracket = Contexts.back().ContextKind;
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000295 FormatToken *Parent = Left->getPreviousNonComment();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000296 bool StartsObjCMethodExpr =
Daniel Jasperf841d3a2015-05-28 07:21:50 +0000297 Style.Language == FormatStyle::LK_Cpp &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000298 Contexts.back().CanBeExpression && Left->isNot(TT_LambdaLSquare) &&
Daniel Jasper89519082014-05-09 10:26:08 +0000299 CurrentToken->isNot(tok::l_brace) &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000300 (!Parent ||
301 Parent->isOneOf(tok::colon, tok::l_square, tok::l_paren,
302 tok::kw_return, tok::kw_throw) ||
303 Parent->isUnaryOperator() ||
304 Parent->isOneOf(TT_ObjCForIn, TT_CastRParen) ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000305 getBinOpPrecedence(Parent->Tok.getKind(), true, true) > prec::Unknown);
Daniel Jaspera1ea4cb2013-10-26 17:00:22 +0000306 bool ColonFound = false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000307
Daniel Jasperf841d3a2015-05-28 07:21:50 +0000308 unsigned BindingIncrease = 1;
309 if (Left->is(TT_Unknown)) {
310 if (StartsObjCMethodExpr) {
311 Left->Type = TT_ObjCMethodExpr;
Daniel Jasper8c42d442015-05-29 06:19:49 +0000312 } else if (Style.Language == FormatStyle::LK_JavaScript && Parent &&
Daniel Jasper4284e362015-06-02 14:20:08 +0000313 Contexts.back().ContextKind == tok::l_brace &&
Daniel Jasper8c42d442015-05-29 06:19:49 +0000314 Parent->isOneOf(tok::l_brace, tok::comma)) {
315 Left->Type = TT_JsComputedPropertyName;
Daniel Jasperccff4d12016-01-04 07:27:33 +0000316 } else if (Style.Language == FormatStyle::LK_Proto ||
317 (Parent &&
Daniel Jasperebcb71f2016-01-04 13:11:41 +0000318 Parent->isOneOf(TT_BinaryOperator, tok::at, tok::comma,
319 tok::l_paren, tok::l_square, tok::question,
Daniel Jasperb14f6672016-01-04 15:51:56 +0000320 tok::colon, tok::kw_return,
321 // Should only be relevant to JavaScript:
322 tok::kw_default))) {
Daniel Jasperf841d3a2015-05-28 07:21:50 +0000323 Left->Type = TT_ArrayInitializerLSquare;
324 } else {
325 BindingIncrease = 10;
326 Left->Type = TT_ArraySubscriptLSquare;
327 }
Daniel Jasperc697ad22013-02-06 10:05:46 +0000328 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000329
Daniel Jasperf841d3a2015-05-28 07:21:50 +0000330 ScopedContextCreator ContextCreator(*this, tok::l_square, BindingIncrease);
331 Contexts.back().IsExpression = true;
332 Contexts.back().ColonIsObjCMethodExpr = StartsObjCMethodExpr;
333
Craig Topper2145bc02014-05-09 08:15:10 +0000334 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000335 if (CurrentToken->is(tok::r_square)) {
Daniel Jasper9a8d48b2013-09-05 10:04:31 +0000336 if (CurrentToken->Next && CurrentToken->Next->is(tok::l_paren) &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000337 Left->is(TT_ObjCMethodExpr)) {
Nico Weber5d2624e2013-02-06 06:20:11 +0000338 // An ObjC method call is rarely followed by an open parenthesis.
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000339 // FIXME: Do we incorrectly label ":" with this?
340 StartsObjCMethodExpr = false;
341 Left->Type = TT_Unknown;
342 }
Daniel Jasper139d4a32014-04-08 13:07:41 +0000343 if (StartsObjCMethodExpr && CurrentToken->Previous != Left) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000344 CurrentToken->Type = TT_ObjCMethodExpr;
Nico Weber5d2624e2013-02-06 06:20:11 +0000345 // determineStarAmpUsage() thinks that '*' '[' is allocating an
346 // array of pointers, but if '[' starts a selector then '*' is a
347 // binary operator.
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000348 if (Parent && Parent->is(TT_PointerOrReference))
Nico Weberac9bde22013-02-06 16:54:35 +0000349 Parent->Type = TT_BinaryOperator;
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000350 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000351 Left->MatchingParen = CurrentToken;
352 CurrentToken->MatchingParen = Left;
Craig Topper2145bc02014-05-09 08:15:10 +0000353 if (Contexts.back().FirstObjCSelectorName) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000354 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
355 Contexts.back().LongestObjCSelectorName;
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000356 if (Left->BlockParameterCount > 1)
Daniel Jasperb88b25f2013-12-23 07:29:06 +0000357 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName = 0;
358 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000359 next();
360 return true;
361 }
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000362 if (CurrentToken->isOneOf(tok::r_paren, tok::r_brace))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000363 return false;
Daniel Jasperea772b4d2014-10-16 08:38:51 +0000364 if (CurrentToken->is(tok::colon)) {
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000365 if (Left->is(TT_ArraySubscriptLSquare)) {
Daniel Jasperea772b4d2014-10-16 08:38:51 +0000366 Left->Type = TT_ObjCMethodExpr;
367 StartsObjCMethodExpr = true;
368 Contexts.back().ColonIsObjCMethodExpr = true;
369 if (Parent && Parent->is(tok::r_paren))
370 Parent->Type = TT_CastRParen;
371 }
Daniel Jaspera1ea4cb2013-10-26 17:00:22 +0000372 ColonFound = true;
Daniel Jasperea772b4d2014-10-16 08:38:51 +0000373 }
Daniel Jasperf841d3a2015-05-28 07:21:50 +0000374 if (CurrentToken->is(tok::comma) && Left->is(TT_ObjCMethodExpr) &&
375 !ColonFound)
Daniel Jasper1db6c382013-10-22 15:30:28 +0000376 Left->Type = TT_ArrayInitializerLSquare;
Nico Weberbeb03932015-01-09 23:25:06 +0000377 FormatToken *Tok = CurrentToken;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000378 if (!consumeToken())
379 return false;
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000380 updateParameterCount(Left, Tok);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000381 }
382 return false;
383 }
384
385 bool parseBrace() {
Craig Topper2145bc02014-05-09 08:15:10 +0000386 if (CurrentToken) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000387 FormatToken *Left = CurrentToken->Previous;
Daniel Jasperde7ca752015-05-04 07:39:00 +0000388 Left->ParentBracket = Contexts.back().ContextKind;
Daniel Jasperc13ee342014-03-27 09:43:54 +0000389
390 if (Contexts.back().CaretFound)
391 Left->Type = TT_ObjCBlockLBrace;
392 Contexts.back().CaretFound = false;
393
Daniel Jasperb596fb22013-10-24 10:31:50 +0000394 ScopedContextCreator ContextCreator(*this, tok::l_brace, 1);
395 Contexts.back().ColonIsDictLiteral = true;
Daniel Jasper39485162014-05-22 09:00:33 +0000396 if (Left->BlockKind == BK_BracedInit)
397 Contexts.back().IsExpression = true;
Nico Weberced7d412013-05-26 05:39:26 +0000398
Craig Topper2145bc02014-05-09 08:15:10 +0000399 while (CurrentToken) {
Daniel Jasper8e357692013-05-06 08:27:33 +0000400 if (CurrentToken->is(tok::r_brace)) {
401 Left->MatchingParen = CurrentToken;
402 CurrentToken->MatchingParen = Left;
403 next();
404 return true;
405 }
406 if (CurrentToken->isOneOf(tok::r_paren, tok::r_square))
407 return false;
408 updateParameterCount(Left, CurrentToken);
Daniel Jasper497d9fd2014-08-15 05:00:35 +0000409 if (CurrentToken->isOneOf(tok::colon, tok::l_brace)) {
410 FormatToken *Previous = CurrentToken->getPreviousNonComment();
Daniel Jasper4d724492015-10-12 03:19:07 +0000411 if (((CurrentToken->is(tok::colon) &&
412 (!Contexts.back().ColonIsDictLiteral ||
413 Style.Language != FormatStyle::LK_Cpp)) ||
Daniel Jasper168c8aa2014-08-27 11:53:26 +0000414 Style.Language == FormatStyle::LK_Proto) &&
Daniel Jasperb18425b2016-03-01 04:19:47 +0000415 (Previous->Tok.getIdentifierInfo() ||
Daniel Jasperabd1f572016-03-02 22:44:03 +0000416 Previous->is(tok::string_literal)))
Daniel Jasper497d9fd2014-08-15 05:00:35 +0000417 Previous->Type = TT_SelectorName;
Daniel Jasper739ec532015-04-04 07:56:55 +0000418 if (CurrentToken->is(tok::colon) ||
419 Style.Language == FormatStyle::LK_JavaScript)
Daniel Jasper497d9fd2014-08-15 05:00:35 +0000420 Left->Type = TT_DictLiteral;
Daniel Jasper17062ff2014-06-10 14:44:02 +0000421 }
Daniel Jasper8e357692013-05-06 08:27:33 +0000422 if (!consumeToken())
423 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000424 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000425 }
426 return true;
427 }
Daniel Jasperdc7d5812013-02-20 12:56:39 +0000428
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000429 void updateParameterCount(FormatToken *Left, FormatToken *Current) {
Daniel Jasper9f4c9d42016-02-07 22:17:13 +0000430 if (Current->is(tok::l_brace) && Current->BlockKind == BK_Block)
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000431 ++Left->BlockParameterCount;
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000432 if (Current->is(tok::comma)) {
Daniel Jaspere11095a2013-02-14 15:01:34 +0000433 ++Left->ParameterCount;
Daniel Jasper8de9ed02013-08-22 15:00:41 +0000434 if (!Left->Role)
435 Left->Role.reset(new CommaSeparatedList(Style));
436 Left->Role->CommaFound(Current);
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000437 } else if (Left->ParameterCount == 0 && Current->isNot(tok::comment)) {
Daniel Jaspere11095a2013-02-14 15:01:34 +0000438 Left->ParameterCount = 1;
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000439 }
Daniel Jaspere11095a2013-02-14 15:01:34 +0000440 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000441
442 bool parseConditional() {
Craig Topper2145bc02014-05-09 08:15:10 +0000443 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000444 if (CurrentToken->is(tok::colon)) {
445 CurrentToken->Type = TT_ConditionalExpr;
446 next();
447 return true;
448 }
449 if (!consumeToken())
450 return false;
451 }
452 return false;
453 }
454
455 bool parseTemplateDeclaration() {
Craig Topper2145bc02014-05-09 08:15:10 +0000456 if (CurrentToken && CurrentToken->is(tok::less)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000457 CurrentToken->Type = TT_TemplateOpener;
458 next();
459 if (!parseAngle())
460 return false;
Craig Topper2145bc02014-05-09 08:15:10 +0000461 if (CurrentToken)
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000462 CurrentToken->Previous->ClosesTemplateDeclaration = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000463 return true;
464 }
465 return false;
466 }
467
468 bool consumeToken() {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000469 FormatToken *Tok = CurrentToken;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000470 next();
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000471 switch (Tok->Tok.getKind()) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000472 case tok::plus:
473 case tok::minus:
Craig Topper2145bc02014-05-09 08:15:10 +0000474 if (!Tok->Previous && Line.MustBeDeclaration)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000475 Tok->Type = TT_ObjCMethodSpecifier;
476 break;
477 case tok::colon:
Craig Topper2145bc02014-05-09 08:15:10 +0000478 if (!Tok->Previous)
Daniel Jasper850677d2013-03-18 12:50:26 +0000479 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000480 // Colons from ?: are handled in parseConditional().
Daniel Jaspera74f5072015-04-13 15:01:40 +0000481 if (Style.Language == FormatStyle::LK_JavaScript) {
Daniel Jasper9326f912015-05-05 08:40:32 +0000482 if (Contexts.back().ColonIsForRangeExpr || // colon in for loop
483 (Contexts.size() == 1 && // switch/case labels
Daniel Jaspera74f5072015-04-13 15:01:40 +0000484 !Line.First->isOneOf(tok::kw_enum, tok::kw_case)) ||
Daniel Jasper9326f912015-05-05 08:40:32 +0000485 Contexts.back().ContextKind == tok::l_paren || // function params
486 Contexts.back().ContextKind == tok::l_square || // array type
Daniel Jasper81dbb562015-06-03 08:43:18 +0000487 (Contexts.size() == 1 &&
488 Line.MustBeDeclaration)) { // method/property declaration
Daniel Jaspera74f5072015-04-13 15:01:40 +0000489 Tok->Type = TT_JsTypeColon;
490 break;
491 }
492 }
Daniel Jasperffbad0e2016-01-04 07:28:12 +0000493 if (Contexts.back().ColonIsDictLiteral ||
494 Style.Language == FormatStyle::LK_Proto) {
Daniel Jasperb596fb22013-10-24 10:31:50 +0000495 Tok->Type = TT_DictLiteral;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000496 } else if (Contexts.back().ColonIsObjCMethodExpr ||
Daniel Jaspere285b8d2015-06-17 09:43:56 +0000497 Line.startsWith(TT_ObjCMethodSpecifier)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000498 Tok->Type = TT_ObjCMethodExpr;
Daniel Jasper17062ff2014-06-10 14:44:02 +0000499 Tok->Previous->Type = TT_SelectorName;
Alexander Kornienko39856b72013-09-10 09:38:25 +0000500 if (Tok->Previous->ColumnWidth >
Daniel Jasper06a26952016-01-04 07:29:07 +0000501 Contexts.back().LongestObjCSelectorName)
Alexander Kornienko60d1b042013-10-10 13:36:20 +0000502 Contexts.back().LongestObjCSelectorName = Tok->Previous->ColumnWidth;
Craig Topper2145bc02014-05-09 08:15:10 +0000503 if (!Contexts.back().FirstObjCSelectorName)
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000504 Contexts.back().FirstObjCSelectorName = Tok->Previous;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000505 } else if (Contexts.back().ColonIsForRangeExpr) {
Daniel Jaspera74f5072015-04-13 15:01:40 +0000506 Tok->Type = TT_RangeBasedForLoopColon;
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000507 } else if (CurrentToken && CurrentToken->is(tok::numeric_constant)) {
Alexander Kornienko60d1b042013-10-10 13:36:20 +0000508 Tok->Type = TT_BitFieldColon;
Daniel Jasperd39312ec2014-05-28 10:09:11 +0000509 } else if (Contexts.size() == 1 &&
510 !Line.First->isOneOf(tok::kw_enum, tok::kw_case)) {
Daniel Jasper56ef6ac2016-03-01 21:41:58 +0000511 if (Tok->Previous->isOneOf(tok::r_paren, tok::kw_noexcept))
Daniel Jasperb10bdff2015-02-18 17:09:53 +0000512 Tok->Type = TT_CtorInitializerColon;
513 else
514 Tok->Type = TT_InheritanceColon;
Daniel Jasper78580792014-10-20 12:01:45 +0000515 } else if (Tok->Previous->is(tok::identifier) && Tok->Next &&
516 Tok->Next->isOneOf(tok::r_paren, tok::comma)) {
517 // This handles a special macro in ObjC code where selectors including
518 // the colon are passed as macro arguments.
519 Tok->Type = TT_ObjCMethodExpr;
Daniel Jasper40aacf42013-03-14 13:45:21 +0000520 } else if (Contexts.back().ContextKind == tok::l_paren) {
Daniel Jaspera74f5072015-04-13 15:01:40 +0000521 Tok->Type = TT_InlineASMColon;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000522 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000523 break;
Daniel Jasper91b1d1a2016-03-21 17:57:31 +0000524 case tok::pipe:
525 case tok::amp:
526 // | and & in declarations/type expressions represent union and
527 // intersection types, respectively.
528 if (Style.Language == FormatStyle::LK_JavaScript &&
529 !Contexts.back().IsExpression)
530 Tok->Type = TT_JsTypeOperator;
531 break;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000532 case tok::kw_if:
533 case tok::kw_while:
Craig Topper2145bc02014-05-09 08:15:10 +0000534 if (CurrentToken && CurrentToken->is(tok::l_paren)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000535 next();
Nico Weber9096fc02013-06-26 00:30:14 +0000536 if (!parseParens(/*LookForDecls=*/true))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000537 return false;
538 }
539 break;
540 case tok::kw_for:
Daniel Jasperc697ad22013-02-06 10:05:46 +0000541 Contexts.back().ColonIsForRangeExpr = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000542 next();
543 if (!parseParens())
544 return false;
545 break;
546 case tok::l_paren:
Birunthan Mohanathas525579d2015-07-15 19:11:58 +0000547 // When faced with 'operator()()', the kw_operator handler incorrectly
548 // marks the first l_paren as a OverloadedOperatorLParen. Here, we make
549 // the first two parens OverloadedOperators and the second l_paren an
550 // OverloadedOperatorLParen.
551 if (Tok->Previous &&
552 Tok->Previous->is(tok::r_paren) &&
553 Tok->Previous->MatchingParen &&
554 Tok->Previous->MatchingParen->is(TT_OverloadedOperatorLParen)) {
555 Tok->Previous->Type = TT_OverloadedOperator;
556 Tok->Previous->MatchingParen->Type = TT_OverloadedOperator;
557 Tok->Type = TT_OverloadedOperatorLParen;
558 }
559
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000560 if (!parseParens())
561 return false;
Daniel Jasperbc5cb4e2013-11-07 17:43:07 +0000562 if (Line.MustBeDeclaration && Contexts.size() == 1 &&
Daniel Jaspere285b8d2015-06-17 09:43:56 +0000563 !Contexts.back().IsExpression && !Line.startsWith(TT_ObjCProperty) &&
Daniel Jaspera831c582015-01-14 09:47:57 +0000564 (!Tok->Previous ||
Daniel Jaspera5fa4d12015-07-06 11:30:34 +0000565 !Tok->Previous->isOneOf(tok::kw_decltype, tok::kw___attribute,
566 TT_LeadingJavaAnnotation)))
Daniel Jasper26d1b1d2013-02-24 18:54:32 +0000567 Line.MightBeFunctionDecl = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000568 break;
569 case tok::l_square:
570 if (!parseSquare())
571 return false;
572 break;
573 case tok::l_brace:
574 if (!parseBrace())
575 return false;
576 break;
577 case tok::less:
Daniel Jasper0c9772e2016-02-05 14:17:16 +0000578 if (parseAngle()) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000579 Tok->Type = TT_TemplateOpener;
Daniel Jasperb13135b2015-01-08 08:48:21 +0000580 } else {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000581 Tok->Type = TT_BinaryOperator;
Daniel Jasper4d9ec172015-05-06 08:38:24 +0000582 NonTemplateLess.insert(Tok);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000583 CurrentToken = Tok;
584 next();
585 }
586 break;
587 case tok::r_paren:
588 case tok::r_square:
589 return false;
590 case tok::r_brace:
591 // Lines can start with '}'.
Craig Topper2145bc02014-05-09 08:15:10 +0000592 if (Tok->Previous)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000593 return false;
594 break;
595 case tok::greater:
596 Tok->Type = TT_BinaryOperator;
597 break;
598 case tok::kw_operator:
Daniel Jasper42401c82013-09-02 09:20:39 +0000599 while (CurrentToken &&
600 !CurrentToken->isOneOf(tok::l_paren, tok::semi, tok::r_paren)) {
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000601 if (CurrentToken->isOneOf(tok::star, tok::amp))
Daniel Jasper35d2dc72013-02-11 08:01:18 +0000602 CurrentToken->Type = TT_PointerOrReference;
603 consumeToken();
Daniel Jasper804a2762016-01-09 15:56:40 +0000604 if (CurrentToken &&
605 CurrentToken->Previous->isOneOf(TT_BinaryOperator, tok::comma))
Daniel Jasperd215b8b2013-08-28 07:27:35 +0000606 CurrentToken->Previous->Type = TT_OverloadedOperator;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000607 }
Daniel Jasper8f9624b2013-05-10 07:59:58 +0000608 if (CurrentToken) {
Daniel Jasper35d2dc72013-02-11 08:01:18 +0000609 CurrentToken->Type = TT_OverloadedOperatorLParen;
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000610 if (CurrentToken->Previous->is(TT_BinaryOperator))
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000611 CurrentToken->Previous->Type = TT_OverloadedOperator;
Daniel Jasper8f9624b2013-05-10 07:59:58 +0000612 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000613 break;
614 case tok::question:
Daniel Jaspera74f5072015-04-13 15:01:40 +0000615 if (Style.Language == FormatStyle::LK_JavaScript && Tok->Next &&
Daniel Jasper56691b82015-06-11 13:29:20 +0000616 Tok->Next->isOneOf(tok::semi, tok::comma, tok::colon, tok::r_paren,
Daniel Jaspera74f5072015-04-13 15:01:40 +0000617 tok::r_brace)) {
Daniel Jasper9326f912015-05-05 08:40:32 +0000618 // Question marks before semicolons, colons, etc. indicate optional
619 // types (fields, parameters), e.g.
620 // function(x?: string, y?) {...}
621 // class X { y?; }
Daniel Jaspera74f5072015-04-13 15:01:40 +0000622 Tok->Type = TT_JsTypeOptionalQuestion;
623 break;
624 }
Daniel Jasper9326f912015-05-05 08:40:32 +0000625 // Declarations cannot be conditional expressions, this can only be part
626 // of a type declaration.
627 if (Line.MustBeDeclaration &&
628 Style.Language == FormatStyle::LK_JavaScript)
629 break;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000630 parseConditional();
631 break;
632 case tok::kw_template:
633 parseTemplateDeclaration();
634 break;
Daniel Jaspera628c982013-04-03 13:36:17 +0000635 case tok::comma:
Daniel Jaspere4ab49e2015-04-20 12:54:29 +0000636 if (Contexts.back().InCtorInitializer)
637 Tok->Type = TT_CtorInitializerComma;
Daniel Jasperd6e09e82015-05-19 11:51:39 +0000638 else if (Contexts.back().FirstStartOfName &&
Daniel Jaspere285b8d2015-06-17 09:43:56 +0000639 (Contexts.size() == 1 || Line.startsWith(tok::kw_for))) {
Daniel Jaspera628c982013-04-03 13:36:17 +0000640 Contexts.back().FirstStartOfName->PartOfMultiVariableDeclStmt = true;
Daniel Jasperbea1ab42015-03-01 18:55:26 +0000641 Line.IsMultiVariableDeclStmt = true;
642 }
Daniel Jaspere1e43192014-04-01 12:55:11 +0000643 if (Contexts.back().IsForEachMacro)
644 Contexts.back().IsExpression = true;
Daniel Jaspera628c982013-04-03 13:36:17 +0000645 break;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000646 default:
647 break;
648 }
649 return true;
650 }
651
652 void parseIncludeDirective() {
Craig Topper2145bc02014-05-09 08:15:10 +0000653 if (CurrentToken && CurrentToken->is(tok::less)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000654 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000655 while (CurrentToken) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000656 if (CurrentToken->isNot(tok::comment) || CurrentToken->Next)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000657 CurrentToken->Type = TT_ImplicitStringLiteral;
658 next();
659 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000660 }
661 }
662
663 void parseWarningOrError() {
664 next();
665 // We still want to format the whitespace left of the first token of the
666 // warning or error.
667 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000668 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000669 CurrentToken->Type = TT_ImplicitStringLiteral;
670 next();
671 }
672 }
673
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000674 void parsePragma() {
675 next(); // Consume "pragma".
Daniel Jasperee4a8a12015-04-22 09:45:42 +0000676 if (CurrentToken &&
677 CurrentToken->isOneOf(Keywords.kw_mark, Keywords.kw_option)) {
678 bool IsMark = CurrentToken->is(Keywords.kw_mark);
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000679 next(); // Consume "mark".
680 next(); // Consume first token (so we fix leading whitespace).
Craig Topper2145bc02014-05-09 08:15:10 +0000681 while (CurrentToken) {
Daniel Jasperee4a8a12015-04-22 09:45:42 +0000682 if (IsMark || CurrentToken->Previous->is(TT_BinaryOperator))
683 CurrentToken->Type = TT_ImplicitStringLiteral;
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000684 next();
685 }
686 }
687 }
688
Daniel Jasper616de8642014-11-23 16:46:28 +0000689 LineType parsePreprocessorDirective() {
690 LineType Type = LT_PreprocessorDirective;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000691 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000692 if (!CurrentToken)
Daniel Jasper616de8642014-11-23 16:46:28 +0000693 return Type;
Alexander Kornienko384b40b2013-10-11 21:43:05 +0000694 if (CurrentToken->Tok.is(tok::numeric_constant)) {
695 CurrentToken->SpacesRequiredBefore = 1;
Daniel Jasper616de8642014-11-23 16:46:28 +0000696 return Type;
Alexander Kornienko384b40b2013-10-11 21:43:05 +0000697 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000698 // Hashes in the middle of a line can lead to any strange token
699 // sequence.
Craig Topper2145bc02014-05-09 08:15:10 +0000700 if (!CurrentToken->Tok.getIdentifierInfo())
Daniel Jasper616de8642014-11-23 16:46:28 +0000701 return Type;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000702 switch (CurrentToken->Tok.getIdentifierInfo()->getPPKeywordID()) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000703 case tok::pp_include:
Daniel Jasperfa3f8fb2015-05-19 11:22:29 +0000704 case tok::pp_include_next:
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000705 case tok::pp_import:
Daniel Jasper343643b2014-08-13 08:29:18 +0000706 next();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000707 parseIncludeDirective();
Daniel Jasper616de8642014-11-23 16:46:28 +0000708 Type = LT_ImportStatement;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000709 break;
710 case tok::pp_error:
711 case tok::pp_warning:
712 parseWarningOrError();
713 break;
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000714 case tok::pp_pragma:
715 parsePragma();
716 break;
Daniel Jasper4431aa92013-04-23 13:54:04 +0000717 case tok::pp_if:
718 case tok::pp_elif:
Daniel Jasper7cfde412014-01-21 08:56:09 +0000719 Contexts.back().IsExpression = true;
Daniel Jasper4431aa92013-04-23 13:54:04 +0000720 parseLine();
721 break;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000722 default:
723 break;
724 }
Craig Topper2145bc02014-05-09 08:15:10 +0000725 while (CurrentToken)
Daniel Jaspera885dbe2013-02-05 09:34:14 +0000726 next();
Daniel Jasper616de8642014-11-23 16:46:28 +0000727 return Type;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000728 }
729
Nico Weber44449172013-02-12 16:17:07 +0000730public:
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000731 LineType parseLine() {
Daniel Jasper4d9ec172015-05-06 08:38:24 +0000732 NonTemplateLess.clear();
Daniel Jasper1b998812015-04-23 09:54:10 +0000733 if (CurrentToken->is(tok::hash))
Daniel Jasper616de8642014-11-23 16:46:28 +0000734 return parsePreprocessorDirective();
Daniel Jasper7cfde412014-01-21 08:56:09 +0000735
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000736 // Directly allow to 'import <string-literal>' to support protocol buffer
737 // definitions (code.google.com/p/protobuf) or missing "#" (either way we
738 // should not break the line).
739 IdentifierInfo *Info = CurrentToken->Tok.getIdentifierInfo();
Daniel Jasper9b9e0762014-11-26 18:03:42 +0000740 if ((Style.Language == FormatStyle::LK_Java &&
741 CurrentToken->is(Keywords.kw_package)) ||
742 (Info && Info->getPPKeywordID() == tok::pp_import &&
Daniel Jasper86ee0b62014-12-04 08:57:27 +0000743 CurrentToken->Next &&
Daniel Jasper16dbe0b2015-01-14 10:02:49 +0000744 CurrentToken->Next->isOneOf(tok::string_literal, tok::identifier,
745 tok::kw_static))) {
Daniel Jasper343643b2014-08-13 08:29:18 +0000746 next();
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000747 parseIncludeDirective();
Daniel Jasper616de8642014-11-23 16:46:28 +0000748 return LT_ImportStatement;
Daniel Jasper343643b2014-08-13 08:29:18 +0000749 }
750
751 // If this line starts and ends in '<' and '>', respectively, it is likely
752 // part of "#define <a/b.h>".
753 if (CurrentToken->is(tok::less) && Line.Last->is(tok::greater)) {
754 parseIncludeDirective();
Daniel Jasper616de8642014-11-23 16:46:28 +0000755 return LT_ImportStatement;
Daniel Jasper343643b2014-08-13 08:29:18 +0000756 }
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000757
Daniel Jasper1b998812015-04-23 09:54:10 +0000758 // In .proto files, top-level options are very similar to import statements
759 // and should not be line-wrapped.
760 if (Style.Language == FormatStyle::LK_Proto && Line.Level == 0 &&
761 CurrentToken->is(Keywords.kw_option)) {
762 next();
763 if (CurrentToken && CurrentToken->is(tok::identifier))
764 return LT_ImportStatement;
765 }
766
Daniel Jasper8fc7a1e2016-03-22 14:32:20 +0000767 // import {...} from '...';
768 if (Style.Language == FormatStyle::LK_JavaScript &&
769 CurrentToken->is(Keywords.kw_import))
770 return LT_ImportStatement;
771
Daniel Jasper616de8642014-11-23 16:46:28 +0000772 bool KeywordVirtualFound = false;
773 bool ImportStatement = false;
Craig Topper2145bc02014-05-09 08:15:10 +0000774 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000775 if (CurrentToken->is(tok::kw_virtual))
776 KeywordVirtualFound = true;
Daniel Jasper8fc7a1e2016-03-22 14:32:20 +0000777 if (Style.Language == FormatStyle::LK_JavaScript) {
778 // export {...} from '...';
779 // An export followed by "from 'some string';" is a re-export from
780 // another module identified by a URI and is treated as a
781 // LT_ImportStatement (i.e. prevent wraps on it for long URIs).
782 // Just "export {...};" or "export class ..." should not be treated as
783 // an import in this sense.
784 if (Line.First->is(tok::kw_export) &&
785 CurrentToken->is(Keywords.kw_from) && CurrentToken->Next &&
786 CurrentToken->Next->isStringLiteral())
787 ImportStatement = true;
788 if (isClosureImportStatement(*CurrentToken))
789 ImportStatement = true;
790 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000791 if (!consumeToken())
792 return LT_Invalid;
793 }
794 if (KeywordVirtualFound)
795 return LT_VirtualFunctionDecl;
Daniel Jasper616de8642014-11-23 16:46:28 +0000796 if (ImportStatement)
797 return LT_ImportStatement;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000798
Daniel Jaspere285b8d2015-06-17 09:43:56 +0000799 if (Line.startsWith(TT_ObjCMethodSpecifier)) {
Craig Topper2145bc02014-05-09 08:15:10 +0000800 if (Contexts.back().FirstObjCSelectorName)
Daniel Jasperc697ad22013-02-06 10:05:46 +0000801 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
802 Contexts.back().LongestObjCSelectorName;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000803 return LT_ObjCMethodDecl;
804 }
805
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000806 return LT_Other;
807 }
808
Nico Weber44449172013-02-12 16:17:07 +0000809private:
Daniel Jasper8fc7a1e2016-03-22 14:32:20 +0000810 bool isClosureImportStatement(const FormatToken &Tok) {
Daniel Jasper616de8642014-11-23 16:46:28 +0000811 // FIXME: Closure-library specific stuff should not be hard-coded but be
812 // configurable.
Daniel Jasper8fc7a1e2016-03-22 14:32:20 +0000813 return Tok.TokenText == "goog" && Tok.Next && Tok.Next->is(tok::period) &&
Daniel Jasper616de8642014-11-23 16:46:28 +0000814 Tok.Next->Next && (Tok.Next->Next->TokenText == "module" ||
Daniel Jasperb488a742015-10-29 19:05:20 +0000815 Tok.Next->Next->TokenText == "provide" ||
Daniel Jasper616de8642014-11-23 16:46:28 +0000816 Tok.Next->Next->TokenText == "require" ||
Daniel Jasper02cbeb22016-02-22 15:06:53 +0000817 Tok.Next->Next->TokenText == "setTestOnly" ||
818 Tok.Next->Next->TokenText == "forwardDeclare") &&
Daniel Jasper53c38f42014-11-27 14:46:03 +0000819 Tok.Next->Next->Next && Tok.Next->Next->Next->is(tok::l_paren);
Daniel Jasper616de8642014-11-23 16:46:28 +0000820 }
821
Manuel Klimek819788d2014-03-18 11:22:45 +0000822 void resetTokenMetadata(FormatToken *Token) {
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000823 if (!Token)
824 return;
Manuel Klimek819788d2014-03-18 11:22:45 +0000825
826 // Reset token type in case we have already looked at it and then
827 // recovered from an error (e.g. failure to find the matching >).
Daniel Jasper66cb8c52015-05-04 09:22:29 +0000828 if (!CurrentToken->isOneOf(TT_LambdaLSquare, TT_ForEachMacro,
829 TT_FunctionLBrace, TT_ImplicitStringLiteral,
Daniel Jasper6f2b88a2015-06-05 13:18:09 +0000830 TT_InlineASMBrace, TT_JsFatArrow, TT_LambdaArrow,
831 TT_RegexLiteral))
Manuel Klimek819788d2014-03-18 11:22:45 +0000832 CurrentToken->Type = TT_Unknown;
David Blaikie3875a822014-07-19 01:06:45 +0000833 CurrentToken->Role.reset();
Daniel Jasperd1debfc2015-01-21 18:04:02 +0000834 CurrentToken->MatchingParen = nullptr;
Manuel Klimek819788d2014-03-18 11:22:45 +0000835 CurrentToken->FakeLParens.clear();
836 CurrentToken->FakeRParens = 0;
837 }
838
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000839 void next() {
Craig Topper2145bc02014-05-09 08:15:10 +0000840 if (CurrentToken) {
Daniel Jasper63af7c42013-12-09 14:40:19 +0000841 CurrentToken->NestingLevel = Contexts.size() - 1;
Daniel Jasper78b45332014-08-14 10:52:56 +0000842 CurrentToken->BindingStrength = Contexts.back().BindingStrength;
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000843 modifyContext(*CurrentToken);
Daniel Jasper78b45332014-08-14 10:52:56 +0000844 determineTokenType(*CurrentToken);
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000845 CurrentToken = CurrentToken->Next;
Daniel Jasperf9ae3122014-05-08 07:01:45 +0000846 }
Daniel Jasper5065bc42013-02-18 12:44:35 +0000847
Manuel Klimek819788d2014-03-18 11:22:45 +0000848 resetTokenMetadata(CurrentToken);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000849 }
850
Daniel Jasperc697ad22013-02-06 10:05:46 +0000851 /// \brief A struct to hold information valid in a specific context, e.g.
852 /// a pair of parenthesis.
853 struct Context {
Daniel Jasper40aacf42013-03-14 13:45:21 +0000854 Context(tok::TokenKind ContextKind, unsigned BindingStrength,
855 bool IsExpression)
856 : ContextKind(ContextKind), BindingStrength(BindingStrength),
Daniel Jasper2b1865c2015-04-15 07:26:18 +0000857 IsExpression(IsExpression) {}
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000858
Daniel Jasper40aacf42013-03-14 13:45:21 +0000859 tok::TokenKind ContextKind;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000860 unsigned BindingStrength;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000861 bool IsExpression;
Daniel Jasper2b1865c2015-04-15 07:26:18 +0000862 unsigned LongestObjCSelectorName = 0;
863 bool ColonIsForRangeExpr = false;
864 bool ColonIsDictLiteral = false;
865 bool ColonIsObjCMethodExpr = false;
866 FormatToken *FirstObjCSelectorName = nullptr;
867 FormatToken *FirstStartOfName = nullptr;
868 bool CanBeExpression = true;
869 bool InTemplateArgument = false;
870 bool InCtorInitializer = false;
871 bool CaretFound = false;
872 bool IsForEachMacro = false;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000873 };
874
875 /// \brief Puts a new \c Context onto the stack \c Contexts for the lifetime
876 /// of each instance.
877 struct ScopedContextCreator {
878 AnnotatingParser &P;
879
Daniel Jasper40aacf42013-03-14 13:45:21 +0000880 ScopedContextCreator(AnnotatingParser &P, tok::TokenKind ContextKind,
881 unsigned Increase)
882 : P(P) {
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +0000883 P.Contexts.push_back(Context(ContextKind,
884 P.Contexts.back().BindingStrength + Increase,
885 P.Contexts.back().IsExpression));
Daniel Jasperc697ad22013-02-06 10:05:46 +0000886 }
887
888 ~ScopedContextCreator() { P.Contexts.pop_back(); }
889 };
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000890
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000891 void modifyContext(const FormatToken &Current) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000892 if (Current.getPrecedence() == prec::Assignment &&
Daniel Jasper95516cd2015-12-23 18:01:29 +0000893 !Line.First->isOneOf(tok::kw_template, tok::kw_using, tok::kw_return) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000894 (!Current.Previous || Current.Previous->isNot(tok::kw_operator))) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000895 Contexts.back().IsExpression = true;
Daniel Jaspere285b8d2015-06-17 09:43:56 +0000896 if (!Line.startsWith(TT_UnaryOperator)) {
Daniel Jasper75092162015-01-23 19:04:49 +0000897 for (FormatToken *Previous = Current.Previous;
Daniel Jasperbcad0662015-07-21 22:51:00 +0000898 Previous && Previous->Previous &&
899 !Previous->Previous->isOneOf(tok::comma, tok::semi);
Daniel Jasper75092162015-01-23 19:04:49 +0000900 Previous = Previous->Previous) {
901 if (Previous->isOneOf(tok::r_square, tok::r_paren)) {
902 Previous = Previous->MatchingParen;
903 if (!Previous)
904 break;
905 }
Daniel Jasperdc4f7252015-03-11 12:59:49 +0000906 if (Previous->opensScope())
907 break;
Daniel Jasper75092162015-01-23 19:04:49 +0000908 if (Previous->isOneOf(TT_BinaryOperator, TT_UnaryOperator) &&
Daniel Jasper1c220482015-02-25 10:30:06 +0000909 Previous->isOneOf(tok::star, tok::amp, tok::ampamp) &&
910 Previous->Previous && Previous->Previous->isNot(tok::equal))
Daniel Jasper75092162015-01-23 19:04:49 +0000911 Previous->Type = TT_PointerOrReference;
Manuel Klimek5f594f82014-08-13 14:00:41 +0000912 }
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000913 }
Daniel Jasper93101662015-05-19 12:29:27 +0000914 } else if (Current.is(tok::lessless) &&
915 (!Current.Previous || !Current.Previous->is(tok::kw_operator))) {
916 Contexts.back().IsExpression = true;
Daniel Jasper3682fcd2013-12-16 08:36:18 +0000917 } else if (Current.isOneOf(tok::kw_return, tok::kw_throw)) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000918 Contexts.back().IsExpression = true;
Daniel Jasperbcb55ee2014-11-21 14:08:38 +0000919 } else if (Current.is(TT_TrailingReturnArrow)) {
920 Contexts.back().IsExpression = false;
Nico Weber4f113492015-09-15 23:48:17 +0000921 } else if (Current.is(TT_LambdaArrow) || Current.is(Keywords.kw_assert)) {
Daniel Jasper6f2b88a2015-06-05 13:18:09 +0000922 Contexts.back().IsExpression = Style.Language == FormatStyle::LK_Java;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000923 } else if (Current.isOneOf(tok::r_paren, tok::greater, tok::comma)) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000924 for (FormatToken *Previous = Current.Previous;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000925 Previous && Previous->isOneOf(tok::star, tok::amp);
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000926 Previous = Previous->Previous)
Nico Weber44449172013-02-12 16:17:07 +0000927 Previous->Type = TT_PointerOrReference;
Daniel Jasperd27df3d2016-02-01 11:21:07 +0000928 if (Line.MustBeDeclaration && !Contexts.front().InCtorInitializer)
929 Contexts.back().IsExpression = false;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000930 } else if (Current.Previous &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000931 Current.Previous->is(TT_CtorInitializerColon)) {
Daniel Jasper5065bc42013-02-18 12:44:35 +0000932 Contexts.back().IsExpression = true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000933 Contexts.back().InCtorInitializer = true;
Daniel Jasper97b89482013-03-13 07:49:51 +0000934 } else if (Current.is(tok::kw_new)) {
935 Contexts.back().CanBeExpression = false;
Daniel Marjamakie59f8d72015-06-18 10:59:26 +0000936 } else if (Current.isOneOf(tok::semi, tok::exclaim)) {
Daniel Jasperc37de302013-05-03 14:41:24 +0000937 // This should be the condition or increment in a for-loop.
938 Contexts.back().IsExpression = true;
Nico Weber44449172013-02-12 16:17:07 +0000939 }
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000940 }
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000941
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000942 void determineTokenType(FormatToken &Current) {
943 if (!Current.is(TT_Unknown))
944 // The token type is already known.
945 return;
946
947 // Line.MightBeFunctionDecl can only be true after the parentheses of a
948 // function declaration have been found. In this case, 'Current' is a
949 // trailing token of this declaration and thus cannot be a name.
950 if (Current.is(Keywords.kw_instanceof)) {
951 Current.Type = TT_BinaryOperator;
952 } else if (isStartOfName(Current) &&
953 (!Line.MightBeFunctionDecl || Current.NestingLevel != 0)) {
954 Contexts.back().FirstStartOfName = &Current;
955 Current.Type = TT_StartOfName;
Richard Smithe301ba22015-11-11 02:02:15 +0000956 } else if (Current.isOneOf(tok::kw_auto, tok::kw___auto_type)) {
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000957 AutoFound = true;
958 } else if (Current.is(tok::arrow) &&
959 Style.Language == FormatStyle::LK_Java) {
960 Current.Type = TT_LambdaArrow;
961 } else if (Current.is(tok::arrow) && AutoFound && Line.MustBeDeclaration &&
962 Current.NestingLevel == 0) {
963 Current.Type = TT_TrailingReturnArrow;
964 } else if (Current.isOneOf(tok::star, tok::amp, tok::ampamp)) {
965 Current.Type =
966 determineStarAmpUsage(Current, Contexts.back().CanBeExpression &&
967 Contexts.back().IsExpression,
968 Contexts.back().InTemplateArgument);
969 } else if (Current.isOneOf(tok::minus, tok::plus, tok::caret)) {
970 Current.Type = determinePlusMinusCaretUsage(Current);
971 if (Current.is(TT_UnaryOperator) && Current.is(tok::caret))
972 Contexts.back().CaretFound = true;
973 } else if (Current.isOneOf(tok::minusminus, tok::plusplus)) {
974 Current.Type = determineIncrementUsage(Current);
975 } else if (Current.isOneOf(tok::exclaim, tok::tilde)) {
976 Current.Type = TT_UnaryOperator;
977 } else if (Current.is(tok::question)) {
Daniel Jasper9326f912015-05-05 08:40:32 +0000978 if (Style.Language == FormatStyle::LK_JavaScript &&
979 Line.MustBeDeclaration) {
980 // In JavaScript, `interface X { foo?(): bar; }` is an optional method
981 // on the interface, not a ternary expression.
982 Current.Type = TT_JsTypeOptionalQuestion;
983 } else {
984 Current.Type = TT_ConditionalExpr;
985 }
Daniel Jaspera98b7b02014-11-25 10:05:17 +0000986 } else if (Current.isBinaryOperator() &&
987 (!Current.Previous || Current.Previous->isNot(tok::l_square))) {
988 Current.Type = TT_BinaryOperator;
989 } else if (Current.is(tok::comment)) {
Daniel Jasper62c78f52015-05-06 08:58:57 +0000990 if (Current.TokenText.startswith("/*")) {
991 if (Current.TokenText.endswith("*/"))
992 Current.Type = TT_BlockComment;
993 else
994 // The lexer has for some reason determined a comment here. But we
995 // cannot really handle it, if it isn't properly terminated.
996 Current.Tok.setKind(tok::unknown);
997 } else {
998 Current.Type = TT_LineComment;
999 }
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001000 } else if (Current.is(tok::r_paren)) {
1001 if (rParenEndsCast(Current))
1002 Current.Type = TT_CastRParen;
Daniel Jasper47bbda02015-05-18 13:47:23 +00001003 if (Current.MatchingParen && Current.Next &&
1004 !Current.Next->isBinaryOperator() &&
Daniel Jasper32739302015-05-27 04:55:47 +00001005 !Current.Next->isOneOf(tok::semi, tok::colon, tok::l_brace))
Daniel Jasper47bbda02015-05-18 13:47:23 +00001006 if (FormatToken *BeforeParen = Current.MatchingParen->Previous)
1007 if (BeforeParen->is(tok::identifier) &&
1008 BeforeParen->TokenText == BeforeParen->TokenText.upper() &&
1009 (!BeforeParen->Previous ||
1010 BeforeParen->Previous->ClosesTemplateDeclaration))
1011 Current.Type = TT_FunctionAnnotationRParen;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001012 } else if (Current.is(tok::at) && Current.Next) {
Daniel Jasper015c7a92015-05-11 15:15:48 +00001013 if (Current.Next->isStringLiteral()) {
1014 Current.Type = TT_ObjCStringLiteral;
1015 } else {
1016 switch (Current.Next->Tok.getObjCKeywordID()) {
1017 case tok::objc_interface:
1018 case tok::objc_implementation:
1019 case tok::objc_protocol:
1020 Current.Type = TT_ObjCDecl;
1021 break;
1022 case tok::objc_property:
1023 Current.Type = TT_ObjCProperty;
1024 break;
1025 default:
1026 break;
1027 }
Aaron Ballman484ee9b2014-11-24 15:42:34 +00001028 }
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001029 } else if (Current.is(tok::period)) {
1030 FormatToken *PreviousNoComment = Current.getPreviousNonComment();
1031 if (PreviousNoComment &&
1032 PreviousNoComment->isOneOf(tok::comma, tok::l_brace))
1033 Current.Type = TT_DesignatedInitializerPeriod;
Nico Weberbeb03932015-01-09 23:25:06 +00001034 else if (Style.Language == FormatStyle::LK_Java && Current.Previous &&
1035 Current.Previous->isOneOf(TT_JavaAnnotation,
1036 TT_LeadingJavaAnnotation)) {
1037 Current.Type = Current.Previous->Type;
1038 }
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001039 } else if (Current.isOneOf(tok::identifier, tok::kw_const) &&
1040 Current.Previous &&
1041 !Current.Previous->isOneOf(tok::equal, tok::at) &&
1042 Line.MightBeFunctionDecl && Contexts.size() == 1) {
1043 // Line.MightBeFunctionDecl can only be true after the parentheses of a
1044 // function declaration have been found.
1045 Current.Type = TT_TrailingAnnotation;
Daniel Jasper3c42dba2015-02-18 17:17:15 +00001046 } else if ((Style.Language == FormatStyle::LK_Java ||
1047 Style.Language == FormatStyle::LK_JavaScript) &&
1048 Current.Previous) {
Nico Weberbeb03932015-01-09 23:25:06 +00001049 if (Current.Previous->is(tok::at) &&
1050 Current.isNot(Keywords.kw_interface)) {
1051 const FormatToken &AtToken = *Current.Previous;
1052 const FormatToken *Previous = AtToken.getPreviousNonComment();
1053 if (!Previous || Previous->is(TT_LeadingJavaAnnotation))
1054 Current.Type = TT_LeadingJavaAnnotation;
1055 else
1056 Current.Type = TT_JavaAnnotation;
1057 } else if (Current.Previous->is(tok::period) &&
1058 Current.Previous->isOneOf(TT_JavaAnnotation,
1059 TT_LeadingJavaAnnotation)) {
1060 Current.Type = Current.Previous->Type;
1061 }
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001062 }
1063 }
1064
Daniel Jasperdba1c552013-07-02 09:47:29 +00001065 /// \brief Take a guess at whether \p Tok starts a name of a function or
1066 /// variable declaration.
1067 ///
1068 /// This is a heuristic based on whether \p Tok is an identifier following
1069 /// something that is likely a type.
1070 bool isStartOfName(const FormatToken &Tok) {
Craig Topper2145bc02014-05-09 08:15:10 +00001071 if (Tok.isNot(tok::identifier) || !Tok.Previous)
Daniel Jasperdba1c552013-07-02 09:47:29 +00001072 return false;
1073
Daniel Jasper043ac052015-07-03 10:12:53 +00001074 if (Tok.Previous->isOneOf(TT_LeadingJavaAnnotation, Keywords.kw_instanceof))
Jacques Pienaarfc275112015-02-18 23:48:37 +00001075 return false;
Daniel Jasper1ce41112016-02-01 11:20:47 +00001076 if (Style.Language == FormatStyle::LK_JavaScript &&
1077 Tok.Previous->is(Keywords.kw_in))
1078 return false;
Daniel Jasper404658a2015-01-14 10:00:20 +00001079
Daniel Jasperdba1c552013-07-02 09:47:29 +00001080 // Skip "const" as it does not have an influence on whether this is a name.
1081 FormatToken *PreviousNotConst = Tok.Previous;
Craig Topper2145bc02014-05-09 08:15:10 +00001082 while (PreviousNotConst && PreviousNotConst->is(tok::kw_const))
Daniel Jasperdba1c552013-07-02 09:47:29 +00001083 PreviousNotConst = PreviousNotConst->Previous;
1084
Craig Topper2145bc02014-05-09 08:15:10 +00001085 if (!PreviousNotConst)
Daniel Jasperdba1c552013-07-02 09:47:29 +00001086 return false;
1087
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +00001088 bool IsPPKeyword = PreviousNotConst->is(tok::identifier) &&
1089 PreviousNotConst->Previous &&
1090 PreviousNotConst->Previous->is(tok::hash);
Daniel Jasperdba1c552013-07-02 09:47:29 +00001091
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001092 if (PreviousNotConst->is(TT_TemplateCloser))
Daniel Jasper53643062013-08-19 10:16:18 +00001093 return PreviousNotConst && PreviousNotConst->MatchingParen &&
1094 PreviousNotConst->MatchingParen->Previous &&
Daniel Jaspercaf86852014-11-20 09:48:11 +00001095 PreviousNotConst->MatchingParen->Previous->isNot(tok::period) &&
Daniel Jasper53643062013-08-19 10:16:18 +00001096 PreviousNotConst->MatchingParen->Previous->isNot(tok::kw_template);
1097
Daniel Jasperf10a28d2014-05-05 13:48:09 +00001098 if (PreviousNotConst->is(tok::r_paren) && PreviousNotConst->MatchingParen &&
1099 PreviousNotConst->MatchingParen->Previous &&
1100 PreviousNotConst->MatchingParen->Previous->is(tok::kw_decltype))
1101 return true;
1102
Daniel Jasperaf642c62015-08-25 13:40:51 +00001103 return (!IsPPKeyword &&
1104 PreviousNotConst->isOneOf(tok::identifier, tok::kw_auto)) ||
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001105 PreviousNotConst->is(TT_PointerOrReference) ||
Daniel Jaspercb51cf42014-01-16 09:11:55 +00001106 PreviousNotConst->isSimpleTypeSpecifier();
Daniel Jasperdba1c552013-07-02 09:47:29 +00001107 }
1108
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +00001109 /// \brief Determine whether ')' is ending a cast.
1110 bool rParenEndsCast(const FormatToken &Tok) {
Daniel Jasper569369c2015-11-23 15:55:55 +00001111 // C-style casts are only used in C++ and Java.
1112 if (Style.Language != FormatStyle::LK_Cpp &&
1113 Style.Language != FormatStyle::LK_Java)
1114 return false;
Daniel Jasper9bb30012015-11-23 15:55:50 +00001115
Daniel Jasper569369c2015-11-23 15:55:55 +00001116 // Empty parens aren't casts and there are no casts at the end of the line.
1117 if (Tok.Previous == Tok.MatchingParen || !Tok.Next || !Tok.MatchingParen)
1118 return false;
1119
1120 FormatToken *LeftOfParens = Tok.MatchingParen->getPreviousNonComment();
Daniel Jasper9bb30012015-11-23 15:55:50 +00001121 if (LeftOfParens) {
Daniel Jasper8e8b4fb2015-11-23 19:11:45 +00001122 // If there is an opening parenthesis left of the current parentheses,
1123 // look past it as these might be chained casts.
1124 if (LeftOfParens->is(tok::r_paren)) {
1125 if (!LeftOfParens->MatchingParen ||
1126 !LeftOfParens->MatchingParen->Previous)
1127 return false;
1128 LeftOfParens = LeftOfParens->MatchingParen->Previous;
1129 }
1130
Daniel Jasper569369c2015-11-23 15:55:55 +00001131 // If there is an identifier (or with a few exceptions a keyword) right
1132 // before the parentheses, this is unlikely to be a cast.
Daniel Jasper9bb30012015-11-23 15:55:50 +00001133 if (LeftOfParens->Tok.getIdentifierInfo() &&
1134 !LeftOfParens->isOneOf(Keywords.kw_in, tok::kw_return, tok::kw_case,
1135 tok::kw_delete))
1136 return false;
Daniel Jasper569369c2015-11-23 15:55:55 +00001137
1138 // Certain other tokens right before the parentheses are also signals that
1139 // this cannot be a cast.
1140 if (LeftOfParens->isOneOf(tok::at, tok::r_square, TT_OverloadedOperator,
Daniel Jasper9bb30012015-11-23 15:55:50 +00001141 TT_TemplateCloser))
1142 return false;
Daniel Jasper9bb30012015-11-23 15:55:50 +00001143 }
Daniel Jasper569369c2015-11-23 15:55:55 +00001144
1145 if (Tok.Next->is(tok::question))
1146 return false;
1147
1148 // As Java has no function types, a "(" after the ")" likely means that this
1149 // is a cast.
1150 if (Style.Language == FormatStyle::LK_Java && Tok.Next->is(tok::l_paren))
1151 return true;
1152
1153 // If a (non-string) literal follows, this is likely a cast.
1154 if (Tok.Next->isNot(tok::string_literal) &&
1155 (Tok.Next->Tok.isLiteral() ||
1156 Tok.Next->isOneOf(tok::kw_sizeof, tok::kw_alignof)))
1157 return true;
1158
1159 // Heuristically try to determine whether the parentheses contain a type.
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001160 bool ParensAreType =
1161 !Tok.Previous ||
1162 Tok.Previous->isOneOf(TT_PointerOrReference, TT_TemplateCloser) ||
1163 Tok.Previous->isSimpleTypeSpecifier();
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +00001164 bool ParensCouldEndDecl =
Daniel Jasper74331d42015-10-26 12:08:47 +00001165 Tok.Next->isOneOf(tok::equal, tok::semi, tok::l_brace, tok::greater);
Daniel Jaspera85c3312015-12-28 07:44:25 +00001166 if (ParensAreType && !ParensCouldEndDecl)
Daniel Jasper569369c2015-11-23 15:55:55 +00001167 return true;
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +00001168
Daniel Jasper569369c2015-11-23 15:55:55 +00001169 // At this point, we heuristically assume that there are no casts at the
1170 // start of the line. We assume that we have found most cases where there
1171 // are by the logic above, e.g. "(void)x;".
1172 if (!LeftOfParens)
1173 return false;
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +00001174
Daniel Jasper569369c2015-11-23 15:55:55 +00001175 // If the following token is an identifier, this is a cast. All cases where
1176 // this can be something else are handled above.
1177 if (Tok.Next->is(tok::identifier))
1178 return true;
1179
1180 if (!Tok.Next->Next)
1181 return false;
1182
1183 // If the next token after the parenthesis is a unary operator, assume
1184 // that this is cast, unless there are unexpected tokens inside the
1185 // parenthesis.
1186 bool NextIsUnary =
1187 Tok.Next->isUnaryOperator() || Tok.Next->isOneOf(tok::amp, tok::star);
1188 if (!NextIsUnary || Tok.Next->is(tok::plus) ||
1189 !Tok.Next->Next->isOneOf(tok::identifier, tok::numeric_constant))
1190 return false;
1191 // Search for unexpected tokens.
1192 for (FormatToken *Prev = Tok.Previous; Prev != Tok.MatchingParen;
1193 Prev = Prev->Previous) {
1194 if (!Prev->isOneOf(tok::kw_const, tok::identifier, tok::coloncolon))
1195 return false;
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +00001196 }
Daniel Jasper569369c2015-11-23 15:55:55 +00001197 return true;
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +00001198 }
1199
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001200 /// \brief Return the type of the given token assuming it is * or &.
Manuel Klimekf81e5c02014-03-27 11:17:36 +00001201 TokenType determineStarAmpUsage(const FormatToken &Tok, bool IsExpression,
1202 bool InTemplateArgument) {
Daniel Jasper3a038de2014-09-05 08:53:45 +00001203 if (Style.Language == FormatStyle::LK_JavaScript)
1204 return TT_BinaryOperator;
1205
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001206 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Craig Topper2145bc02014-05-09 08:15:10 +00001207 if (!PrevToken)
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001208 return TT_UnaryOperator;
1209
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001210 const FormatToken *NextToken = Tok.getNextNonComment();
Daniel Jasper5d7f06f2015-08-24 14:28:08 +00001211 if (!NextToken ||
1212 NextToken->isOneOf(tok::arrow, Keywords.kw_final,
1213 Keywords.kw_override) ||
Daniel Jasperbcb55ee2014-11-21 14:08:38 +00001214 (NextToken->is(tok::l_brace) && !NextToken->getNextNonComment()))
Daniel Jasper5d7f06f2015-08-24 14:28:08 +00001215 return TT_PointerOrReference;
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001216
Daniel Jasper73e171f2014-08-29 12:54:38 +00001217 if (PrevToken->is(tok::coloncolon))
Daniel Jasper8eb371b2013-03-01 17:13:29 +00001218 return TT_PointerOrReference;
1219
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001220 if (PrevToken->isOneOf(tok::l_paren, tok::l_square, tok::l_brace,
Daniel Jasperae907642013-03-14 10:50:25 +00001221 tok::comma, tok::semi, tok::kw_return, tok::colon,
Aaron Ballman484ee9b2014-11-24 15:42:34 +00001222 tok::equal, tok::kw_delete, tok::kw_sizeof) ||
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001223 PrevToken->isOneOf(TT_BinaryOperator, TT_ConditionalExpr,
1224 TT_UnaryOperator, TT_CastRParen))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001225 return TT_UnaryOperator;
1226
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001227 if (NextToken->is(tok::l_square) && NextToken->isNot(TT_LambdaLSquare))
Nico Weber5d2624e2013-02-06 06:20:11 +00001228 return TT_PointerOrReference;
Daniel Jasper0ea4d792015-10-07 01:41:14 +00001229 if (NextToken->is(tok::kw_operator) && !IsExpression)
1230 return TT_PointerOrReference;
1231 if (NextToken->isOneOf(tok::comma, tok::semi))
Daniel Jasper32ccb032014-06-23 07:36:18 +00001232 return TT_PointerOrReference;
Nico Weber5d2624e2013-02-06 06:20:11 +00001233
Daniel Jasper71665cd2013-09-10 10:26:38 +00001234 if (PrevToken->is(tok::r_paren) && PrevToken->MatchingParen &&
1235 PrevToken->MatchingParen->Previous &&
Daniel Jasper4ac7de72014-06-11 07:35:16 +00001236 PrevToken->MatchingParen->Previous->isOneOf(tok::kw_typeof,
1237 tok::kw_decltype))
Daniel Jasper71665cd2013-09-10 10:26:38 +00001238 return TT_PointerOrReference;
1239
Manuel Klimek94815562014-03-28 09:27:09 +00001240 if (PrevToken->Tok.isLiteral() ||
1241 PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::kw_true,
Daniel Jasperf0c809a2014-10-28 18:28:22 +00001242 tok::kw_false, tok::r_brace) ||
Manuel Klimek94815562014-03-28 09:27:09 +00001243 NextToken->Tok.isLiteral() ||
1244 NextToken->isOneOf(tok::kw_true, tok::kw_false) ||
1245 NextToken->isUnaryOperator() ||
Manuel Klimekf81e5c02014-03-27 11:17:36 +00001246 // If we know we're in a template argument, there are no named
1247 // declarations. Thus, having an identifier on the right-hand side
1248 // indicates a binary operator.
1249 (InTemplateArgument && NextToken->Tok.isAnyIdentifier()))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001250 return TT_BinaryOperator;
1251
Daniel Jasper13a7f462014-10-28 18:11:52 +00001252 // "&&(" is quite unlikely to be two successive unary "&".
1253 if (Tok.is(tok::ampamp) && NextToken && NextToken->is(tok::l_paren))
1254 return TT_BinaryOperator;
1255
Daniel Jasper7d028292014-06-02 11:54:20 +00001256 // This catches some cases where evaluation order is used as control flow:
1257 // aaa && aaa->f();
1258 const FormatToken *NextNextToken = NextToken->getNextNonComment();
1259 if (NextNextToken && NextNextToken->is(tok::arrow))
1260 return TT_BinaryOperator;
1261
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001262 // It is very unlikely that we are going to find a pointer or reference type
1263 // definition on the RHS of an assignment.
Daniel Jasperbb86d842014-11-23 19:15:35 +00001264 if (IsExpression && !Contexts.back().CaretFound)
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001265 return TT_BinaryOperator;
1266
1267 return TT_PointerOrReference;
1268 }
1269
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001270 TokenType determinePlusMinusCaretUsage(const FormatToken &Tok) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001271 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001272 if (!PrevToken || PrevToken->is(TT_CastRParen))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001273 return TT_UnaryOperator;
1274
1275 // Use heuristics to recognize unary operators.
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001276 if (PrevToken->isOneOf(tok::equal, tok::l_paren, tok::comma, tok::l_square,
1277 tok::question, tok::colon, tok::kw_return,
1278 tok::kw_case, tok::at, tok::l_brace))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001279 return TT_UnaryOperator;
1280
Nico Weberb76de882013-02-05 16:21:00 +00001281 // There can't be two consecutive binary operators.
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001282 if (PrevToken->is(TT_BinaryOperator))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001283 return TT_UnaryOperator;
1284
1285 // Fall back to marking the token as binary operator.
1286 return TT_BinaryOperator;
1287 }
1288
1289 /// \brief Determine whether ++/-- are pre- or post-increments/-decrements.
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001290 TokenType determineIncrementUsage(const FormatToken &Tok) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001291 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001292 if (!PrevToken || PrevToken->is(TT_CastRParen))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001293 return TT_UnaryOperator;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001294 if (PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::identifier))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001295 return TT_TrailingUnaryOperator;
1296
1297 return TT_UnaryOperator;
1298 }
Daniel Jasperc697ad22013-02-06 10:05:46 +00001299
1300 SmallVector<Context, 8> Contexts;
1301
Daniel Jasper8de9ed02013-08-22 15:00:41 +00001302 const FormatStyle &Style;
Daniel Jasperc697ad22013-02-06 10:05:46 +00001303 AnnotatedLine &Line;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001304 FormatToken *CurrentToken;
Daniel Jasper6cdec7c2013-07-09 14:36:48 +00001305 bool AutoFound;
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00001306 const AdditionalKeywords &Keywords;
Daniel Jasper4d9ec172015-05-06 08:38:24 +00001307
1308 // Set of "<" tokens that do not open a template parameter list. If parseAngle
1309 // determines that a specific token can't be a template opener, it will make
1310 // same decision irrespective of the decisions for tokens leading up to it.
1311 // Store this information to prevent this from causing exponential runtime.
1312 llvm::SmallPtrSet<FormatToken *, 16> NonTemplateLess;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001313};
1314
Benjamin Kramer28b45ce2015-03-08 16:06:46 +00001315static const int PrecedenceUnaryOperator = prec::PointerToMember + 1;
1316static const int PrecedenceArrowAndPeriod = prec::PointerToMember + 2;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001317
Daniel Jasper400adc62013-02-08 15:28:42 +00001318/// \brief Parses binary expressions by inserting fake parenthesis based on
1319/// operator precedence.
1320class ExpressionParser {
1321public:
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00001322 ExpressionParser(const FormatStyle &Style, const AdditionalKeywords &Keywords,
1323 AnnotatedLine &Line)
1324 : Style(Style), Keywords(Keywords), Current(Line.First) {}
Daniel Jasper400adc62013-02-08 15:28:42 +00001325
1326 /// \brief Parse expressions with the given operatore precedence.
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001327 void parse(int Precedence = 0) {
Daniel Jasperf48b5ab2013-11-07 19:23:49 +00001328 // Skip 'return' and ObjC selector colons as they are not part of a binary
1329 // expression.
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001330 while (Current && (Current->is(tok::kw_return) ||
1331 (Current->is(tok::colon) &&
1332 Current->isOneOf(TT_ObjCMethodExpr, TT_DictLiteral))))
Daniel Jaspereabede62013-09-30 08:29:03 +00001333 next();
1334
Craig Topper2145bc02014-05-09 08:15:10 +00001335 if (!Current || Precedence > PrecedenceArrowAndPeriod)
Daniel Jasper0649d362013-08-23 15:14:03 +00001336 return;
1337
Daniel Jasper2c611c02013-05-31 14:56:12 +00001338 // Conditional expressions need to be parsed separately for proper nesting.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001339 if (Precedence == prec::Conditional) {
Daniel Jasper2c611c02013-05-31 14:56:12 +00001340 parseConditionalExpr();
1341 return;
1342 }
Daniel Jasper0649d362013-08-23 15:14:03 +00001343
1344 // Parse unary operators, which all have a higher precedence than binary
1345 // operators.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001346 if (Precedence == PrecedenceUnaryOperator) {
Daniel Jasper0649d362013-08-23 15:14:03 +00001347 parseUnaryOperator();
Daniel Jasper400adc62013-02-08 15:28:42 +00001348 return;
Daniel Jasper0649d362013-08-23 15:14:03 +00001349 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001350
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001351 FormatToken *Start = Current;
Craig Topper2145bc02014-05-09 08:15:10 +00001352 FormatToken *LatestOperator = nullptr;
Daniel Jasper0e617842014-04-16 12:26:54 +00001353 unsigned OperatorIndex = 0;
Daniel Jasper400adc62013-02-08 15:28:42 +00001354
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001355 while (Current) {
Daniel Jasper400adc62013-02-08 15:28:42 +00001356 // Consume operators with higher precedence.
Daniel Jasper6bee6822013-04-08 20:33:42 +00001357 parse(Precedence + 1);
Daniel Jasper400adc62013-02-08 15:28:42 +00001358
Daniel Jasper0649d362013-08-23 15:14:03 +00001359 int CurrentPrecedence = getCurrentPrecedence();
1360
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001361 if (Current && Current->is(TT_SelectorName) &&
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001362 Precedence == CurrentPrecedence) {
1363 if (LatestOperator)
1364 addFakeParenthesis(Start, prec::Level(Precedence));
Daniel Jasper0649d362013-08-23 15:14:03 +00001365 Start = Current;
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001366 }
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001367
Daniel Jasper400adc62013-02-08 15:28:42 +00001368 // At the end of the line or when an operator with higher precedence is
1369 // found, insert fake parenthesis and return.
Daniel Jasper86296e32014-10-20 11:12:51 +00001370 if (!Current || (Current->closesScope() && Current->MatchingParen) ||
Daniel Jasper6c22c442014-11-14 13:03:40 +00001371 (CurrentPrecedence != -1 && CurrentPrecedence < Precedence) ||
1372 (CurrentPrecedence == prec::Conditional &&
1373 Precedence == prec::Assignment && Current->is(tok::colon))) {
Daniel Jasper83791072014-12-03 13:20:49 +00001374 break;
Daniel Jasper400adc62013-02-08 15:28:42 +00001375 }
1376
1377 // Consume scopes: (), [], <> and {}
Daniel Jasperc04baae2013-04-10 09:49:49 +00001378 if (Current->opensScope()) {
1379 while (Current && !Current->closesScope()) {
Daniel Jasper400adc62013-02-08 15:28:42 +00001380 next();
1381 parse();
1382 }
1383 next();
1384 } else {
1385 // Operator found.
Daniel Jasper0e617842014-04-16 12:26:54 +00001386 if (CurrentPrecedence == Precedence) {
Daniel Jasper00492f92016-01-05 13:03:50 +00001387 if (LatestOperator)
1388 LatestOperator->NextOperator = Current;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001389 LatestOperator = Current;
Daniel Jasper0e617842014-04-16 12:26:54 +00001390 Current->OperatorIndex = OperatorIndex;
1391 ++OperatorIndex;
1392 }
Daniel Jasper3eb341c2014-11-11 23:04:51 +00001393 next(/*SkipPastLeadingComments=*/Precedence > 0);
Daniel Jasper400adc62013-02-08 15:28:42 +00001394 }
1395 }
Daniel Jasper83791072014-12-03 13:20:49 +00001396
1397 if (LatestOperator && (Current || Precedence > 0)) {
Daniel Jasper00492f92016-01-05 13:03:50 +00001398 // LatestOperator->LastOperator = true;
Daniel Jasper83791072014-12-03 13:20:49 +00001399 if (Precedence == PrecedenceArrowAndPeriod) {
1400 // Call expressions don't have a binary operator precedence.
1401 addFakeParenthesis(Start, prec::Unknown);
1402 } else {
1403 addFakeParenthesis(Start, prec::Level(Precedence));
1404 }
1405 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001406 }
1407
1408private:
Daniel Jasper0649d362013-08-23 15:14:03 +00001409 /// \brief Gets the precedence (+1) of the given token for binary operators
1410 /// and other tokens that we treat like binary operators.
1411 int getCurrentPrecedence() {
1412 if (Current) {
Daniel Jasper97bfb7b2014-09-05 08:29:31 +00001413 const FormatToken *NextNonComment = Current->getNextNonComment();
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001414 if (Current->is(TT_ConditionalExpr))
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001415 return prec::Conditional;
Daniel Jasper3c306e82015-06-03 17:08:40 +00001416 if (NextNonComment && NextNonComment->is(tok::colon) &&
1417 NextNonComment->is(TT_DictLiteral))
Daniel Jasper97bfb7b2014-09-05 08:29:31 +00001418 return prec::Comma;
Daniel Jasper3c306e82015-06-03 17:08:40 +00001419 if (Current->is(TT_LambdaArrow))
Daniel Jasper8354ea82014-11-21 12:14:12 +00001420 return prec::Comma;
Daniel Jasper3c306e82015-06-03 17:08:40 +00001421 if (Current->is(TT_JsFatArrow))
Daniel Jasper3b0f3042015-06-05 08:25:37 +00001422 return prec::Assignment;
Daniel Jasper3c306e82015-06-03 17:08:40 +00001423 if (Current->isOneOf(tok::semi, TT_InlineASMColon, TT_SelectorName,
1424 TT_JsComputedPropertyName) ||
1425 (Current->is(tok::comment) && NextNonComment &&
1426 NextNonComment->is(TT_SelectorName)))
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001427 return 0;
Daniel Jasper3c306e82015-06-03 17:08:40 +00001428 if (Current->is(TT_RangeBasedForLoopColon))
Daniel Jasper9cc3e972014-02-07 10:09:46 +00001429 return prec::Comma;
Daniel Jasper043ac052015-07-03 10:12:53 +00001430 if ((Style.Language == FormatStyle::LK_Java ||
1431 Style.Language == FormatStyle::LK_JavaScript) &&
1432 Current->is(Keywords.kw_instanceof))
1433 return prec::Relational;
Daniel Jasper1ce41112016-02-01 11:20:47 +00001434 if (Style.Language == FormatStyle::LK_JavaScript &&
1435 Current->is(Keywords.kw_in))
1436 return prec::Relational;
Daniel Jasper3c306e82015-06-03 17:08:40 +00001437 if (Current->is(TT_BinaryOperator) || Current->is(tok::comma))
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001438 return Current->getPrecedence();
Daniel Jasper3c306e82015-06-03 17:08:40 +00001439 if (Current->isOneOf(tok::period, tok::arrow))
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001440 return PrecedenceArrowAndPeriod;
Daniel Jasper3c306e82015-06-03 17:08:40 +00001441 if (Style.Language == FormatStyle::LK_Java &&
1442 Current->isOneOf(Keywords.kw_extends, Keywords.kw_implements,
1443 Keywords.kw_throws))
Daniel Jasper50b4bd72014-11-02 19:16:41 +00001444 return 0;
Daniel Jasper0649d362013-08-23 15:14:03 +00001445 }
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001446 return -1;
Daniel Jasper0649d362013-08-23 15:14:03 +00001447 }
1448
Daniel Jasper2c611c02013-05-31 14:56:12 +00001449 void addFakeParenthesis(FormatToken *Start, prec::Level Precedence) {
1450 Start->FakeLParens.push_back(Precedence);
Daniel Jasper562ecd42013-09-06 08:08:14 +00001451 if (Precedence > prec::Unknown)
1452 Start->StartsBinaryExpression = true;
1453 if (Current) {
Daniel Jasper119ff532014-11-14 12:31:14 +00001454 FormatToken *Previous = Current->Previous;
Daniel Jasperc0956632014-12-03 14:02:59 +00001455 while (Previous->is(tok::comment) && Previous->Previous)
Daniel Jasper119ff532014-11-14 12:31:14 +00001456 Previous = Previous->Previous;
1457 ++Previous->FakeRParens;
Daniel Jasper562ecd42013-09-06 08:08:14 +00001458 if (Precedence > prec::Unknown)
Daniel Jasper119ff532014-11-14 12:31:14 +00001459 Previous->EndsBinaryExpression = true;
Daniel Jasper562ecd42013-09-06 08:08:14 +00001460 }
Daniel Jasper2c611c02013-05-31 14:56:12 +00001461 }
1462
Daniel Jasper0649d362013-08-23 15:14:03 +00001463 /// \brief Parse unary operator expressions and surround them with fake
1464 /// parentheses if appropriate.
1465 void parseUnaryOperator() {
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001466 if (!Current || Current->isNot(TT_UnaryOperator)) {
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001467 parse(PrecedenceArrowAndPeriod);
Daniel Jasper0649d362013-08-23 15:14:03 +00001468 return;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001469 }
Daniel Jasper0649d362013-08-23 15:14:03 +00001470
1471 FormatToken *Start = Current;
1472 next();
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001473 parseUnaryOperator();
Daniel Jasper0649d362013-08-23 15:14:03 +00001474
Daniel Jasper0649d362013-08-23 15:14:03 +00001475 // The actual precedence doesn't matter.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001476 addFakeParenthesis(Start, prec::Unknown);
Daniel Jasper0649d362013-08-23 15:14:03 +00001477 }
1478
Daniel Jasper2c611c02013-05-31 14:56:12 +00001479 void parseConditionalExpr() {
Daniel Jasper1a31bab2014-10-16 09:10:11 +00001480 while (Current && Current->isTrailingComment()) {
1481 next();
1482 }
Daniel Jasper2c611c02013-05-31 14:56:12 +00001483 FormatToken *Start = Current;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001484 parse(prec::LogicalOr);
Daniel Jasper2c611c02013-05-31 14:56:12 +00001485 if (!Current || !Current->is(tok::question))
1486 return;
1487 next();
Daniel Jasper6c22c442014-11-14 13:03:40 +00001488 parse(prec::Assignment);
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001489 if (!Current || Current->isNot(TT_ConditionalExpr))
Daniel Jasper2c611c02013-05-31 14:56:12 +00001490 return;
1491 next();
Daniel Jasper6c22c442014-11-14 13:03:40 +00001492 parse(prec::Assignment);
Daniel Jasper2c611c02013-05-31 14:56:12 +00001493 addFakeParenthesis(Start, prec::Conditional);
1494 }
1495
Daniel Jasper94e11d02014-09-04 14:58:30 +00001496 void next(bool SkipPastLeadingComments = true) {
Alexander Kornienkoafaa8f52013-06-17 13:19:53 +00001497 if (Current)
1498 Current = Current->Next;
Daniel Jasper94e11d02014-09-04 14:58:30 +00001499 while (Current &&
1500 (Current->NewlinesBefore == 0 || SkipPastLeadingComments) &&
1501 Current->isTrailingComment())
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001502 Current = Current->Next;
Daniel Jasper400adc62013-02-08 15:28:42 +00001503 }
1504
Daniel Jasper50b4bd72014-11-02 19:16:41 +00001505 const FormatStyle &Style;
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00001506 const AdditionalKeywords &Keywords;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001507 FormatToken *Current;
Daniel Jasper400adc62013-02-08 15:28:42 +00001508};
1509
Craig Topper318ed7c2013-07-01 04:03:19 +00001510} // end anonymous namespace
1511
Nico Weberbeb03932015-01-09 23:25:06 +00001512void TokenAnnotator::setCommentLineLevels(
1513 SmallVectorImpl<AnnotatedLine *> &Lines) {
Craig Topper2145bc02014-05-09 08:15:10 +00001514 const AnnotatedLine *NextNonCommentLine = nullptr;
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001515 for (SmallVectorImpl<AnnotatedLine *>::reverse_iterator I = Lines.rbegin(),
1516 E = Lines.rend();
1517 I != E; ++I) {
1518 if (NextNonCommentLine && (*I)->First->is(tok::comment) &&
Craig Topper2145bc02014-05-09 08:15:10 +00001519 (*I)->First->Next == nullptr)
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001520 (*I)->Level = NextNonCommentLine->Level;
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001521 else
Craig Topper2145bc02014-05-09 08:15:10 +00001522 NextNonCommentLine = (*I)->First->isNot(tok::r_brace) ? (*I) : nullptr;
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001523
1524 setCommentLineLevels((*I)->Children);
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001525 }
1526}
1527
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001528void TokenAnnotator::annotate(AnnotatedLine &Line) {
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001529 for (SmallVectorImpl<AnnotatedLine *>::iterator I = Line.Children.begin(),
1530 E = Line.Children.end();
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001531 I != E; ++I) {
1532 annotate(**I);
1533 }
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00001534 AnnotatingParser Parser(Style, Line, Keywords);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001535 Line.Type = Parser.parseLine();
1536 if (Line.Type == LT_Invalid)
1537 return;
1538
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00001539 ExpressionParser ExprParser(Style, Keywords, Line);
Daniel Jasper400adc62013-02-08 15:28:42 +00001540 ExprParser.parse();
1541
Daniel Jaspere285b8d2015-06-17 09:43:56 +00001542 if (Line.startsWith(TT_ObjCMethodSpecifier))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001543 Line.Type = LT_ObjCMethodDecl;
Daniel Jaspere285b8d2015-06-17 09:43:56 +00001544 else if (Line.startsWith(TT_ObjCDecl))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001545 Line.Type = LT_ObjCDecl;
Daniel Jaspere285b8d2015-06-17 09:43:56 +00001546 else if (Line.startsWith(TT_ObjCProperty))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001547 Line.Type = LT_ObjCProperty;
1548
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001549 Line.First->SpacesRequiredBefore = 1;
1550 Line.First->CanBreakBefore = Line.First->MustBreakBefore;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001551}
1552
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001553// This function heuristically determines whether 'Current' starts the name of a
1554// function declaration.
1555static bool isFunctionDeclarationName(const FormatToken &Current) {
Birunthan Mohanathas525579d2015-07-15 19:11:58 +00001556 auto skipOperatorName = [](const FormatToken* Next) -> const FormatToken* {
1557 for (; Next; Next = Next->Next) {
1558 if (Next->is(TT_OverloadedOperatorLParen))
1559 return Next;
1560 if (Next->is(TT_OverloadedOperator))
1561 continue;
1562 if (Next->isOneOf(tok::kw_new, tok::kw_delete)) {
1563 // For 'new[]' and 'delete[]'.
1564 if (Next->Next && Next->Next->is(tok::l_square) &&
1565 Next->Next->Next && Next->Next->Next->is(tok::r_square))
1566 Next = Next->Next->Next;
1567 continue;
1568 }
1569
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001570 break;
Birunthan Mohanathas525579d2015-07-15 19:11:58 +00001571 }
1572 return nullptr;
1573 };
1574
1575 const FormatToken *Next = Current.Next;
1576 if (Current.is(tok::kw_operator)) {
1577 if (Current.Previous && Current.Previous->is(tok::coloncolon))
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001578 return false;
Birunthan Mohanathas525579d2015-07-15 19:11:58 +00001579 Next = skipOperatorName(Next);
1580 } else {
1581 if (!Current.is(TT_StartOfName) || Current.NestingLevel != 0)
1582 return false;
1583 for (; Next; Next = Next->Next) {
1584 if (Next->is(TT_TemplateOpener)) {
1585 Next = Next->MatchingParen;
1586 } else if (Next->is(tok::coloncolon)) {
1587 Next = Next->Next;
1588 if (!Next)
1589 return false;
1590 if (Next->is(tok::kw_operator)) {
1591 Next = skipOperatorName(Next->Next);
1592 break;
1593 }
1594 if (!Next->is(tok::identifier))
1595 return false;
1596 } else if (Next->is(tok::l_paren)) {
1597 break;
1598 } else {
1599 return false;
1600 }
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001601 }
1602 }
Birunthan Mohanathas525579d2015-07-15 19:11:58 +00001603
1604 if (!Next || !Next->is(tok::l_paren))
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001605 return false;
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001606 if (Next->Next == Next->MatchingParen)
1607 return true;
Daniel Jasper193cdd32015-01-19 10:52:16 +00001608 for (const FormatToken *Tok = Next->Next; Tok && Tok != Next->MatchingParen;
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001609 Tok = Tok->Next) {
1610 if (Tok->is(tok::kw_const) || Tok->isSimpleTypeSpecifier() ||
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001611 Tok->isOneOf(TT_PointerOrReference, TT_StartOfName))
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001612 return true;
Daniel Jasper0faa9132015-04-23 13:58:40 +00001613 if (Tok->isOneOf(tok::l_brace, tok::string_literal, TT_ObjCMethodExpr) ||
1614 Tok->Tok.isLiteral())
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001615 return false;
1616 }
1617 return false;
1618}
1619
Zachary Turner448592e2015-12-18 22:20:15 +00001620bool TokenAnnotator::mustBreakForReturnType(const AnnotatedLine &Line) const {
1621 assert(Line.MightBeFunctionDecl);
1622
1623 if ((Style.AlwaysBreakAfterReturnType == FormatStyle::RTBS_TopLevel ||
1624 Style.AlwaysBreakAfterReturnType ==
1625 FormatStyle::RTBS_TopLevelDefinitions) &&
1626 Line.Level > 0)
1627 return false;
1628
1629 switch (Style.AlwaysBreakAfterReturnType) {
1630 case FormatStyle::RTBS_None:
1631 return false;
1632 case FormatStyle::RTBS_All:
1633 case FormatStyle::RTBS_TopLevel:
1634 return true;
1635 case FormatStyle::RTBS_AllDefinitions:
1636 case FormatStyle::RTBS_TopLevelDefinitions:
1637 return Line.mightBeFunctionDefinition();
1638 }
1639
1640 return false;
1641}
1642
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001643void TokenAnnotator::calculateFormattingInformation(AnnotatedLine &Line) {
Daniel Jasper5f3ea472014-05-22 08:36:53 +00001644 for (SmallVectorImpl<AnnotatedLine *>::iterator I = Line.Children.begin(),
1645 E = Line.Children.end();
1646 I != E; ++I) {
1647 calculateFormattingInformation(**I);
1648 }
1649
Alexander Kornienko39856b72013-09-10 09:38:25 +00001650 Line.First->TotalLength =
1651 Line.First->IsMultiline ? Style.ColumnLimit : Line.First->ColumnWidth;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001652 if (!Line.First->Next)
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001653 return;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001654 FormatToken *Current = Line.First->Next;
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001655 bool InFunctionDecl = Line.MightBeFunctionDecl;
Craig Topper2145bc02014-05-09 08:15:10 +00001656 while (Current) {
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001657 if (isFunctionDeclarationName(*Current))
1658 Current->Type = TT_FunctionDeclarationName;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001659 if (Current->is(TT_LineComment)) {
Daniel Jasper84a12e12014-03-10 15:06:25 +00001660 if (Current->Previous->BlockKind == BK_BracedInit &&
1661 Current->Previous->opensScope())
Daniel Jasper5a611392013-12-19 21:41:37 +00001662 Current->SpacesRequiredBefore = Style.Cpp11BracedListStyle ? 0 : 1;
1663 else
1664 Current->SpacesRequiredBefore = Style.SpacesBeforeTrailingComments;
Daniel Jasper14e58e52014-03-21 11:58:45 +00001665
1666 // If we find a trailing comment, iterate backwards to determine whether
1667 // it seems to relate to a specific parameter. If so, break before that
1668 // parameter to avoid changing the comment's meaning. E.g. don't move 'b'
1669 // to the previous line in:
1670 // SomeFunction(a,
1671 // b, // comment
1672 // c);
Daniel Jasper28df0a32014-03-21 12:15:40 +00001673 if (!Current->HasUnescapedNewline) {
Daniel Jasper14e58e52014-03-21 11:58:45 +00001674 for (FormatToken *Parameter = Current->Previous; Parameter;
1675 Parameter = Parameter->Previous) {
1676 if (Parameter->isOneOf(tok::comment, tok::r_brace))
1677 break;
1678 if (Parameter->Previous && Parameter->Previous->is(tok::comma)) {
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001679 if (!Parameter->Previous->is(TT_CtorInitializerComma) &&
Daniel Jasper14e58e52014-03-21 11:58:45 +00001680 Parameter->HasUnescapedNewline)
1681 Parameter->MustBreakBefore = true;
1682 break;
1683 }
1684 }
1685 }
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001686 } else if (Current->SpacesRequiredBefore == 0 &&
Daniel Jasper166c19b2014-05-06 14:12:21 +00001687 spaceRequiredBefore(Line, *Current)) {
Alexander Kornienko384b40b2013-10-11 21:43:05 +00001688 Current->SpacesRequiredBefore = 1;
Daniel Jasper5a611392013-12-19 21:41:37 +00001689 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001690
Daniel Jasperfb81b092013-09-17 09:52:48 +00001691 Current->MustBreakBefore =
1692 Current->MustBreakBefore || mustBreakBefore(Line, *Current);
1693
Zachary Turner448592e2015-12-18 22:20:15 +00001694 if (!Current->MustBreakBefore && InFunctionDecl &&
1695 Current->is(TT_FunctionDeclarationName))
1696 Current->MustBreakBefore = mustBreakForReturnType(Line);
Daniel Jasperca4ea1c2014-08-05 12:16:31 +00001697
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001698 Current->CanBreakBefore =
1699 Current->MustBreakBefore || canBreakBefore(Line, *Current);
Daniel Jasper5f3ea472014-05-22 08:36:53 +00001700 unsigned ChildSize = 0;
1701 if (Current->Previous->Children.size() == 1) {
1702 FormatToken &LastOfChild = *Current->Previous->Children[0]->Last;
1703 ChildSize = LastOfChild.isTrailingComment() ? Style.ColumnLimit
1704 : LastOfChild.TotalLength + 1;
1705 }
Nico Weberbeb03932015-01-09 23:25:06 +00001706 const FormatToken *Prev = Current->Previous;
Daniel Jasper56346192014-10-27 16:31:46 +00001707 if (Current->MustBreakBefore || Prev->Children.size() > 1 ||
1708 (Prev->Children.size() == 1 &&
1709 Prev->Children[0]->First->MustBreakBefore) ||
Alexander Kornienko39856b72013-09-10 09:38:25 +00001710 Current->IsMultiline)
Daniel Jasper56346192014-10-27 16:31:46 +00001711 Current->TotalLength = Prev->TotalLength + Style.ColumnLimit;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001712 else
Daniel Jasper56346192014-10-27 16:31:46 +00001713 Current->TotalLength = Prev->TotalLength + Current->ColumnWidth +
1714 ChildSize + Current->SpacesRequiredBefore;
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001715
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001716 if (Current->is(TT_CtorInitializerColon))
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001717 InFunctionDecl = false;
1718
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001719 // FIXME: Only calculate this if CanBreakBefore is true once static
1720 // initializers etc. are sorted out.
1721 // FIXME: Move magic numbers to a better place.
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001722 Current->SplitPenalty = 20 * Current->BindingStrength +
1723 splitPenalty(Line, *Current, InFunctionDecl);
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001724
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001725 Current = Current->Next;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001726 }
Daniel Jasper6bee6822013-04-08 20:33:42 +00001727
Manuel Klimek4fe43002013-05-22 12:51:29 +00001728 calculateUnbreakableTailLengths(Line);
Craig Topper2145bc02014-05-09 08:15:10 +00001729 for (Current = Line.First; Current != nullptr; Current = Current->Next) {
Daniel Jasper8de9ed02013-08-22 15:00:41 +00001730 if (Current->Role)
1731 Current->Role->precomputeFormattingInfos(Current);
1732 }
1733
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001734 DEBUG({ printDebugInfo(Line); });
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001735}
1736
Manuel Klimek4fe43002013-05-22 12:51:29 +00001737void TokenAnnotator::calculateUnbreakableTailLengths(AnnotatedLine &Line) {
1738 unsigned UnbreakableTailLength = 0;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001739 FormatToken *Current = Line.Last;
Craig Topper2145bc02014-05-09 08:15:10 +00001740 while (Current) {
Manuel Klimek4fe43002013-05-22 12:51:29 +00001741 Current->UnbreakableTailLength = UnbreakableTailLength;
1742 if (Current->CanBreakBefore ||
1743 Current->isOneOf(tok::comment, tok::string_literal)) {
1744 UnbreakableTailLength = 0;
1745 } else {
1746 UnbreakableTailLength +=
Alexander Kornienko39856b72013-09-10 09:38:25 +00001747 Current->ColumnWidth + Current->SpacesRequiredBefore;
Manuel Klimek4fe43002013-05-22 12:51:29 +00001748 }
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001749 Current = Current->Previous;
Manuel Klimek4fe43002013-05-22 12:51:29 +00001750 }
1751}
1752
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001753unsigned TokenAnnotator::splitPenalty(const AnnotatedLine &Line,
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001754 const FormatToken &Tok,
1755 bool InFunctionDecl) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001756 const FormatToken &Left = *Tok.Previous;
1757 const FormatToken &Right = Tok;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001758
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00001759 if (Left.is(tok::semi))
1760 return 0;
Daniel Jasper734d52b2014-11-14 10:15:56 +00001761
1762 if (Style.Language == FormatStyle::LK_Java) {
Daniel Jasper375815d2014-11-26 12:31:19 +00001763 if (Right.isOneOf(Keywords.kw_extends, Keywords.kw_throws))
Daniel Jasper734d52b2014-11-14 10:15:56 +00001764 return 1;
1765 if (Right.is(Keywords.kw_implements))
1766 return 2;
1767 if (Left.is(tok::comma) && Left.NestingLevel == 0)
1768 return 3;
Daniel Jasper41368e92014-11-27 15:37:42 +00001769 } else if (Style.Language == FormatStyle::LK_JavaScript) {
Daniel Jasper7325aee2015-05-08 08:38:52 +00001770 if (Right.is(Keywords.kw_function) && Left.isNot(tok::comma))
Daniel Jasper41368e92014-11-27 15:37:42 +00001771 return 100;
Daniel Jasperb9a52812015-07-10 13:39:26 +00001772 if (Left.is(TT_JsTypeColon))
Daniel Jasperf412e262016-01-08 10:51:24 +00001773 return 35;
Daniel Jasper734d52b2014-11-14 10:15:56 +00001774 }
1775
Daniel Jasper783bac62014-04-15 09:54:30 +00001776 if (Left.is(tok::comma) || (Right.is(tok::identifier) && Right.Next &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001777 Right.Next->is(TT_DictLiteral)))
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00001778 return 1;
Daniel Jasper7052ce62014-01-19 09:04:08 +00001779 if (Right.is(tok::l_square)) {
Daniel Jaspere1afb9b2015-12-30 12:23:00 +00001780 if (Style.Language == FormatStyle::LK_Proto)
Daniel Jasper7052ce62014-01-19 09:04:08 +00001781 return 1;
Daniel Jaspere1afb9b2015-12-30 12:23:00 +00001782 if (Left.is(tok::r_square))
Daniel Jasperf9168de2016-03-01 04:19:55 +00001783 return 200;
Daniel Jasper0ad28142015-05-13 08:47:16 +00001784 // Slightly prefer formatting local lambda definitions like functions.
1785 if (Right.is(TT_LambdaLSquare) && Left.is(tok::equal))
Daniel Jasper9c8a7742016-01-04 07:29:40 +00001786 return 35;
Daniel Jasper9970df12015-06-03 08:57:36 +00001787 if (!Right.isOneOf(TT_ObjCMethodExpr, TT_LambdaLSquare,
1788 TT_ArrayInitializerLSquare))
Daniel Jasperecaba172014-06-10 13:27:57 +00001789 return 500;
Daniel Jasper7052ce62014-01-19 09:04:08 +00001790 }
Daniel Jasper734d52b2014-11-14 10:15:56 +00001791
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001792 if (Right.isOneOf(TT_StartOfName, TT_FunctionDeclarationName) ||
1793 Right.is(tok::kw_operator)) {
Daniel Jaspere285b8d2015-06-17 09:43:56 +00001794 if (Line.startsWith(tok::kw_for) && Right.PartOfMultiVariableDeclStmt)
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001795 return 3;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001796 if (Left.is(TT_StartOfName))
Daniel Jasper3ca283a2015-05-15 09:58:11 +00001797 return 110;
Daniel Jasper63af7c42013-12-09 14:40:19 +00001798 if (InFunctionDecl && Right.NestingLevel == 0)
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001799 return Style.PenaltyReturnTypeOnItsOwnLine;
Daniel Jasper53643062013-08-19 10:16:18 +00001800 return 200;
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001801 }
Daniel Jasperb754a742015-03-12 15:04:53 +00001802 if (Right.is(TT_PointerOrReference))
Daniel Jasper414c9c62015-03-19 09:40:16 +00001803 return 190;
Daniel Jasper6f2b88a2015-06-05 13:18:09 +00001804 if (Right.is(TT_LambdaArrow))
Daniel Jaspere6623162015-03-02 10:35:13 +00001805 return 110;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001806 if (Left.is(tok::equal) && Right.is(tok::l_brace))
1807 return 150;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001808 if (Left.is(TT_CastRParen))
Daniel Jasper1bc1b502013-07-05 07:58:34 +00001809 return 100;
Daniel Jasper215d6c82014-01-22 08:04:52 +00001810 if (Left.is(tok::coloncolon) ||
1811 (Right.is(tok::period) && Style.Language == FormatStyle::LK_Proto))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001812 return 500;
Daniel Jasper83193602013-04-05 17:22:09 +00001813 if (Left.isOneOf(tok::kw_class, tok::kw_struct))
1814 return 5000;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001815
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001816 if (Left.isOneOf(TT_RangeBasedForLoopColon, TT_InheritanceColon))
Daniel Jasper16b35622013-02-26 13:18:08 +00001817 return 2;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001818
Daniel Jasper4c6e0052013-08-27 14:24:43 +00001819 if (Right.isMemberAccess()) {
Daniel Jasperf901a572015-12-07 19:50:48 +00001820 // Breaking before the "./->" of a chained call/member access is reasonably
1821 // cheap, as formatting those with one call per line is generally
1822 // desirable. In particular, it should be cheaper to break before the call
1823 // than it is to break inside a call's parameters, which could lead to weird
1824 // "hanging" indents. The exception is the very last "./->" to support this
1825 // frequent pattern:
1826 //
1827 // aaaaaaaa.aaaaaaaa.bbbbbbb().ccccccccccccccccccccc(
1828 // dddddddd);
1829 //
1830 // which might otherwise be blown up onto many lines. Here, clang-format
1831 // won't produce "hanging" indents anyway as there is no other trailing
1832 // call.
Daniel Jasper00492f92016-01-05 13:03:50 +00001833 //
1834 // Also apply higher penalty is not a call as that might lead to a wrapping
1835 // like:
1836 //
1837 // aaaaaaa
1838 // .aaaaaaaaa.bbbbbbbb(cccccccc);
1839 return !Right.NextOperator || !Right.NextOperator->Previous->closesScope()
1840 ? 150
1841 : 35;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001842 }
1843
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001844 if (Right.is(TT_TrailingAnnotation) &&
Daniel Jaspere3f907f2014-06-02 09:52:08 +00001845 (!Right.Next || Right.Next->isNot(tok::l_paren))) {
Daniel Jasperec8e8382014-10-11 08:24:56 +00001846 // Moving trailing annotations to the next line is fine for ObjC method
1847 // declarations.
Daniel Jaspere285b8d2015-06-17 09:43:56 +00001848 if (Line.startsWith(TT_ObjCMethodSpecifier))
Daniel Jasperec8e8382014-10-11 08:24:56 +00001849 return 10;
Daniel Jasper5550de62014-02-17 07:57:46 +00001850 // Generally, breaking before a trailing annotation is bad unless it is
1851 // function-like. It seems to be especially preferable to keep standard
1852 // annotations (i.e. "const", "final" and "override") on the same line.
Daniel Jasper43e6a282013-12-16 15:01:54 +00001853 // Use a slightly higher penalty after ")" so that annotations like
1854 // "const override" are kept together.
Daniel Jasperb48d3af2014-04-09 10:01:49 +00001855 bool is_short_annotation = Right.TokenText.size() < 10;
Daniel Jasperb05a81d2014-05-09 13:11:16 +00001856 return (Left.is(tok::r_paren) ? 100 : 120) + (is_short_annotation ? 50 : 0);
Daniel Jasper43e6a282013-12-16 15:01:54 +00001857 }
Daniel Jasper13c37b32013-05-22 08:28:26 +00001858
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001859 // In for-loops, prefer breaking at ',' and ';'.
Daniel Jaspere285b8d2015-06-17 09:43:56 +00001860 if (Line.startsWith(tok::kw_for) && Left.is(tok::equal))
Daniel Jasper37905f72013-02-21 15:00:29 +00001861 return 4;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001862
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001863 // In Objective-C method expressions, prefer breaking before "param:" over
1864 // breaking after it.
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001865 if (Right.is(TT_SelectorName))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001866 return 0;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001867 if (Left.is(tok::colon) && Left.is(TT_ObjCMethodExpr))
Daniel Jasper4bf0d802013-11-23 14:27:27 +00001868 return Line.MightBeFunctionDecl ? 50 : 500;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001869
Daniel Jasper6501f7e2015-10-27 12:38:37 +00001870 if (Left.is(tok::l_paren) && InFunctionDecl &&
1871 Style.AlignAfterOpenBracket != FormatStyle::BAS_DontAlign)
Daniel Jasper6728fc12013-04-11 14:29:13 +00001872 return 100;
Daniel Jasper3bacc4d2015-07-07 16:09:39 +00001873 if (Left.is(tok::l_paren) && Left.Previous &&
1874 Left.Previous->isOneOf(tok::kw_if, tok::kw_for))
Daniel Jaspera42de762015-02-26 09:49:08 +00001875 return 1000;
Daniel Jasper126153a2013-12-27 06:39:56 +00001876 if (Left.is(tok::equal) && InFunctionDecl)
1877 return 110;
Daniel Jaspera5621202014-08-08 12:00:13 +00001878 if (Right.is(tok::r_brace))
1879 return 1;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001880 if (Left.is(TT_TemplateOpener))
Daniel Jasperea79ea12014-08-15 05:00:39 +00001881 return 100;
Daniel Jasper3aa9a6a2014-11-18 23:55:27 +00001882 if (Left.opensScope()) {
Daniel Jasper6501f7e2015-10-27 12:38:37 +00001883 if (Style.AlignAfterOpenBracket == FormatStyle::BAS_DontAlign)
Daniel Jasper3aa9a6a2014-11-18 23:55:27 +00001884 return 0;
Daniel Jasper33b909c2013-10-25 14:29:37 +00001885 return Left.ParameterCount > 1 ? Style.PenaltyBreakBeforeFirstCallParameter
1886 : 19;
Daniel Jasper3aa9a6a2014-11-18 23:55:27 +00001887 }
Daniel Jasper190fbda2015-01-14 10:36:31 +00001888 if (Left.is(TT_JavaAnnotation))
1889 return 50;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001890
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001891 if (Right.is(tok::lessless)) {
Daniel Jasper2fd16632015-05-17 07:27:09 +00001892 if (Left.is(tok::string_literal) &&
Daniel Jasper00492f92016-01-05 13:03:50 +00001893 (Right.NextOperator || Right.OperatorIndex != 1)) {
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001894 StringRef Content = Left.TokenText;
Daniel Jasper0b1f76b2013-09-29 12:02:57 +00001895 if (Content.startswith("\""))
1896 Content = Content.drop_front(1);
1897 if (Content.endswith("\""))
1898 Content = Content.drop_back(1);
1899 Content = Content.trim();
Daniel Jasperf38a0ac2013-03-14 14:00:17 +00001900 if (Content.size() > 1 &&
1901 (Content.back() == ':' || Content.back() == '='))
Daniel Jasperfa21c072013-07-15 14:33:14 +00001902 return 25;
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001903 }
Daniel Jasper49a94482013-07-15 15:04:42 +00001904 return 1; // Breaking at a << is really cheap.
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001905 }
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001906 if (Left.is(TT_ConditionalExpr))
Daniel Jasper70bc8742013-02-26 13:59:14 +00001907 return prec::Conditional;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001908 prec::Level Level = Left.getPrecedence();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001909 if (Level != prec::Unknown)
1910 return Level;
Daniel Jaspere92bf6f2015-05-06 14:23:38 +00001911 Level = Right.getPrecedence();
1912 if (Level != prec::Unknown)
1913 return Level;
Daniel Jasperf9a84b52013-03-01 16:48:32 +00001914
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001915 return 3;
1916}
1917
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001918bool TokenAnnotator::spaceRequiredBetween(const AnnotatedLine &Line,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001919 const FormatToken &Left,
1920 const FormatToken &Right) {
Daniel Jasper166c19b2014-05-06 14:12:21 +00001921 if (Left.is(tok::kw_return) && Right.isNot(tok::semi))
1922 return true;
Daniel Jaspere9beea22014-01-28 15:20:33 +00001923 if (Style.ObjCSpaceAfterProperty && Line.Type == LT_ObjCProperty &&
1924 Left.Tok.getObjCKeywordID() == tok::objc_property)
1925 return true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001926 if (Right.is(tok::hashhash))
1927 return Left.is(tok::hash);
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001928 if (Left.isOneOf(tok::hashhash, tok::hash))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001929 return Right.is(tok::hash);
Daniel Jasperb55acad2013-08-20 12:36:34 +00001930 if (Left.is(tok::l_paren) && Right.is(tok::r_paren))
1931 return Style.SpaceInEmptyParentheses;
1932 if (Left.is(tok::l_paren) || Right.is(tok::r_paren))
Nico Weberbeb03932015-01-09 23:25:06 +00001933 return (Right.is(TT_CastRParen) ||
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001934 (Left.MatchingParen && Left.MatchingParen->is(TT_CastRParen)))
Daniel Jasperb55acad2013-08-20 12:36:34 +00001935 ? Style.SpacesInCStyleCastParentheses
1936 : Style.SpacesInParentheses;
1937 if (Right.isOneOf(tok::semi, tok::comma))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001938 return false;
1939 if (Right.is(tok::less) &&
Daniel Jasper20e15562015-04-16 07:02:19 +00001940 (Left.is(tok::kw_template) ||
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001941 (Line.Type == LT_ObjCDecl && Style.ObjCSpaceBeforeProtocolList)))
1942 return true;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001943 if (Left.isOneOf(tok::exclaim, tok::tilde))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001944 return false;
1945 if (Left.is(tok::at) &&
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001946 Right.isOneOf(tok::identifier, tok::string_literal, tok::char_constant,
1947 tok::numeric_constant, tok::l_paren, tok::l_brace,
1948 tok::kw_true, tok::kw_false))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001949 return false;
Daniel Jasperffbad0e2016-01-04 07:28:12 +00001950 if (Left.is(tok::colon))
1951 return !Left.is(TT_ObjCMethodExpr);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001952 if (Left.is(tok::coloncolon))
1953 return false;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001954 if (Left.is(tok::less) || Right.isOneOf(tok::greater, tok::less))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001955 return false;
Daniel Jasperbafa6b72013-07-01 09:47:25 +00001956 if (Right.is(tok::ellipsis))
Daniel Jasper2d0cd492013-10-20 16:56:16 +00001957 return Left.Tok.isLiteral();
Manuel Klimekbab25fd2013-09-04 08:20:47 +00001958 if (Left.is(tok::l_square) && Right.is(tok::amp))
1959 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001960 if (Right.is(TT_PointerOrReference))
Daniel Jasperaf642c62015-08-25 13:40:51 +00001961 return (Left.is(tok::r_paren) && Left.MatchingParen &&
1962 (Left.MatchingParen->is(TT_OverloadedOperatorLParen) ||
1963 (Left.MatchingParen->Previous &&
1964 Left.MatchingParen->Previous->is(TT_FunctionDeclarationName)))) ||
Daniel Jasper1c220482015-02-25 10:30:06 +00001965 (Left.Tok.isLiteral() ||
1966 (!Left.isOneOf(TT_PointerOrReference, tok::l_paren) &&
Daniel Jasperbea1ab42015-03-01 18:55:26 +00001967 (Style.PointerAlignment != FormatStyle::PAS_Left ||
1968 Line.IsMultiVariableDeclStmt)));
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001969 if (Right.is(TT_FunctionTypeLParen) && Left.isNot(tok::l_paren) &&
1970 (!Left.is(TT_PointerOrReference) ||
Daniel Jasperbea1ab42015-03-01 18:55:26 +00001971 (Style.PointerAlignment != FormatStyle::PAS_Right &&
1972 !Line.IsMultiVariableDeclStmt)))
Daniel Jaspercfda5172013-05-08 14:58:20 +00001973 return true;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001974 if (Left.is(TT_PointerOrReference))
Daniel Jasper5d7f06f2015-08-24 14:28:08 +00001975 return Right.Tok.isLiteral() ||
1976 Right.isOneOf(TT_BlockComment, Keywords.kw_final,
1977 Keywords.kw_override) ||
Daniel Jasper60ba32d2015-06-12 09:59:16 +00001978 (Right.is(tok::l_brace) && Right.BlockKind == BK_Block) ||
Daniel Jasper532a0312015-04-23 10:23:53 +00001979 (!Right.isOneOf(TT_PointerOrReference, TT_ArraySubscriptLSquare,
1980 tok::l_paren) &&
Daniel Jasperbea1ab42015-03-01 18:55:26 +00001981 (Style.PointerAlignment != FormatStyle::PAS_Right &&
1982 !Line.IsMultiVariableDeclStmt) &&
1983 Left.Previous &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001984 !Left.Previous->isOneOf(tok::l_paren, tok::coloncolon));
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001985 if (Right.is(tok::star) && Left.is(tok::l_paren))
1986 return false;
Nico Weber2a726b62013-02-10 02:08:05 +00001987 if (Left.is(tok::l_square))
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001988 return (Left.is(TT_ArrayInitializerLSquare) &&
Daniel Jasperad981f82014-08-26 11:41:14 +00001989 Style.SpacesInContainerLiterals && Right.isNot(tok::r_square)) ||
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001990 (Left.is(TT_ArraySubscriptLSquare) && Style.SpacesInSquareBrackets &&
1991 Right.isNot(tok::r_square));
Nico Weber2a726b62013-02-10 02:08:05 +00001992 if (Right.is(tok::r_square))
Daniel Jasperad981f82014-08-26 11:41:14 +00001993 return Right.MatchingParen &&
1994 ((Style.SpacesInContainerLiterals &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001995 Right.MatchingParen->is(TT_ArrayInitializerLSquare)) ||
Daniel Jasperad981f82014-08-26 11:41:14 +00001996 (Style.SpacesInSquareBrackets &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +00001997 Right.MatchingParen->is(TT_ArraySubscriptLSquare)));
1998 if (Right.is(tok::l_square) &&
1999 !Right.isOneOf(TT_ObjCMethodExpr, TT_LambdaLSquare) &&
2000 !Left.isOneOf(tok::numeric_constant, TT_DictLiteral))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002001 return false;
Daniel Jasper610381f2014-08-26 09:37:52 +00002002 if (Left.is(tok::l_brace) && Right.is(tok::r_brace))
2003 return !Left.Children.empty(); // No spaces in "{}".
2004 if ((Left.is(tok::l_brace) && Left.BlockKind != BK_Block) ||
2005 (Right.is(tok::r_brace) && Right.MatchingParen &&
2006 Right.MatchingParen->BlockKind != BK_Block))
2007 return !Style.Cpp11BracedListStyle;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002008 if (Left.is(TT_BlockComment))
Daniel Jasper484033b2014-05-06 14:41:29 +00002009 return !Left.TokenText.endswith("=*/");
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002010 if (Right.is(tok::l_paren)) {
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002011 if (Left.is(tok::r_paren) && Left.is(TT_AttributeParen))
Daniel Jasperee6d6502013-07-17 20:25:02 +00002012 return true;
Daniel Jasper79121232014-11-27 14:55:17 +00002013 return Line.Type == LT_ObjCDecl || Left.is(tok::semi) ||
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00002014 (Style.SpaceBeforeParens != FormatStyle::SBPO_Never &&
Daniel Jasperd7884572015-08-14 12:44:06 +00002015 (Left.isOneOf(tok::kw_if, tok::pp_elif, tok::kw_for, tok::kw_while,
Daniel Jasper9cb1ac282015-10-07 15:09:08 +00002016 tok::kw_switch, tok::kw_case, TT_ForEachMacro,
2017 TT_ObjCForIn) ||
Nico Weberfac23712015-02-04 15:26:27 +00002018 (Left.isOneOf(tok::kw_try, Keywords.kw___except, tok::kw_catch,
2019 tok::kw_new, tok::kw_delete) &&
Daniel Jasper66cb8c52015-05-04 09:22:29 +00002020 (!Left.Previous || Left.Previous->isNot(tok::period))))) ||
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00002021 (Style.SpaceBeforeParens == FormatStyle::SBPO_Always &&
Daniel Jaspere6fcf7d2015-06-17 13:08:06 +00002022 (Left.is(tok::identifier) || Left.isFunctionLikeKeyword() ||
2023 Left.is(tok::r_paren)) &&
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00002024 Line.Type != LT_PreprocessorDirective);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002025 }
Manuel Klimek6e6310e2013-05-29 14:47:47 +00002026 if (Left.is(tok::at) && Right.Tok.getObjCKeywordID() != tok::objc_not_keyword)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002027 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002028 if (Right.is(TT_UnaryOperator))
Daniel Jasper5bd0b9e2013-05-23 18:05:18 +00002029 return !Left.isOneOf(tok::l_paren, tok::l_square, tok::at) &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002030 (Left.isNot(tok::colon) || Left.isNot(TT_ObjCMethodExpr));
Daniel Jasper4afc6b32014-06-02 10:57:55 +00002031 if ((Left.isOneOf(tok::identifier, tok::greater, tok::r_square,
2032 tok::r_paren) ||
Daniel Jasper7a2d60e2014-05-07 07:59:03 +00002033 Left.isSimpleTypeSpecifier()) &&
Manuel Klimekbab25fd2013-09-04 08:20:47 +00002034 Right.is(tok::l_brace) && Right.getNextNonComment() &&
2035 Right.BlockKind != BK_Block)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002036 return false;
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00002037 if (Left.is(tok::period) || Right.is(tok::period))
2038 return false;
Alexander Kornienkod8d47fa2013-09-10 13:41:43 +00002039 if (Right.is(tok::hash) && Left.is(tok::identifier) && Left.TokenText == "L")
2040 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002041 if (Left.is(TT_TemplateCloser) && Left.MatchingParen &&
Daniel Jasper5ffcb7f2014-10-21 11:13:31 +00002042 Left.MatchingParen->Previous &&
2043 Left.MatchingParen->Previous->is(tok::period))
2044 // A.<B>DoSomething();
2045 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002046 if (Left.is(TT_TemplateCloser) && Right.is(tok::l_square))
Daniel Jasper6761b422014-11-18 23:48:01 +00002047 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002048 return true;
2049}
2050
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00002051bool TokenAnnotator::spaceRequiredBefore(const AnnotatedLine &Line,
Daniel Jasper38efc132014-10-21 07:51:54 +00002052 const FormatToken &Right) {
2053 const FormatToken &Left = *Right.Previous;
Daniel Jasper23d3bcf2015-06-25 08:38:46 +00002054 if (Right.Tok.getIdentifierInfo() && Left.Tok.getIdentifierInfo())
2055 return true; // Never ever merge two identifiers.
2056 if (Style.Language == FormatStyle::LK_Cpp) {
2057 if (Left.is(tok::kw_operator))
2058 return Right.is(tok::coloncolon);
2059 } else if (Style.Language == FormatStyle::LK_Proto) {
Daniel Jasper38efc132014-10-21 07:51:54 +00002060 if (Right.is(tok::period) &&
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00002061 Left.isOneOf(Keywords.kw_optional, Keywords.kw_required,
Daniel Jasperd8d98392015-11-20 14:32:54 +00002062 Keywords.kw_repeated, Keywords.kw_extend))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002063 return true;
Daniel Jasper38efc132014-10-21 07:51:54 +00002064 if (Right.is(tok::l_paren) &&
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00002065 Left.isOneOf(Keywords.kw_returns, Keywords.kw_option))
Daniel Jasper38efc132014-10-21 07:51:54 +00002066 return true;
2067 } else if (Style.Language == FormatStyle::LK_JavaScript) {
Daniel Jaspera4607e12016-03-17 12:17:59 +00002068 if (Left.is(TT_JsFatArrow))
2069 return true;
2070 if (Left.isOneOf(Keywords.kw_let, Keywords.kw_var, Keywords.kw_in,
2071 Keywords.kw_of) &&
2072 (!Left.Previous || !Left.Previous->is(tok::period)))
Daniel Jasper38efc132014-10-21 07:51:54 +00002073 return true;
Daniel Jasper5e271462016-01-04 16:10:36 +00002074 if (Left.is(tok::kw_default) && Left.Previous &&
2075 Left.Previous->is(tok::kw_export))
2076 return true;
Daniel Jasper779c66f2015-12-30 08:00:58 +00002077 if (Left.is(Keywords.kw_is) && Right.is(tok::l_brace))
2078 return true;
Daniel Jaspera74f5072015-04-13 15:01:40 +00002079 if (Right.isOneOf(TT_JsTypeColon, TT_JsTypeOptionalQuestion))
Daniel Jasperb10bdff2015-02-18 17:09:53 +00002080 return false;
Daniel Jasper91b1d1a2016-03-21 17:57:31 +00002081 if (Left.is(TT_JsTypeOperator) || Right.is(TT_JsTypeOperator))
2082 return false;
Daniel Jasper354aa512015-02-19 16:07:32 +00002083 if ((Left.is(tok::l_brace) || Right.is(tok::r_brace)) &&
Daniel Jasperfca735c2015-02-19 16:14:18 +00002084 Line.First->isOneOf(Keywords.kw_import, tok::kw_export))
Daniel Jasper354aa512015-02-19 16:07:32 +00002085 return false;
Daniel Jasper08051992015-05-26 07:18:56 +00002086 if (Left.is(tok::ellipsis))
2087 return false;
Daniel Jasperbc46b932015-03-15 13:59:51 +00002088 if (Left.is(TT_TemplateCloser) &&
Daniel Jasperd2219062015-05-02 07:54:58 +00002089 !Right.isOneOf(tok::equal, tok::l_brace, tok::comma, tok::l_square,
Daniel Jasperbc46b932015-03-15 13:59:51 +00002090 Keywords.kw_implements, Keywords.kw_extends))
2091 // Type assertions ('<type>expr') are not followed by whitespace. Other
2092 // locations that should have whitespace following are identified by the
2093 // above set of follower tokens.
2094 return false;
Daniel Jasperb9d3db62014-11-02 22:00:57 +00002095 } else if (Style.Language == FormatStyle::LK_Java) {
Daniel Jaspera0143fa2014-11-23 20:54:37 +00002096 if (Left.is(tok::r_square) && Right.is(tok::l_brace))
2097 return true;
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00002098 if (Left.is(Keywords.kw_synchronized) && Right.is(tok::l_paren))
Daniel Jasperb9d3db62014-11-02 22:00:57 +00002099 return Style.SpaceBeforeParens != FormatStyle::SBPO_Never;
Daniel Jasper82c92752014-11-21 12:19:07 +00002100 if ((Left.isOneOf(tok::kw_static, tok::kw_public, tok::kw_private,
2101 tok::kw_protected) ||
Nico Webered501662015-01-13 22:32:50 +00002102 Left.isOneOf(Keywords.kw_final, Keywords.kw_abstract,
2103 Keywords.kw_native)) &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002104 Right.is(TT_TemplateOpener))
Daniel Jasperdb9a7a22014-11-03 02:35:14 +00002105 return true;
Daniel Jasper38efc132014-10-21 07:51:54 +00002106 }
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002107 if (Left.is(TT_ImplicitStringLiteral))
Daniel Jasper38efc132014-10-21 07:51:54 +00002108 return Right.WhitespaceRange.getBegin() != Right.WhitespaceRange.getEnd();
2109 if (Line.Type == LT_ObjCMethodDecl) {
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002110 if (Left.is(TT_ObjCMethodSpecifier))
Daniel Jasper38efc132014-10-21 07:51:54 +00002111 return true;
2112 if (Left.is(tok::r_paren) && Right.is(tok::identifier))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002113 // Don't space between ')' and <id>
2114 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002115 }
2116 if (Line.Type == LT_ObjCProperty &&
Daniel Jasper38efc132014-10-21 07:51:54 +00002117 (Right.is(tok::equal) || Left.is(tok::equal)))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002118 return false;
2119
Daniel Jasper6f2b88a2015-06-05 13:18:09 +00002120 if (Right.isOneOf(TT_TrailingReturnArrow, TT_LambdaArrow) ||
2121 Left.isOneOf(TT_TrailingReturnArrow, TT_LambdaArrow))
Daniel Jasper6cdec7c2013-07-09 14:36:48 +00002122 return true;
Daniel Jasper804a2762016-01-09 15:56:40 +00002123 if (Right.is(TT_OverloadedOperatorLParen))
2124 return Style.SpaceBeforeParens == FormatStyle::SBPO_Always;
Daniel Jasper38efc132014-10-21 07:51:54 +00002125 if (Left.is(tok::comma))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002126 return true;
Daniel Jasper38efc132014-10-21 07:51:54 +00002127 if (Right.is(tok::comma))
Daniel Jasperff6c3a92013-02-28 13:40:17 +00002128 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002129 if (Right.isOneOf(TT_CtorInitializerColon, TT_ObjCBlockLParen))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002130 return true;
Daniel Jasper9326f912015-05-05 08:40:32 +00002131 if (Right.is(tok::colon)) {
2132 if (Line.First->isOneOf(tok::kw_case, tok::kw_default) ||
Daniel Jasper1fe0d5c2015-05-06 15:19:47 +00002133 !Right.getNextNonComment() || Right.getNextNonComment()->is(tok::semi))
Daniel Jasper9326f912015-05-05 08:40:32 +00002134 return false;
2135 if (Right.is(TT_ObjCMethodExpr))
2136 return false;
2137 if (Left.is(tok::question))
2138 return false;
2139 if (Right.is(TT_InlineASMColon) && Left.is(tok::coloncolon))
2140 return false;
2141 if (Right.is(TT_DictLiteral))
2142 return Style.SpacesInContainerLiterals;
2143 return true;
2144 }
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002145 if (Left.is(TT_UnaryOperator))
2146 return Right.is(TT_BinaryOperator);
Daniel Jaspercdb58b22015-05-15 09:05:31 +00002147
2148 // If the next token is a binary operator or a selector name, we have
2149 // incorrectly classified the parenthesis as a cast. FIXME: Detect correctly.
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002150 if (Left.is(TT_CastRParen))
Daniel Jaspercdb58b22015-05-15 09:05:31 +00002151 return Style.SpaceAfterCStyleCast ||
2152 Right.isOneOf(TT_BinaryOperator, TT_SelectorName);
2153
Daniel Jaspere497bed2015-06-02 22:06:07 +00002154 if (Left.is(tok::greater) && Right.is(tok::greater))
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002155 return Right.is(TT_TemplateCloser) && Left.is(TT_TemplateCloser) &&
Daniel Jasperdd978ae2013-10-29 14:52:02 +00002156 (Style.Standard != FormatStyle::LS_Cpp11 || Style.SpacesInAngles);
Daniel Jasper38efc132014-10-21 07:51:54 +00002157 if (Right.isOneOf(tok::arrow, tok::period, tok::arrowstar, tok::periodstar) ||
2158 Left.isOneOf(tok::arrow, tok::period, tok::arrowstar, tok::periodstar))
Daniel Jasperff6c3a92013-02-28 13:40:17 +00002159 return false;
Daniel Jasperd94bff32013-09-25 15:15:02 +00002160 if (!Style.SpaceBeforeAssignmentOperators &&
Daniel Jasper38efc132014-10-21 07:51:54 +00002161 Right.getPrecedence() == prec::Assignment)
Daniel Jasperd94bff32013-09-25 15:15:02 +00002162 return false;
Daniel Jasper16b107e2014-10-21 09:57:09 +00002163 if (Right.is(tok::coloncolon) && Left.isNot(tok::l_brace))
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002164 return (Left.is(TT_TemplateOpener) &&
Daniel Jasperf322eb52014-10-23 20:22:22 +00002165 Style.Standard == FormatStyle::LS_Cpp03) ||
Manuel Klimek27f278182016-01-19 14:05:32 +00002166 !(Left.isOneOf(tok::identifier, tok::l_paren, tok::r_paren,
2167 tok::l_square) ||
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002168 Left.isOneOf(TT_TemplateCloser, TT_TemplateOpener));
2169 if ((Left.is(TT_TemplateOpener)) != (Right.is(TT_TemplateCloser)))
Daniel Jasper16b107e2014-10-21 09:57:09 +00002170 return Style.SpacesInAngles;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002171 if ((Right.is(TT_BinaryOperator) && !Left.is(tok::l_paren)) ||
Daniel Jasper7fa524b2015-11-20 15:26:50 +00002172 (Left.isOneOf(TT_BinaryOperator, TT_ConditionalExpr) &&
2173 !Right.is(tok::r_paren)))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002174 return true;
Daniel Jasperbeaa3222015-02-26 11:30:50 +00002175 if (Left.is(TT_TemplateCloser) && Right.is(tok::l_paren) &&
2176 Right.isNot(TT_FunctionTypeLParen))
Chad Rosier0a84f172014-08-05 17:58:54 +00002177 return Style.SpaceBeforeParens == FormatStyle::SBPO_Always;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002178 if (Right.is(TT_TemplateOpener) && Left.is(tok::r_paren) &&
2179 Left.MatchingParen && Left.MatchingParen->is(TT_OverloadedOperatorLParen))
Daniel Jasper8835a322014-10-20 13:56:30 +00002180 return false;
Daniel Jasper38efc132014-10-21 07:51:54 +00002181 if (Right.is(tok::less) && Left.isNot(tok::l_paren) &&
Daniel Jaspere285b8d2015-06-17 09:43:56 +00002182 Line.startsWith(tok::hash))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002183 return true;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002184 if (Right.is(TT_TrailingUnaryOperator))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002185 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002186 if (Left.is(TT_RegexLiteral))
Daniel Jasperf9ae3122014-05-08 07:01:45 +00002187 return false;
Daniel Jasper38efc132014-10-21 07:51:54 +00002188 return spaceRequiredBetween(Line, Left, Right);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002189}
2190
Daniel Jaspere18ff372014-06-02 10:17:32 +00002191// Returns 'true' if 'Tok' is a brace we'd want to break before in Allman style.
2192static bool isAllmanBrace(const FormatToken &Tok) {
2193 return Tok.is(tok::l_brace) && Tok.BlockKind == BK_Block &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002194 !Tok.isOneOf(TT_ObjCBlockLBrace, TT_DictLiteral);
Daniel Jaspere18ff372014-06-02 10:17:32 +00002195}
2196
Daniel Jasperfb81b092013-09-17 09:52:48 +00002197bool TokenAnnotator::mustBreakBefore(const AnnotatedLine &Line,
2198 const FormatToken &Right) {
Daniel Jaspera125d532014-03-21 12:38:57 +00002199 const FormatToken &Left = *Right.Previous;
Manuel Klimek9e321992015-07-28 15:50:24 +00002200 if (Right.NewlinesBefore > 1 && Style.MaxEmptyLinesToKeep > 0)
Daniel Jaspera69ca9b2014-06-04 12:40:57 +00002201 return true;
Daniel Jasper64a328e2014-11-11 19:34:57 +00002202
Daniel Jasper9f4ec152015-06-17 09:44:07 +00002203 if (Style.Language == FormatStyle::LK_JavaScript) {
2204 // FIXME: This might apply to other languages and token kinds.
Daniel Jasperabd1f572016-03-02 22:44:03 +00002205 if (Right.is(tok::string_literal) && Left.is(tok::plus) && Left.Previous &&
2206 Left.Previous->is(tok::string_literal))
Daniel Jasper9f4ec152015-06-17 09:44:07 +00002207 return true;
Daniel Jaspere6fcf7d2015-06-17 13:08:06 +00002208 if (Left.is(TT_DictLiteral) && Left.is(tok::l_brace) && Line.Level == 0 &&
2209 Left.Previous && Left.Previous->is(tok::equal) &&
2210 Line.First->isOneOf(tok::identifier, Keywords.kw_import, tok::kw_export,
2211 tok::kw_const) &&
Daniel Jasper9f642f72015-09-28 14:28:08 +00002212 // kw_var/kw_let are pseudo-tokens that are tok::identifier, so match
2213 // above.
2214 !Line.First->isOneOf(Keywords.kw_var, Keywords.kw_let))
Daniel Jasper9f4ec152015-06-17 09:44:07 +00002215 // Object literals on the top level of a file are treated as "enum-style".
2216 // Each key/value pair is put on a separate line, instead of bin-packing.
2217 return true;
2218 if (Left.is(tok::l_brace) && Line.Level == 0 &&
2219 (Line.startsWith(tok::kw_enum) ||
2220 Line.startsWith(tok::kw_export, tok::kw_enum)))
2221 // JavaScript top-level enum key/value pairs are put on separate lines
2222 // instead of bin-packing.
2223 return true;
2224 if (Right.is(tok::r_brace) && Left.is(tok::l_brace) &&
2225 !Left.Children.empty())
2226 // Support AllowShortFunctionsOnASingleLine for JavaScript.
2227 return Style.AllowShortFunctionsOnASingleLine == FormatStyle::SFS_None ||
Daniel Jasper71e57452015-11-20 16:44:28 +00002228 Style.AllowShortFunctionsOnASingleLine == FormatStyle::SFS_Empty ||
Daniel Jasper9f4ec152015-06-17 09:44:07 +00002229 (Left.NestingLevel == 0 && Line.Level == 0 &&
2230 Style.AllowShortFunctionsOnASingleLine ==
2231 FormatStyle::SFS_Inline);
2232 } else if (Style.Language == FormatStyle::LK_Java) {
2233 if (Right.is(tok::plus) && Left.is(tok::string_literal) && Right.Next &&
2234 Right.Next->is(tok::string_literal))
2235 return true;
2236 }
2237
Daniel Jasper64a328e2014-11-11 19:34:57 +00002238 // If the last token before a '}' is a comma or a trailing comment, the
2239 // intention is to insert a line break after it in order to make shuffling
2240 // around entries easier.
2241 const FormatToken *BeforeClosingBrace = nullptr;
Daniel Jasper308062b2015-02-27 08:41:05 +00002242 if (Left.isOneOf(tok::l_brace, TT_ArrayInitializerLSquare) &&
2243 Left.BlockKind != BK_Block && Left.MatchingParen)
Daniel Jasper64a328e2014-11-11 19:34:57 +00002244 BeforeClosingBrace = Left.MatchingParen->Previous;
Daniel Jasper308062b2015-02-27 08:41:05 +00002245 else if (Right.MatchingParen &&
2246 Right.MatchingParen->isOneOf(tok::l_brace,
2247 TT_ArrayInitializerLSquare))
Daniel Jasper64a328e2014-11-11 19:34:57 +00002248 BeforeClosingBrace = &Left;
2249 if (BeforeClosingBrace && (BeforeClosingBrace->is(tok::comma) ||
2250 BeforeClosingBrace->isTrailingComment()))
2251 return true;
2252
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002253 if (Right.is(tok::comment))
Daniel Jasper64a328e2014-11-11 19:34:57 +00002254 return Left.BlockKind != BK_BracedInit &&
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002255 Left.isNot(TT_CtorInitializerColon) &&
Manuel Klimek1fcbe672014-04-11 12:27:47 +00002256 (Right.NewlinesBefore > 0 && Right.HasUnescapedNewline);
Daniel Jasper015c7a92015-05-11 15:15:48 +00002257 if (Left.isTrailingComment())
Daniel Jaspere6fcf7d2015-06-17 13:08:06 +00002258 return true;
Daniel Jasper015c7a92015-05-11 15:15:48 +00002259 if (Left.isStringLiteral() &&
2260 (Right.isStringLiteral() || Right.is(TT_ObjCStringLiteral)))
Daniel Jasperfb81b092013-09-17 09:52:48 +00002261 return true;
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002262 if (Right.Previous->IsUnterminatedLiteral)
Daniel Jasperfb81b092013-09-17 09:52:48 +00002263 return true;
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002264 if (Right.is(tok::lessless) && Right.Next &&
2265 Right.Previous->is(tok::string_literal) &&
2266 Right.Next->is(tok::string_literal))
Daniel Jasperfb81b092013-09-17 09:52:48 +00002267 return true;
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002268 if (Right.Previous->ClosesTemplateDeclaration &&
2269 Right.Previous->MatchingParen &&
2270 Right.Previous->MatchingParen->NestingLevel == 0 &&
2271 Style.AlwaysBreakTemplateDeclarations)
Daniel Jasperfb81b092013-09-17 09:52:48 +00002272 return true;
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002273 if ((Right.isOneOf(TT_CtorInitializerComma, TT_CtorInitializerColon)) &&
2274 Style.BreakConstructorInitializersBeforeComma &&
2275 !Style.ConstructorInitializerAllOnOneLineOrOnePerLine)
Daniel Jasperfb81b092013-09-17 09:52:48 +00002276 return true;
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002277 if (Right.is(tok::string_literal) && Right.TokenText.startswith("R\""))
Daniel Jasperc39b56f2013-12-16 07:23:08 +00002278 // Raw string literals are special wrt. line breaks. The author has made a
2279 // deliberate choice and might have aligned the contents of the string
2280 // literal accordingly. Thus, we try keep existing line breaks.
2281 return Right.NewlinesBefore > 0;
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002282 if (Right.Previous->is(tok::l_brace) && Right.NestingLevel == 1 &&
2283 Style.Language == FormatStyle::LK_Proto)
Daniel Jasperce2fdb02014-10-27 13:25:59 +00002284 // Don't put enums onto single lines in protocol buffers.
Daniel Jasper7052ce62014-01-19 09:04:08 +00002285 return true;
Daniel Jasperc6366072015-05-10 08:42:04 +00002286 if (Right.is(TT_InlineASMBrace))
2287 return Right.HasUnescapedNewline;
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002288 if (isAllmanBrace(Left) || isAllmanBrace(Right))
Daniel Jasperc1bc38e2015-09-29 14:57:55 +00002289 return (Line.startsWith(tok::kw_enum) && Style.BraceWrapping.AfterEnum) ||
2290 (Line.startsWith(tok::kw_class) && Style.BraceWrapping.AfterClass) ||
2291 (Line.startsWith(tok::kw_struct) && Style.BraceWrapping.AfterStruct);
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002292 if (Style.Language == FormatStyle::LK_Proto && Left.isNot(tok::l_brace) &&
2293 Right.is(TT_SelectorName))
Daniel Jaspera382cbe2014-07-28 14:08:09 +00002294 return true;
Daniel Jasperd05d3a82015-01-08 13:56:57 +00002295 if (Left.is(TT_ObjCBlockLBrace) && !Style.AllowShortBlocksOnASingleLine)
Daniel Jasper76284682014-10-22 09:12:44 +00002296 return true;
Daniel Jasperb175d572014-04-09 09:53:23 +00002297
Daniel Jasper354aa512015-02-19 16:07:32 +00002298 if ((Style.Language == FormatStyle::LK_Java ||
2299 Style.Language == FormatStyle::LK_JavaScript) &&
2300 Left.is(TT_LeadingJavaAnnotation) &&
2301 Right.isNot(TT_LeadingJavaAnnotation) && Right.isNot(tok::l_paren) &&
Nico Weber2cd92f12015-10-15 16:03:01 +00002302 (Line.Last->is(tok::l_brace) || Style.BreakAfterJavaFieldAnnotations))
Daniel Jasper354aa512015-02-19 16:07:32 +00002303 return true;
2304
Daniel Jasperfb81b092013-09-17 09:52:48 +00002305 return false;
2306}
2307
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00002308bool TokenAnnotator::canBreakBefore(const AnnotatedLine &Line,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00002309 const FormatToken &Right) {
2310 const FormatToken &Left = *Right.Previous;
Daniel Jasperf26c7552014-10-17 13:36:14 +00002311
Daniel Jasperc83d7692015-06-09 11:39:22 +00002312 // Language-specific stuff.
Daniel Jasperf26c7552014-10-17 13:36:14 +00002313 if (Style.Language == FormatStyle::LK_Java) {
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00002314 if (Left.isOneOf(Keywords.kw_throws, Keywords.kw_extends,
2315 Keywords.kw_implements))
Daniel Jasperf26c7552014-10-17 13:36:14 +00002316 return false;
Daniel Jasperd0ec0d62014-11-04 12:41:02 +00002317 if (Right.isOneOf(Keywords.kw_throws, Keywords.kw_extends,
2318 Keywords.kw_implements))
Daniel Jasper58fcf6d2014-11-04 10:53:14 +00002319 return true;
Daniel Jasperc83d7692015-06-09 11:39:22 +00002320 } else if (Style.Language == FormatStyle::LK_JavaScript) {
Daniel Jasper11a87652016-01-14 05:37:52 +00002321 if (Left.is(tok::kw_return))
2322 return false; // Otherwise a semicolon is inserted.
Daniel Jasperc83d7692015-06-09 11:39:22 +00002323 if (Left.is(TT_JsFatArrow) && Right.is(tok::l_brace))
2324 return false;
Daniel Jasper5a3de1d2015-07-03 10:37:23 +00002325 if (Left.is(TT_JsTypeColon))
2326 return true;
Daniel Jasper779c66f2015-12-30 08:00:58 +00002327 if (Right.NestingLevel == 0 && Right.is(Keywords.kw_is))
2328 return false;
Daniel Jasper1ce41112016-02-01 11:20:47 +00002329 if (Left.is(Keywords.kw_in))
2330 return Style.BreakBeforeBinaryOperators == FormatStyle::BOS_None;
2331 if (Right.is(Keywords.kw_in))
2332 return Style.BreakBeforeBinaryOperators != FormatStyle::BOS_None;
Daniel Jasperf26c7552014-10-17 13:36:14 +00002333 }
2334
Daniel Jasper4bf0d802013-11-23 14:27:27 +00002335 if (Left.is(tok::at))
2336 return false;
Daniel Jasper437c3f52014-04-28 07:34:48 +00002337 if (Left.Tok.getObjCKeywordID() == tok::objc_interface)
2338 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002339 if (Left.isOneOf(TT_JavaAnnotation, TT_LeadingJavaAnnotation))
Daniel Jasper3e1bd142015-01-14 09:51:32 +00002340 return !Right.is(tok::l_paren);
Daniel Jasperb754a742015-03-12 15:04:53 +00002341 if (Right.is(TT_PointerOrReference))
2342 return Line.IsMultiVariableDeclStmt ||
2343 (Style.PointerAlignment == FormatStyle::PAS_Right &&
2344 (!Right.Next || Right.Next->isNot(TT_FunctionDeclarationName)));
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002345 if (Right.isOneOf(TT_StartOfName, TT_FunctionDeclarationName) ||
2346 Right.is(tok::kw_operator))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002347 return true;
Daniel Jasper414c9c62015-03-19 09:40:16 +00002348 if (Left.is(TT_PointerOrReference))
2349 return false;
Daniel Jasper165b29e2013-11-08 00:57:11 +00002350 if (Right.isTrailingComment())
2351 // We rely on MustBreakBefore being set correctly here as we should not
2352 // change the "binding" behavior of a comment.
Daniel Jasper5a611392013-12-19 21:41:37 +00002353 // The first comment in a braced lists is always interpreted as belonging to
2354 // the first list element. Otherwise, it should be placed outside of the
2355 // list.
2356 return Left.BlockKind == BK_BracedInit;
Daniel Jasper165b29e2013-11-08 00:57:11 +00002357 if (Left.is(tok::question) && Right.is(tok::colon))
2358 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002359 if (Right.is(TT_ConditionalExpr) || Right.is(tok::question))
Daniel Jasper165b29e2013-11-08 00:57:11 +00002360 return Style.BreakBeforeTernaryOperators;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002361 if (Left.is(TT_ConditionalExpr) || Left.is(tok::question))
Daniel Jasper165b29e2013-11-08 00:57:11 +00002362 return !Style.BreakBeforeTernaryOperators;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002363 if (Right.is(TT_InheritanceColon))
Daniel Jasper3a122c02014-02-14 18:22:40 +00002364 return true;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002365 if (Right.is(tok::colon) &&
2366 !Right.isOneOf(TT_CtorInitializerColon, TT_InlineASMColon))
Daniel Jasperd39312ec2014-05-28 10:09:11 +00002367 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002368 if (Left.is(tok::colon) && (Left.isOneOf(TT_DictLiteral, TT_ObjCMethodExpr)))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002369 return true;
Daniel Jaspera7b14262015-05-13 10:23:03 +00002370 if (Right.is(TT_SelectorName) || (Right.is(tok::identifier) && Right.Next &&
2371 Right.Next->is(TT_ObjCMethodExpr)))
Daniel Jaspered41f772015-05-19 11:06:33 +00002372 return Left.isNot(tok::period); // FIXME: Properly parse ObjC calls.
Daniel Jasper9688ff12013-08-01 13:46:58 +00002373 if (Left.is(tok::r_paren) && Line.Type == LT_ObjCProperty)
2374 return true;
Daniel Jasper788ffd72015-08-24 15:10:01 +00002375 if (Left.ClosesTemplateDeclaration || Left.is(TT_FunctionAnnotationRParen))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002376 return true;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002377 if (Right.isOneOf(TT_RangeBasedForLoopColon, TT_OverloadedOperatorLParen,
2378 TT_OverloadedOperator))
Daniel Jaspereead02b2013-02-14 08:42:54 +00002379 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002380 if (Left.is(TT_RangeBasedForLoopColon))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002381 return true;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002382 if (Right.is(TT_RangeBasedForLoopColon))
Daniel Jasper37905f72013-02-21 15:00:29 +00002383 return false;
Daniel Jasperb754a742015-03-12 15:04:53 +00002384 if (Left.isOneOf(TT_TemplateCloser, TT_UnaryOperator) ||
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002385 Left.is(tok::kw_operator))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002386 return false;
Daniel Jaspercaf84fe2015-04-23 12:59:09 +00002387 if (Left.is(tok::equal) && !Right.isOneOf(tok::kw_default, tok::kw_delete) &&
Daniel Jasper100ffc62015-08-21 11:44:57 +00002388 Line.Type == LT_VirtualFunctionDecl && Left.NestingLevel == 0)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002389 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002390 if (Left.is(tok::l_paren) && Left.is(TT_AttributeParen))
Daniel Jasper559b63c2014-01-28 20:13:43 +00002391 return false;
2392 if (Left.is(tok::l_paren) && Left.Previous &&
Daniel Jaspera42de762015-02-26 09:49:08 +00002393 (Left.Previous->isOneOf(TT_BinaryOperator, TT_CastRParen)))
Daniel Jasper559b63c2014-01-28 20:13:43 +00002394 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002395 if (Right.is(TT_ImplicitStringLiteral))
Daniel Jasper98857842013-10-30 13:54:53 +00002396 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002397
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002398 if (Right.is(tok::r_paren) || Right.is(TT_TemplateCloser))
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00002399 return false;
Daniel Jasperb9edcfb2015-07-07 13:50:50 +00002400 if (Right.is(tok::r_square) && Right.MatchingParen &&
2401 Right.MatchingParen->is(TT_LambdaLSquare))
2402 return false;
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00002403
Daniel Jasper13c37b32013-05-22 08:28:26 +00002404 // We only break before r_brace if there was a corresponding break before
2405 // the l_brace, which is tracked by BreakBeforeClosingBrace.
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00002406 if (Right.is(tok::r_brace))
2407 return Right.MatchingParen && Right.MatchingParen->BlockKind == BK_Block;
Daniel Jasper13c37b32013-05-22 08:28:26 +00002408
Daniel Jasperf9a09062014-04-09 10:29:11 +00002409 // Allow breaking after a trailing annotation, e.g. after a method
2410 // declaration.
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002411 if (Left.is(TT_TrailingAnnotation))
Daniel Jasperf9a09062014-04-09 10:29:11 +00002412 return !Right.isOneOf(tok::l_brace, tok::semi, tok::equal, tok::l_paren,
2413 tok::less, tok::coloncolon);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002414
Daniel Jasperbf4755b2013-03-14 09:50:46 +00002415 if (Right.is(tok::kw___attribute))
2416 return true;
2417
Daniel Jasperaf5ba0e2013-02-23 07:46:38 +00002418 if (Left.is(tok::identifier) && Right.is(tok::string_literal))
2419 return true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +00002420
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002421 if (Right.is(tok::identifier) && Right.Next && Right.Next->is(TT_DictLiteral))
Daniel Jasper783bac62014-04-15 09:54:30 +00002422 return true;
2423
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002424 if (Left.is(TT_CtorInitializerComma) &&
Daniel Jaspere33d4af2013-07-26 16:56:36 +00002425 Style.BreakConstructorInitializersBeforeComma)
2426 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002427 if (Right.is(TT_CtorInitializerComma) &&
Daniel Jasperec01cd62013-10-08 05:11:18 +00002428 Style.BreakConstructorInitializersBeforeComma)
2429 return true;
Jacques Pienaarfc275112015-02-18 23:48:37 +00002430 if ((Left.is(tok::greater) && Right.is(tok::greater)) ||
2431 (Left.is(tok::less) && Right.is(tok::less)))
Daniel Jasper0de8efa2013-09-17 08:15:46 +00002432 return false;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002433 if (Right.is(TT_BinaryOperator) &&
Daniel Jasperac043c92014-09-15 11:11:00 +00002434 Style.BreakBeforeBinaryOperators != FormatStyle::BOS_None &&
2435 (Style.BreakBeforeBinaryOperators == FormatStyle::BOS_All ||
2436 Right.getPrecedence() != prec::Assignment))
Daniel Jasper0a1e5ac2014-05-13 08:01:47 +00002437 return true;
Daniel Jaspera98b7b02014-11-25 10:05:17 +00002438 if (Left.is(TT_ArrayInitializerLSquare))
Daniel Jasper1db6c382013-10-22 15:30:28 +00002439 return true;
Daniel Jasper598dd332014-08-12 13:22:26 +00002440 if (Right.is(tok::kw_typename) && Left.isNot(tok::kw_const))
2441 return true;
Daniel Jasper043ac052015-07-03 10:12:53 +00002442 if ((Left.isBinaryOperator() || Left.is(TT_BinaryOperator)) &&
2443 !Left.isOneOf(tok::arrowstar, tok::lessless) &&
Daniel Jasperac043c92014-09-15 11:11:00 +00002444 Style.BreakBeforeBinaryOperators != FormatStyle::BOS_All &&
2445 (Style.BreakBeforeBinaryOperators == FormatStyle::BOS_None ||
2446 Left.getPrecedence() == prec::Assignment))
2447 return true;
2448 return Left.isOneOf(tok::comma, tok::coloncolon, tok::semi, tok::l_brace,
Daniel Jasper83193602013-04-05 17:22:09 +00002449 tok::kw_class, tok::kw_struct) ||
Daniel Jasper05cd9292015-03-26 18:46:28 +00002450 Right.isMemberAccess() ||
2451 Right.isOneOf(TT_TrailingReturnArrow, TT_LambdaArrow, tok::lessless,
2452 tok::colon, tok::l_square, tok::at) ||
Daniel Jasper1bc1b502013-07-05 07:58:34 +00002453 (Left.is(tok::r_paren) &&
Daniel Jasper559b63c2014-01-28 20:13:43 +00002454 Right.isOneOf(tok::identifier, tok::kw_const)) ||
Daniel Jasper1db6c382013-10-22 15:30:28 +00002455 (Left.is(tok::l_paren) && !Right.is(tok::r_paren));
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002456}
2457
Daniel Jasper6bee6822013-04-08 20:33:42 +00002458void TokenAnnotator::printDebugInfo(const AnnotatedLine &Line) {
2459 llvm::errs() << "AnnotatedTokens:\n";
Manuel Klimek6e6310e2013-05-29 14:47:47 +00002460 const FormatToken *Tok = Line.First;
Daniel Jasper6bee6822013-04-08 20:33:42 +00002461 while (Tok) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00002462 llvm::errs() << " M=" << Tok->MustBreakBefore
Birunthan Mohanathas67d81c82015-07-13 16:19:34 +00002463 << " C=" << Tok->CanBreakBefore
2464 << " T=" << getTokenTypeName(Tok->Type)
Daniel Jasperb10cbc42013-07-10 14:02:49 +00002465 << " S=" << Tok->SpacesRequiredBefore
Daniel Jasper17062ff2014-06-10 14:44:02 +00002466 << " B=" << Tok->BlockParameterCount
Daniel Jasperb10cbc42013-07-10 14:02:49 +00002467 << " P=" << Tok->SplitPenalty << " Name=" << Tok->Tok.getName()
Manuel Klimek71814b42013-10-11 21:25:45 +00002468 << " L=" << Tok->TotalLength << " PPK=" << Tok->PackingKind
2469 << " FakeLParens=";
Daniel Jasper6bee6822013-04-08 20:33:42 +00002470 for (unsigned i = 0, e = Tok->FakeLParens.size(); i != e; ++i)
2471 llvm::errs() << Tok->FakeLParens[i] << "/";
2472 llvm::errs() << " FakeRParens=" << Tok->FakeRParens << "\n";
Daniel Jasperb05a81d2014-05-09 13:11:16 +00002473 if (!Tok->Next)
Manuel Klimek71814b42013-10-11 21:25:45 +00002474 assert(Tok == Line.Last);
Manuel Klimek6e6310e2013-05-29 14:47:47 +00002475 Tok = Tok->Next;
Daniel Jasper6bee6822013-04-08 20:33:42 +00002476 }
2477 llvm::errs() << "----\n";
2478}
2479
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00002480} // namespace format
2481} // namespace clang