blob: 4c6be9f98c1dd2340d8c5815774252ef9c341dc4 [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 Jasper6bee6822013-04-08 20:33:42 +000018#include "llvm/Support/Debug.h"
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000019
Chandler Carruth57f5fbe2014-04-21 22:55:36 +000020#define DEBUG_TYPE "format-token-annotator"
21
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000022namespace clang {
23namespace format {
24
Craig Topper318ed7c2013-07-01 04:03:19 +000025namespace {
26
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000027/// \brief A parser that gathers additional information about tokens.
28///
Alexander Kornienkoa5151272013-03-12 16:28:18 +000029/// The \c TokenAnnotator tries to match parenthesis and square brakets and
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000030/// store a parenthesis levels. It also tries to resolve matching "<" and ">"
31/// into template parameter lists.
32class AnnotatingParser {
33public:
Daniel Jasper8de9ed02013-08-22 15:00:41 +000034 AnnotatingParser(const FormatStyle &Style, AnnotatedLine &Line,
35 IdentifierInfo &Ident_in)
36 : Style(Style), Line(Line), CurrentToken(Line.First),
Daniel Jasperbc5cb4e2013-11-07 17:43:07 +000037 KeywordVirtualFound(false), AutoFound(false), Ident_in(Ident_in) {
Nico Weber9096fc02013-06-26 00:30:14 +000038 Contexts.push_back(Context(tok::unknown, 1, /*IsExpression=*/false));
Manuel Klimek819788d2014-03-18 11:22:45 +000039 resetTokenMetadata(CurrentToken);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000040 }
41
Nico Weber44449172013-02-12 16:17:07 +000042private:
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000043 bool parseAngle() {
Craig Topper2145bc02014-05-09 08:15:10 +000044 if (!CurrentToken)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000045 return false;
Daniel Jasper40aacf42013-03-14 13:45:21 +000046 ScopedContextCreator ContextCreator(*this, tok::less, 10);
Manuel Klimek6e6310e2013-05-29 14:47:47 +000047 FormatToken *Left = CurrentToken->Previous;
Daniel Jasperc697ad22013-02-06 10:05:46 +000048 Contexts.back().IsExpression = false;
Manuel Klimekf81e5c02014-03-27 11:17:36 +000049 // If there's a template keyword before the opening angle bracket, this is a
50 // template parameter, not an argument.
51 Contexts.back().InTemplateArgument =
Craig Topper2145bc02014-05-09 08:15:10 +000052 Left->Previous && Left->Previous->Tok.isNot(tok::kw_template);
Manuel Klimekf81e5c02014-03-27 11:17:36 +000053
Craig Topper2145bc02014-05-09 08:15:10 +000054 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000055 if (CurrentToken->is(tok::greater)) {
56 Left->MatchingParen = CurrentToken;
57 CurrentToken->MatchingParen = Left;
58 CurrentToken->Type = TT_TemplateCloser;
59 next();
60 return true;
61 }
Alexander Kornienko62b85b92013-03-13 14:41:29 +000062 if (CurrentToken->isOneOf(tok::r_paren, tok::r_square, tok::r_brace,
Daniel Jasper6f05e592013-05-15 13:46:48 +000063 tok::question, tok::colon))
64 return false;
Daniel Jasperd5893912013-06-01 18:56:00 +000065 // If a && or || is found and interpreted as a binary operator, this set
Daniel Jasper1027c6e2013-06-03 16:16:41 +000066 // of angles is likely part of something like "a < b && c > d". If the
Daniel Jasperd5893912013-06-01 18:56:00 +000067 // angles are inside an expression, the ||/&& might also be a binary
68 // operator that was misinterpreted because we are parsing template
69 // parameters.
70 // FIXME: This is getting out of hand, write a decent parser.
Manuel Klimek6e6310e2013-05-29 14:47:47 +000071 if (CurrentToken->Previous->isOneOf(tok::pipepipe, tok::ampamp) &&
Daniel Jasper6ba16382014-07-28 13:19:58 +000072 CurrentToken->Previous->Type == TT_BinaryOperator &&
73 Contexts[Contexts.size() - 2].IsExpression &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +000074 Line.First->isNot(tok::kw_template))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000075 return false;
Daniel Jaspere11095a2013-02-14 15:01:34 +000076 updateParameterCount(Left, CurrentToken);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000077 if (!consumeToken())
78 return false;
79 }
80 return false;
81 }
82
83 bool parseParens(bool LookForDecls = false) {
Craig Topper2145bc02014-05-09 08:15:10 +000084 if (!CurrentToken)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000085 return false;
Daniel Jasper40aacf42013-03-14 13:45:21 +000086 ScopedContextCreator ContextCreator(*this, tok::l_paren, 1);
Daniel Jasperc697ad22013-02-06 10:05:46 +000087
88 // FIXME: This is a bit of a hack. Do better.
89 Contexts.back().ColonIsForRangeExpr =
90 Contexts.size() == 2 && Contexts[0].ColonIsForRangeExpr;
91
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000092 bool StartsObjCMethodExpr = false;
Manuel Klimek6e6310e2013-05-29 14:47:47 +000093 FormatToken *Left = CurrentToken->Previous;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000094 if (CurrentToken->is(tok::caret)) {
Daniel Jasperb88b25f2013-12-23 07:29:06 +000095 // (^ can start a block type.
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000096 Left->Type = TT_ObjCBlockLParen;
Manuel Klimek6e6310e2013-05-29 14:47:47 +000097 } else if (FormatToken *MaybeSel = Left->Previous) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000098 // @selector( starts a selector.
Manuel Klimek6e6310e2013-05-29 14:47:47 +000099 if (MaybeSel->isObjCAtKeyword(tok::objc_selector) && MaybeSel->Previous &&
100 MaybeSel->Previous->is(tok::at)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000101 StartsObjCMethodExpr = true;
102 }
103 }
104
Daniel Jaspera65e8872014-03-25 10:52:45 +0000105 if (Left->Previous &&
106 (Left->Previous->isOneOf(tok::kw_static_assert, tok::kw_if,
107 tok::kw_while, tok::l_paren, tok::comma) ||
108 Left->Previous->Type == TT_BinaryOperator)) {
Daniel Jasperd46e07e2013-10-20 18:15:30 +0000109 // static_assert, if and while usually contain expressions.
Daniel Jasper8b1c6352013-08-01 17:58:23 +0000110 Contexts.back().IsExpression = true;
Daniel Jasper72ab43b2014-04-14 12:50:02 +0000111 } else if (Line.InPPDirective &&
Daniel Jasper866468a2014-04-14 13:15:29 +0000112 (!Left->Previous ||
113 (Left->Previous->isNot(tok::identifier) &&
114 Left->Previous->Type != TT_OverloadedOperator))) {
Daniel Jasper72ab43b2014-04-14 12:50:02 +0000115 Contexts.back().IsExpression = true;
Daniel Jasperd46e07e2013-10-20 18:15:30 +0000116 } else if (Left->Previous && Left->Previous->is(tok::r_square) &&
117 Left->Previous->MatchingParen &&
118 Left->Previous->MatchingParen->Type == TT_LambdaLSquare) {
119 // This is a parameter list of a lambda expression.
120 Contexts.back().IsExpression = false;
Daniel Jasperc13ee342014-03-27 09:43:54 +0000121 } else if (Contexts[Contexts.size() - 2].CaretFound) {
Daniel Jasperb88b25f2013-12-23 07:29:06 +0000122 // This is the parameter list of an ObjC block.
123 Contexts.back().IsExpression = false;
Daniel Jasper559b63c2014-01-28 20:13:43 +0000124 } else if (Left->Previous && Left->Previous->is(tok::kw___attribute)) {
125 Left->Type = TT_AttributeParen;
Daniel Jaspere1e43192014-04-01 12:55:11 +0000126 } else if (Left->Previous && Left->Previous->IsForEachMacro) {
127 // The first argument to a foreach macro is a declaration.
128 Contexts.back().IsForEachMacro = true;
129 Contexts.back().IsExpression = false;
Daniel Jasperd46e07e2013-10-20 18:15:30 +0000130 }
Daniel Jasper8b1c6352013-08-01 17:58:23 +0000131
Daniel Jasperc697ad22013-02-06 10:05:46 +0000132 if (StartsObjCMethodExpr) {
133 Contexts.back().ColonIsObjCMethodExpr = true;
134 Left->Type = TT_ObjCMethodExpr;
135 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000136
Daniel Jasper37194282013-05-28 08:33:00 +0000137 bool MightBeFunctionType = CurrentToken->is(tok::star);
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000138 bool HasMultipleLines = false;
139 bool HasMultipleParametersOnALine = false;
Craig Topper2145bc02014-05-09 08:15:10 +0000140 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000141 // LookForDecls is set when "if (" has been seen. Check for
142 // 'identifier' '*' 'identifier' followed by not '=' -- this
143 // '*' has to be a binary operator but determineStarAmpUsage() will
144 // categorize it as an unary operator, so set the right type here.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000145 if (LookForDecls && CurrentToken->Next) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000146 FormatToken *Prev = CurrentToken->getPreviousNonComment();
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000147 if (Prev) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000148 FormatToken *PrevPrev = Prev->getPreviousNonComment();
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000149 FormatToken *Next = CurrentToken->Next;
150 if (PrevPrev && PrevPrev->is(tok::identifier) &&
151 Prev->isOneOf(tok::star, tok::amp, tok::ampamp) &&
152 CurrentToken->is(tok::identifier) && Next->isNot(tok::equal)) {
153 Prev->Type = TT_BinaryOperator;
154 LookForDecls = false;
155 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000156 }
157 }
158
Daniel Jasper59036852013-08-12 12:16:34 +0000159 if (CurrentToken->Previous->Type == TT_PointerOrReference &&
160 CurrentToken->Previous->Previous->isOneOf(tok::l_paren,
161 tok::coloncolon))
162 MightBeFunctionType = true;
Daniel Jasper91beebd2014-06-30 13:44:47 +0000163 if (CurrentToken->Previous->Type == TT_BinaryOperator)
164 Contexts.back().IsExpression = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000165 if (CurrentToken->is(tok::r_paren)) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000166 if (MightBeFunctionType && CurrentToken->Next &&
Daniel Jasper655d96a2013-07-16 11:37:21 +0000167 (CurrentToken->Next->is(tok::l_paren) ||
168 (CurrentToken->Next->is(tok::l_square) &&
169 !Contexts.back().IsExpression)))
Daniel Jasper37194282013-05-28 08:33:00 +0000170 Left->Type = TT_FunctionTypeLParen;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000171 Left->MatchingParen = CurrentToken;
172 CurrentToken->MatchingParen = Left;
173
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000174 if (StartsObjCMethodExpr) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000175 CurrentToken->Type = TT_ObjCMethodExpr;
Craig Topper2145bc02014-05-09 08:15:10 +0000176 if (Contexts.back().FirstObjCSelectorName) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000177 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
178 Contexts.back().LongestObjCSelectorName;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000179 }
180 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000181
Daniel Jasper559b63c2014-01-28 20:13:43 +0000182 if (Left->Type == TT_AttributeParen)
183 CurrentToken->Type = TT_AttributeParen;
184
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000185 if (!HasMultipleLines)
186 Left->PackingKind = PPK_Inconclusive;
187 else if (HasMultipleParametersOnALine)
188 Left->PackingKind = PPK_BinPacked;
189 else
190 Left->PackingKind = PPK_OnePerLine;
191
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000192 next();
193 return true;
194 }
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000195 if (CurrentToken->isOneOf(tok::r_square, tok::r_brace))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000196 return false;
Daniel Jasper31745732014-01-19 07:46:32 +0000197 else if (CurrentToken->is(tok::l_brace))
198 Left->Type = TT_Unknown; // Not TT_ObjCBlockLParen
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000199 if (CurrentToken->is(tok::comma) && CurrentToken->Next &&
200 !CurrentToken->Next->HasUnescapedNewline &&
201 !CurrentToken->Next->isTrailingComment())
202 HasMultipleParametersOnALine = true;
Daniel Jaspercc7bf7f2014-04-03 09:00:49 +0000203 if (CurrentToken->isOneOf(tok::kw_const, tok::kw_auto) ||
Daniel Jasperc580af92014-03-11 09:29:46 +0000204 CurrentToken->isSimpleTypeSpecifier())
205 Contexts.back().IsExpression = false;
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000206 FormatToken *Tok = CurrentToken;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000207 if (!consumeToken())
208 return false;
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000209 updateParameterCount(Left, Tok);
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000210 if (CurrentToken && CurrentToken->HasUnescapedNewline)
211 HasMultipleLines = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000212 }
213 return false;
214 }
215
216 bool parseSquare() {
217 if (!CurrentToken)
218 return false;
219
Alexander Kornienkoafaa8f52013-06-17 13:19:53 +0000220 // A '[' could be an index subscript (after an identifier or after
Nico Weber2a726b62013-02-10 02:08:05 +0000221 // ')' or ']'), it could be the start of an Objective-C method
222 // expression, or it could the the start of an Objective-C array literal.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000223 FormatToken *Left = CurrentToken->Previous;
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000224 FormatToken *Parent = Left->getPreviousNonComment();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000225 bool StartsObjCMethodExpr =
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +0000226 Contexts.back().CanBeExpression && Left->Type != TT_LambdaLSquare &&
Daniel Jasper89519082014-05-09 10:26:08 +0000227 CurrentToken->isNot(tok::l_brace) &&
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000228 (!Parent || Parent->isOneOf(tok::colon, tok::l_square, tok::l_paren,
229 tok::kw_return, tok::kw_throw) ||
Daniel Jasperc04baae2013-04-10 09:49:49 +0000230 Parent->isUnaryOperator() || Parent->Type == TT_ObjCForIn ||
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000231 Parent->Type == TT_CastRParen ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000232 getBinOpPrecedence(Parent->Tok.getKind(), true, true) > prec::Unknown);
Daniel Jasper40aacf42013-03-14 13:45:21 +0000233 ScopedContextCreator ContextCreator(*this, tok::l_square, 10);
Daniel Jasper97b89482013-03-13 07:49:51 +0000234 Contexts.back().IsExpression = true;
Daniel Jaspera1ea4cb2013-10-26 17:00:22 +0000235 bool ColonFound = false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000236
Daniel Jasperc697ad22013-02-06 10:05:46 +0000237 if (StartsObjCMethodExpr) {
238 Contexts.back().ColonIsObjCMethodExpr = true;
239 Left->Type = TT_ObjCMethodExpr;
Daniel Jasper1db6c382013-10-22 15:30:28 +0000240 } else if (Parent && Parent->is(tok::at)) {
241 Left->Type = TT_ArrayInitializerLSquare;
242 } else if (Left->Type == TT_Unknown) {
243 Left->Type = TT_ArraySubscriptLSquare;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000244 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000245
Craig Topper2145bc02014-05-09 08:15:10 +0000246 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000247 if (CurrentToken->is(tok::r_square)) {
Daniel Jasper9a8d48b2013-09-05 10:04:31 +0000248 if (CurrentToken->Next && CurrentToken->Next->is(tok::l_paren) &&
249 Left->Type == TT_ObjCMethodExpr) {
Nico Weber5d2624e2013-02-06 06:20:11 +0000250 // An ObjC method call is rarely followed by an open parenthesis.
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000251 // FIXME: Do we incorrectly label ":" with this?
252 StartsObjCMethodExpr = false;
253 Left->Type = TT_Unknown;
254 }
Daniel Jasper139d4a32014-04-08 13:07:41 +0000255 if (StartsObjCMethodExpr && CurrentToken->Previous != Left) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000256 CurrentToken->Type = TT_ObjCMethodExpr;
Nico Weber5d2624e2013-02-06 06:20:11 +0000257 // determineStarAmpUsage() thinks that '*' '[' is allocating an
258 // array of pointers, but if '[' starts a selector then '*' is a
259 // binary operator.
Craig Topper2145bc02014-05-09 08:15:10 +0000260 if (Parent && Parent->Type == TT_PointerOrReference)
Nico Weberac9bde22013-02-06 16:54:35 +0000261 Parent->Type = TT_BinaryOperator;
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000262 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000263 Left->MatchingParen = CurrentToken;
264 CurrentToken->MatchingParen = Left;
Craig Topper2145bc02014-05-09 08:15:10 +0000265 if (Contexts.back().FirstObjCSelectorName) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000266 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
267 Contexts.back().LongestObjCSelectorName;
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000268 if (Left->BlockParameterCount > 1)
Daniel Jasperb88b25f2013-12-23 07:29:06 +0000269 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName = 0;
270 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000271 next();
272 return true;
273 }
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000274 if (CurrentToken->isOneOf(tok::r_paren, tok::r_brace))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000275 return false;
Daniel Jaspera1ea4cb2013-10-26 17:00:22 +0000276 if (CurrentToken->is(tok::colon))
277 ColonFound = true;
Daniel Jasper1db6c382013-10-22 15:30:28 +0000278 if (CurrentToken->is(tok::comma) &&
Daniel Jaspera0e9be22014-01-28 18:51:11 +0000279 Style.Language != FormatStyle::LK_Proto &&
Daniel Jasperb596fb22013-10-24 10:31:50 +0000280 (Left->Type == TT_ArraySubscriptLSquare ||
Daniel Jaspera1ea4cb2013-10-26 17:00:22 +0000281 (Left->Type == TT_ObjCMethodExpr && !ColonFound)))
Daniel Jasper1db6c382013-10-22 15:30:28 +0000282 Left->Type = TT_ArrayInitializerLSquare;
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000283 FormatToken* Tok = CurrentToken;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000284 if (!consumeToken())
285 return false;
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000286 updateParameterCount(Left, Tok);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000287 }
288 return false;
289 }
290
291 bool parseBrace() {
Craig Topper2145bc02014-05-09 08:15:10 +0000292 if (CurrentToken) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000293 FormatToken *Left = CurrentToken->Previous;
Daniel Jasperc13ee342014-03-27 09:43:54 +0000294
295 if (Contexts.back().CaretFound)
296 Left->Type = TT_ObjCBlockLBrace;
297 Contexts.back().CaretFound = false;
298
Daniel Jasperb596fb22013-10-24 10:31:50 +0000299 ScopedContextCreator ContextCreator(*this, tok::l_brace, 1);
300 Contexts.back().ColonIsDictLiteral = true;
Daniel Jasper39485162014-05-22 09:00:33 +0000301 if (Left->BlockKind == BK_BracedInit)
302 Contexts.back().IsExpression = true;
Nico Weberced7d412013-05-26 05:39:26 +0000303
Craig Topper2145bc02014-05-09 08:15:10 +0000304 while (CurrentToken) {
Daniel Jasper8e357692013-05-06 08:27:33 +0000305 if (CurrentToken->is(tok::r_brace)) {
306 Left->MatchingParen = CurrentToken;
307 CurrentToken->MatchingParen = Left;
308 next();
309 return true;
310 }
311 if (CurrentToken->isOneOf(tok::r_paren, tok::r_square))
312 return false;
313 updateParameterCount(Left, CurrentToken);
Daniel Jasper497d9fd2014-08-15 05:00:35 +0000314 if (CurrentToken->isOneOf(tok::colon, tok::l_brace)) {
315 FormatToken *Previous = CurrentToken->getPreviousNonComment();
316 if (Previous->is(tok::identifier))
317 Previous->Type = TT_SelectorName;
318 if (CurrentToken->is(tok::colon))
319 Left->Type = TT_DictLiteral;
Daniel Jasper17062ff2014-06-10 14:44:02 +0000320 }
Daniel Jasper8e357692013-05-06 08:27:33 +0000321 if (!consumeToken())
322 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000323 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000324 }
325 return true;
326 }
Daniel Jasperdc7d5812013-02-20 12:56:39 +0000327
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000328 void updateParameterCount(FormatToken *Left, FormatToken *Current) {
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000329 if (Current->Type == TT_LambdaLSquare ||
330 (Current->is(tok::caret) && Current->Type == TT_UnaryOperator) ||
331 (Style.Language == FormatStyle::LK_JavaScript &&
332 Current->TokenText == "function")) {
333 ++Left->BlockParameterCount;
334 }
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000335 if (Current->is(tok::comma)) {
Daniel Jaspere11095a2013-02-14 15:01:34 +0000336 ++Left->ParameterCount;
Daniel Jasper8de9ed02013-08-22 15:00:41 +0000337 if (!Left->Role)
338 Left->Role.reset(new CommaSeparatedList(Style));
339 Left->Role->CommaFound(Current);
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000340 } else if (Left->ParameterCount == 0 && Current->isNot(tok::comment)) {
Daniel Jaspere11095a2013-02-14 15:01:34 +0000341 Left->ParameterCount = 1;
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000342 }
Daniel Jaspere11095a2013-02-14 15:01:34 +0000343 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000344
345 bool parseConditional() {
Craig Topper2145bc02014-05-09 08:15:10 +0000346 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000347 if (CurrentToken->is(tok::colon)) {
348 CurrentToken->Type = TT_ConditionalExpr;
349 next();
350 return true;
351 }
352 if (!consumeToken())
353 return false;
354 }
355 return false;
356 }
357
358 bool parseTemplateDeclaration() {
Craig Topper2145bc02014-05-09 08:15:10 +0000359 if (CurrentToken && CurrentToken->is(tok::less)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000360 CurrentToken->Type = TT_TemplateOpener;
361 next();
362 if (!parseAngle())
363 return false;
Craig Topper2145bc02014-05-09 08:15:10 +0000364 if (CurrentToken)
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000365 CurrentToken->Previous->ClosesTemplateDeclaration = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000366 return true;
367 }
368 return false;
369 }
370
371 bool consumeToken() {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000372 FormatToken *Tok = CurrentToken;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000373 next();
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000374 switch (Tok->Tok.getKind()) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000375 case tok::plus:
376 case tok::minus:
Craig Topper2145bc02014-05-09 08:15:10 +0000377 if (!Tok->Previous && Line.MustBeDeclaration)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000378 Tok->Type = TT_ObjCMethodSpecifier;
379 break;
380 case tok::colon:
Craig Topper2145bc02014-05-09 08:15:10 +0000381 if (!Tok->Previous)
Daniel Jasper850677d2013-03-18 12:50:26 +0000382 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000383 // Colons from ?: are handled in parseConditional().
Daniel Jasper031e2402014-04-28 07:48:36 +0000384 if (Tok->Previous->is(tok::r_paren) && Contexts.size() == 1 &&
385 Line.First->isNot(tok::kw_case)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000386 Tok->Type = TT_CtorInitializerColon;
Daniel Jasperb596fb22013-10-24 10:31:50 +0000387 } else if (Contexts.back().ColonIsDictLiteral) {
388 Tok->Type = TT_DictLiteral;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000389 } else if (Contexts.back().ColonIsObjCMethodExpr ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000390 Line.First->Type == TT_ObjCMethodSpecifier) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000391 Tok->Type = TT_ObjCMethodExpr;
Daniel Jasper17062ff2014-06-10 14:44:02 +0000392 Tok->Previous->Type = TT_SelectorName;
Alexander Kornienko39856b72013-09-10 09:38:25 +0000393 if (Tok->Previous->ColumnWidth >
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000394 Contexts.back().LongestObjCSelectorName) {
Alexander Kornienko60d1b042013-10-10 13:36:20 +0000395 Contexts.back().LongestObjCSelectorName = Tok->Previous->ColumnWidth;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000396 }
Craig Topper2145bc02014-05-09 08:15:10 +0000397 if (!Contexts.back().FirstObjCSelectorName)
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000398 Contexts.back().FirstObjCSelectorName = Tok->Previous;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000399 } else if (Contexts.back().ColonIsForRangeExpr) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000400 Tok->Type = TT_RangeBasedForLoopColon;
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000401 } else if (CurrentToken && CurrentToken->is(tok::numeric_constant)) {
Alexander Kornienko60d1b042013-10-10 13:36:20 +0000402 Tok->Type = TT_BitFieldColon;
Daniel Jasperd39312ec2014-05-28 10:09:11 +0000403 } else if (Contexts.size() == 1 &&
404 !Line.First->isOneOf(tok::kw_enum, tok::kw_case)) {
Daniel Jaspereead02b2013-02-14 08:42:54 +0000405 Tok->Type = TT_InheritanceColon;
Daniel Jasper40aacf42013-03-14 13:45:21 +0000406 } else if (Contexts.back().ContextKind == tok::l_paren) {
407 Tok->Type = TT_InlineASMColon;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000408 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000409 break;
410 case tok::kw_if:
411 case tok::kw_while:
Craig Topper2145bc02014-05-09 08:15:10 +0000412 if (CurrentToken && CurrentToken->is(tok::l_paren)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000413 next();
Nico Weber9096fc02013-06-26 00:30:14 +0000414 if (!parseParens(/*LookForDecls=*/true))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000415 return false;
416 }
417 break;
418 case tok::kw_for:
Daniel Jasperc697ad22013-02-06 10:05:46 +0000419 Contexts.back().ColonIsForRangeExpr = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000420 next();
421 if (!parseParens())
422 return false;
423 break;
424 case tok::l_paren:
425 if (!parseParens())
426 return false;
Daniel Jasperbc5cb4e2013-11-07 17:43:07 +0000427 if (Line.MustBeDeclaration && Contexts.size() == 1 &&
Daniel Jasperf10a28d2014-05-05 13:48:09 +0000428 !Contexts.back().IsExpression &&
429 Line.First->Type != TT_ObjCProperty &&
430 (!Tok->Previous || Tok->Previous->isNot(tok::kw_decltype)))
Daniel Jasper26d1b1d2013-02-24 18:54:32 +0000431 Line.MightBeFunctionDecl = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000432 break;
433 case tok::l_square:
434 if (!parseSquare())
435 return false;
436 break;
437 case tok::l_brace:
438 if (!parseBrace())
439 return false;
440 break;
441 case tok::less:
Daniel Jasper62c0ac02013-07-30 22:37:19 +0000442 if (Tok->Previous && !Tok->Previous->Tok.isLiteral() && parseAngle())
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000443 Tok->Type = TT_TemplateOpener;
444 else {
445 Tok->Type = TT_BinaryOperator;
446 CurrentToken = Tok;
447 next();
448 }
449 break;
450 case tok::r_paren:
451 case tok::r_square:
452 return false;
453 case tok::r_brace:
454 // Lines can start with '}'.
Craig Topper2145bc02014-05-09 08:15:10 +0000455 if (Tok->Previous)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000456 return false;
457 break;
458 case tok::greater:
459 Tok->Type = TT_BinaryOperator;
460 break;
461 case tok::kw_operator:
Daniel Jasper42401c82013-09-02 09:20:39 +0000462 while (CurrentToken &&
463 !CurrentToken->isOneOf(tok::l_paren, tok::semi, tok::r_paren)) {
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000464 if (CurrentToken->isOneOf(tok::star, tok::amp))
Daniel Jasper35d2dc72013-02-11 08:01:18 +0000465 CurrentToken->Type = TT_PointerOrReference;
466 consumeToken();
Daniel Jasper42401c82013-09-02 09:20:39 +0000467 if (CurrentToken && CurrentToken->Previous->Type == TT_BinaryOperator)
Daniel Jasperd215b8b2013-08-28 07:27:35 +0000468 CurrentToken->Previous->Type = TT_OverloadedOperator;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000469 }
Daniel Jasper8f9624b2013-05-10 07:59:58 +0000470 if (CurrentToken) {
Daniel Jasper35d2dc72013-02-11 08:01:18 +0000471 CurrentToken->Type = TT_OverloadedOperatorLParen;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000472 if (CurrentToken->Previous->Type == TT_BinaryOperator)
473 CurrentToken->Previous->Type = TT_OverloadedOperator;
Daniel Jasper8f9624b2013-05-10 07:59:58 +0000474 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000475 break;
476 case tok::question:
477 parseConditional();
478 break;
479 case tok::kw_template:
480 parseTemplateDeclaration();
481 break;
Nico Weber29f9dea2013-02-11 15:32:15 +0000482 case tok::identifier:
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000483 if (Line.First->is(tok::kw_for) &&
484 Tok->Tok.getIdentifierInfo() == &Ident_in)
Nico Weber29f9dea2013-02-11 15:32:15 +0000485 Tok->Type = TT_ObjCForIn;
486 break;
Daniel Jaspera628c982013-04-03 13:36:17 +0000487 case tok::comma:
488 if (Contexts.back().FirstStartOfName)
489 Contexts.back().FirstStartOfName->PartOfMultiVariableDeclStmt = true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000490 if (Contexts.back().InCtorInitializer)
491 Tok->Type = TT_CtorInitializerComma;
Daniel Jaspere1e43192014-04-01 12:55:11 +0000492 if (Contexts.back().IsForEachMacro)
493 Contexts.back().IsExpression = true;
Daniel Jaspera628c982013-04-03 13:36:17 +0000494 break;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000495 default:
496 break;
497 }
498 return true;
499 }
500
501 void parseIncludeDirective() {
Craig Topper2145bc02014-05-09 08:15:10 +0000502 if (CurrentToken && CurrentToken->is(tok::less)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000503 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000504 while (CurrentToken) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000505 if (CurrentToken->isNot(tok::comment) || CurrentToken->Next)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000506 CurrentToken->Type = TT_ImplicitStringLiteral;
507 next();
508 }
509 } else {
Craig Topper2145bc02014-05-09 08:15:10 +0000510 while (CurrentToken) {
Daniel Jasperaf5ba0e2013-02-23 07:46:38 +0000511 if (CurrentToken->is(tok::string_literal))
512 // Mark these string literals as "implicit" literals, too, so that
513 // they are not split or line-wrapped.
514 CurrentToken->Type = TT_ImplicitStringLiteral;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000515 next();
516 }
517 }
518 }
519
520 void parseWarningOrError() {
521 next();
522 // We still want to format the whitespace left of the first token of the
523 // warning or error.
524 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000525 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000526 CurrentToken->Type = TT_ImplicitStringLiteral;
527 next();
528 }
529 }
530
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000531 void parsePragma() {
532 next(); // Consume "pragma".
533 if (CurrentToken && CurrentToken->TokenText == "mark") {
534 next(); // Consume "mark".
535 next(); // Consume first token (so we fix leading whitespace).
Craig Topper2145bc02014-05-09 08:15:10 +0000536 while (CurrentToken) {
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000537 CurrentToken->Type = TT_ImplicitStringLiteral;
538 next();
539 }
540 }
541 }
542
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000543 void parsePreprocessorDirective() {
544 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000545 if (!CurrentToken)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000546 return;
Alexander Kornienko384b40b2013-10-11 21:43:05 +0000547 if (CurrentToken->Tok.is(tok::numeric_constant)) {
548 CurrentToken->SpacesRequiredBefore = 1;
549 return;
550 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000551 // Hashes in the middle of a line can lead to any strange token
552 // sequence.
Craig Topper2145bc02014-05-09 08:15:10 +0000553 if (!CurrentToken->Tok.getIdentifierInfo())
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000554 return;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000555 switch (CurrentToken->Tok.getIdentifierInfo()->getPPKeywordID()) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000556 case tok::pp_include:
557 case tok::pp_import:
Daniel Jasper343643b2014-08-13 08:29:18 +0000558 next();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000559 parseIncludeDirective();
560 break;
561 case tok::pp_error:
562 case tok::pp_warning:
563 parseWarningOrError();
564 break;
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000565 case tok::pp_pragma:
566 parsePragma();
567 break;
Daniel Jasper4431aa92013-04-23 13:54:04 +0000568 case tok::pp_if:
569 case tok::pp_elif:
Daniel Jasper7cfde412014-01-21 08:56:09 +0000570 Contexts.back().IsExpression = true;
Daniel Jasper4431aa92013-04-23 13:54:04 +0000571 parseLine();
572 break;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000573 default:
574 break;
575 }
Craig Topper2145bc02014-05-09 08:15:10 +0000576 while (CurrentToken)
Daniel Jaspera885dbe2013-02-05 09:34:14 +0000577 next();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000578 }
579
Nico Weber44449172013-02-12 16:17:07 +0000580public:
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000581 LineType parseLine() {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000582 if (CurrentToken->is(tok::hash)) {
583 parsePreprocessorDirective();
584 return LT_PreprocessorDirective;
585 }
Daniel Jasper7cfde412014-01-21 08:56:09 +0000586
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000587 // Directly allow to 'import <string-literal>' to support protocol buffer
588 // definitions (code.google.com/p/protobuf) or missing "#" (either way we
589 // should not break the line).
590 IdentifierInfo *Info = CurrentToken->Tok.getIdentifierInfo();
591 if (Info && Info->getPPKeywordID() == tok::pp_import &&
Daniel Jasper343643b2014-08-13 08:29:18 +0000592 CurrentToken->Next && CurrentToken->Next->is(tok::string_literal)) {
593 next();
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000594 parseIncludeDirective();
Daniel Jasper343643b2014-08-13 08:29:18 +0000595 return LT_Other;
596 }
597
598 // If this line starts and ends in '<' and '>', respectively, it is likely
599 // part of "#define <a/b.h>".
600 if (CurrentToken->is(tok::less) && Line.Last->is(tok::greater)) {
601 parseIncludeDirective();
602 return LT_Other;
603 }
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000604
Craig Topper2145bc02014-05-09 08:15:10 +0000605 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000606 if (CurrentToken->is(tok::kw_virtual))
607 KeywordVirtualFound = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000608 if (!consumeToken())
609 return LT_Invalid;
610 }
611 if (KeywordVirtualFound)
612 return LT_VirtualFunctionDecl;
613
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000614 if (Line.First->Type == TT_ObjCMethodSpecifier) {
Craig Topper2145bc02014-05-09 08:15:10 +0000615 if (Contexts.back().FirstObjCSelectorName)
Daniel Jasperc697ad22013-02-06 10:05:46 +0000616 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
617 Contexts.back().LongestObjCSelectorName;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000618 return LT_ObjCMethodDecl;
619 }
620
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000621 return LT_Other;
622 }
623
Nico Weber44449172013-02-12 16:17:07 +0000624private:
Manuel Klimek819788d2014-03-18 11:22:45 +0000625 void resetTokenMetadata(FormatToken *Token) {
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000626 if (!Token)
627 return;
Manuel Klimek819788d2014-03-18 11:22:45 +0000628
629 // Reset token type in case we have already looked at it and then
630 // recovered from an error (e.g. failure to find the matching >).
631 if (CurrentToken->Type != TT_LambdaLSquare &&
632 CurrentToken->Type != TT_FunctionLBrace &&
633 CurrentToken->Type != TT_ImplicitStringLiteral &&
Daniel Jasperf9ae3122014-05-08 07:01:45 +0000634 CurrentToken->Type != TT_RegexLiteral &&
Manuel Klimek819788d2014-03-18 11:22:45 +0000635 CurrentToken->Type != TT_TrailingReturnArrow)
636 CurrentToken->Type = TT_Unknown;
David Blaikie3875a822014-07-19 01:06:45 +0000637 CurrentToken->Role.reset();
Manuel Klimek819788d2014-03-18 11:22:45 +0000638 CurrentToken->FakeLParens.clear();
639 CurrentToken->FakeRParens = 0;
640 }
641
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000642 void next() {
Craig Topper2145bc02014-05-09 08:15:10 +0000643 if (CurrentToken) {
Daniel Jasper63af7c42013-12-09 14:40:19 +0000644 CurrentToken->NestingLevel = Contexts.size() - 1;
Daniel Jasper78b45332014-08-14 10:52:56 +0000645 CurrentToken->BindingStrength = Contexts.back().BindingStrength;
646 determineTokenType(*CurrentToken);
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000647 CurrentToken = CurrentToken->Next;
Daniel Jasperf9ae3122014-05-08 07:01:45 +0000648 }
Daniel Jasper5065bc42013-02-18 12:44:35 +0000649
Manuel Klimek819788d2014-03-18 11:22:45 +0000650 resetTokenMetadata(CurrentToken);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000651 }
652
Daniel Jasperc697ad22013-02-06 10:05:46 +0000653 /// \brief A struct to hold information valid in a specific context, e.g.
654 /// a pair of parenthesis.
655 struct Context {
Daniel Jasper40aacf42013-03-14 13:45:21 +0000656 Context(tok::TokenKind ContextKind, unsigned BindingStrength,
657 bool IsExpression)
658 : ContextKind(ContextKind), BindingStrength(BindingStrength),
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000659 LongestObjCSelectorName(0), ColonIsForRangeExpr(false),
660 ColonIsDictLiteral(false), ColonIsObjCMethodExpr(false),
661 FirstObjCSelectorName(nullptr), FirstStartOfName(nullptr),
662 IsExpression(IsExpression), CanBeExpression(true),
663 InTemplateArgument(false), InCtorInitializer(false),
664 CaretFound(false), IsForEachMacro(false) {}
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000665
Daniel Jasper40aacf42013-03-14 13:45:21 +0000666 tok::TokenKind ContextKind;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000667 unsigned BindingStrength;
668 unsigned LongestObjCSelectorName;
669 bool ColonIsForRangeExpr;
Daniel Jasperb596fb22013-10-24 10:31:50 +0000670 bool ColonIsDictLiteral;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000671 bool ColonIsObjCMethodExpr;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000672 FormatToken *FirstObjCSelectorName;
673 FormatToken *FirstStartOfName;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000674 bool IsExpression;
Daniel Jasper97b89482013-03-13 07:49:51 +0000675 bool CanBeExpression;
Manuel Klimekf81e5c02014-03-27 11:17:36 +0000676 bool InTemplateArgument;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000677 bool InCtorInitializer;
Daniel Jaspera225bce2014-01-16 19:14:34 +0000678 bool CaretFound;
Daniel Jaspere1e43192014-04-01 12:55:11 +0000679 bool IsForEachMacro;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000680 };
681
682 /// \brief Puts a new \c Context onto the stack \c Contexts for the lifetime
683 /// of each instance.
684 struct ScopedContextCreator {
685 AnnotatingParser &P;
686
Daniel Jasper40aacf42013-03-14 13:45:21 +0000687 ScopedContextCreator(AnnotatingParser &P, tok::TokenKind ContextKind,
688 unsigned Increase)
689 : P(P) {
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +0000690 P.Contexts.push_back(Context(ContextKind,
691 P.Contexts.back().BindingStrength + Increase,
692 P.Contexts.back().IsExpression));
Daniel Jasperc697ad22013-02-06 10:05:46 +0000693 }
694
695 ~ScopedContextCreator() { P.Contexts.pop_back(); }
696 };
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000697
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000698 void determineTokenType(FormatToken &Current) {
699 if (Current.getPrecedence() == prec::Assignment &&
Daniel Jasper59036852013-08-12 12:16:34 +0000700 !Line.First->isOneOf(tok::kw_template, tok::kw_using) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000701 (!Current.Previous || Current.Previous->isNot(tok::kw_operator))) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000702 Contexts.back().IsExpression = true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000703 for (FormatToken *Previous = Current.Previous;
Daniel Jasper5ca9b712013-09-11 20:37:10 +0000704 Previous && !Previous->isOneOf(tok::comma, tok::semi);
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000705 Previous = Previous->Previous) {
Manuel Klimek5f594f82014-08-13 14:00:41 +0000706 if (Previous->isOneOf(tok::r_square, tok::r_paren)) {
Daniel Jasper8e559272013-02-27 11:43:50 +0000707 Previous = Previous->MatchingParen;
Manuel Klimek5f594f82014-08-13 14:00:41 +0000708 if (!Previous)
709 break;
710 }
Daniel Jasper8184d662014-07-28 12:24:21 +0000711 if ((Previous->Type == TT_BinaryOperator ||
712 Previous->Type == TT_UnaryOperator) &&
Daniel Jasper1904e9b2014-08-14 10:53:19 +0000713 Previous->isOneOf(tok::star, tok::amp) && Previous->Previous &&
714 Previous->Previous->isNot(tok::equal)) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000715 Previous->Type = TT_PointerOrReference;
716 }
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000717 }
Daniel Jasper3682fcd2013-12-16 08:36:18 +0000718 } else if (Current.isOneOf(tok::kw_return, tok::kw_throw)) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000719 Contexts.back().IsExpression = true;
Daniel Jasper3682fcd2013-12-16 08:36:18 +0000720 } else if (Current.is(tok::l_paren) && !Line.MustBeDeclaration &&
Dinesh Dwivedi2e92e662014-05-06 11:46:49 +0000721 !Line.InPPDirective &&
722 (!Current.Previous ||
723 Current.Previous->isNot(tok::kw_decltype))) {
Daniel Jasper3682fcd2013-12-16 08:36:18 +0000724 bool ParametersOfFunctionType =
725 Current.Previous && Current.Previous->is(tok::r_paren) &&
726 Current.Previous->MatchingParen &&
727 Current.Previous->MatchingParen->Type == TT_FunctionTypeLParen;
728 bool IsForOrCatch = Current.Previous &&
729 Current.Previous->isOneOf(tok::kw_for, tok::kw_catch);
730 Contexts.back().IsExpression = !ParametersOfFunctionType && !IsForOrCatch;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000731 } else if (Current.isOneOf(tok::r_paren, tok::greater, tok::comma)) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000732 for (FormatToken *Previous = Current.Previous;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000733 Previous && Previous->isOneOf(tok::star, tok::amp);
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000734 Previous = Previous->Previous)
Nico Weber44449172013-02-12 16:17:07 +0000735 Previous->Type = TT_PointerOrReference;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000736 } else if (Current.Previous &&
737 Current.Previous->Type == TT_CtorInitializerColon) {
Daniel Jasper5065bc42013-02-18 12:44:35 +0000738 Contexts.back().IsExpression = true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000739 Contexts.back().InCtorInitializer = true;
Daniel Jasper97b89482013-03-13 07:49:51 +0000740 } else if (Current.is(tok::kw_new)) {
741 Contexts.back().CanBeExpression = false;
Daniel Jaspera98da3d2013-11-07 19:56:07 +0000742 } else if (Current.is(tok::semi) || Current.is(tok::exclaim)) {
Daniel Jasperc37de302013-05-03 14:41:24 +0000743 // This should be the condition or increment in a for-loop.
744 Contexts.back().IsExpression = true;
Nico Weber44449172013-02-12 16:17:07 +0000745 }
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000746
747 if (Current.Type == TT_Unknown) {
Daniel Jasperf3167902013-09-27 08:29:16 +0000748 // Line.MightBeFunctionDecl can only be true after the parentheses of a
749 // function declaration have been found. In this case, 'Current' is a
750 // trailing token of this declaration and thus cannot be a name.
Daniel Jasper78b45332014-08-14 10:52:56 +0000751 if (isStartOfName(Current) &&
752 (!Line.MightBeFunctionDecl || Current.NestingLevel != 0)) {
Daniel Jaspera628c982013-04-03 13:36:17 +0000753 Contexts.back().FirstStartOfName = &Current;
Daniel Jasper26d1b1d2013-02-24 18:54:32 +0000754 Current.Type = TT_StartOfName;
Daniel Jasper6cdec7c2013-07-09 14:36:48 +0000755 } else if (Current.is(tok::kw_auto)) {
756 AutoFound = true;
Daniel Jaspera3501d42013-07-11 14:33:06 +0000757 } else if (Current.is(tok::arrow) && AutoFound &&
758 Line.MustBeDeclaration) {
Daniel Jasper6cdec7c2013-07-09 14:36:48 +0000759 Current.Type = TT_TrailingReturnArrow;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000760 } else if (Current.isOneOf(tok::star, tok::amp, tok::ampamp)) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000761 Current.Type =
Daniel Jasper6f9c8d22013-07-05 13:30:40 +0000762 determineStarAmpUsage(Current, Contexts.back().CanBeExpression &&
Manuel Klimekf81e5c02014-03-27 11:17:36 +0000763 Contexts.back().IsExpression,
764 Contexts.back().InTemplateArgument);
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000765 } else if (Current.isOneOf(tok::minus, tok::plus, tok::caret)) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000766 Current.Type = determinePlusMinusCaretUsage(Current);
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000767 if (Current.Type == TT_UnaryOperator && Current.is(tok::caret))
Daniel Jasperb77105d2014-04-08 14:04:31 +0000768 Contexts.back().CaretFound = true;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000769 } else if (Current.isOneOf(tok::minusminus, tok::plusplus)) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000770 Current.Type = determineIncrementUsage(Current);
Daniel Jasper2ac3fdf2014-07-28 12:08:16 +0000771 } else if (Current.isOneOf(tok::exclaim, tok::tilde)) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000772 Current.Type = TT_UnaryOperator;
Daniel Jasperc0d606a2014-04-14 11:08:45 +0000773 } else if (Current.is(tok::question)) {
774 Current.Type = TT_ConditionalExpr;
Manuel Klimekbab25fd2013-09-04 08:20:47 +0000775 } else if (Current.isBinaryOperator() &&
776 (!Current.Previous ||
777 Current.Previous->isNot(tok::l_square))) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000778 Current.Type = TT_BinaryOperator;
779 } else if (Current.is(tok::comment)) {
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000780 if (Current.TokenText.startswith("//"))
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000781 Current.Type = TT_LineComment;
782 else
783 Current.Type = TT_BlockComment;
Nico Weberc6fe2162013-02-13 04:13:13 +0000784 } else if (Current.is(tok::r_paren)) {
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000785 if (rParenEndsCast(Current))
Nico Weberc6fe2162013-02-13 04:13:13 +0000786 Current.Type = TT_CastRParen;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000787 } else if (Current.is(tok::at) && Current.Next) {
788 switch (Current.Next->Tok.getObjCKeywordID()) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000789 case tok::objc_interface:
790 case tok::objc_implementation:
791 case tok::objc_protocol:
792 Current.Type = TT_ObjCDecl;
793 break;
794 case tok::objc_property:
795 Current.Type = TT_ObjCProperty;
796 break;
797 default:
798 break;
799 }
Daniel Jasperbca4bbe2013-05-28 11:30:49 +0000800 } else if (Current.is(tok::period)) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000801 FormatToken *PreviousNoComment = Current.getPreviousNonComment();
Daniel Jasperbca4bbe2013-05-28 11:30:49 +0000802 if (PreviousNoComment &&
803 PreviousNoComment->isOneOf(tok::comma, tok::l_brace))
804 Current.Type = TT_DesignatedInitializerPeriod;
Daniel Jasper43e6a282013-12-16 15:01:54 +0000805 } else if (Current.isOneOf(tok::identifier, tok::kw_const) &&
Daniel Jasper35ec2b22014-04-14 08:15:20 +0000806 Current.Previous && Current.Previous->isNot(tok::equal) &&
Daniel Jasper43e6a282013-12-16 15:01:54 +0000807 Line.MightBeFunctionDecl && Contexts.size() == 1) {
808 // Line.MightBeFunctionDecl can only be true after the parentheses of a
809 // function declaration have been found.
810 Current.Type = TT_TrailingAnnotation;
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000811 }
812 }
813 }
814
Daniel Jasperdba1c552013-07-02 09:47:29 +0000815 /// \brief Take a guess at whether \p Tok starts a name of a function or
816 /// variable declaration.
817 ///
818 /// This is a heuristic based on whether \p Tok is an identifier following
819 /// something that is likely a type.
820 bool isStartOfName(const FormatToken &Tok) {
Craig Topper2145bc02014-05-09 08:15:10 +0000821 if (Tok.isNot(tok::identifier) || !Tok.Previous)
Daniel Jasperdba1c552013-07-02 09:47:29 +0000822 return false;
823
824 // Skip "const" as it does not have an influence on whether this is a name.
825 FormatToken *PreviousNotConst = Tok.Previous;
Craig Topper2145bc02014-05-09 08:15:10 +0000826 while (PreviousNotConst && PreviousNotConst->is(tok::kw_const))
Daniel Jasperdba1c552013-07-02 09:47:29 +0000827 PreviousNotConst = PreviousNotConst->Previous;
828
Craig Topper2145bc02014-05-09 08:15:10 +0000829 if (!PreviousNotConst)
Daniel Jasperdba1c552013-07-02 09:47:29 +0000830 return false;
831
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +0000832 bool IsPPKeyword = PreviousNotConst->is(tok::identifier) &&
833 PreviousNotConst->Previous &&
834 PreviousNotConst->Previous->is(tok::hash);
Daniel Jasperdba1c552013-07-02 09:47:29 +0000835
Daniel Jasper53643062013-08-19 10:16:18 +0000836 if (PreviousNotConst->Type == TT_TemplateCloser)
837 return PreviousNotConst && PreviousNotConst->MatchingParen &&
838 PreviousNotConst->MatchingParen->Previous &&
839 PreviousNotConst->MatchingParen->Previous->isNot(tok::kw_template);
840
Daniel Jasperf10a28d2014-05-05 13:48:09 +0000841 if (PreviousNotConst->is(tok::r_paren) && PreviousNotConst->MatchingParen &&
842 PreviousNotConst->MatchingParen->Previous &&
843 PreviousNotConst->MatchingParen->Previous->is(tok::kw_decltype))
844 return true;
845
Daniel Jasperdba1c552013-07-02 09:47:29 +0000846 return (!IsPPKeyword && PreviousNotConst->is(tok::identifier)) ||
847 PreviousNotConst->Type == TT_PointerOrReference ||
Daniel Jaspercb51cf42014-01-16 09:11:55 +0000848 PreviousNotConst->isSimpleTypeSpecifier();
Daniel Jasperdba1c552013-07-02 09:47:29 +0000849 }
850
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000851 /// \brief Determine whether ')' is ending a cast.
852 bool rParenEndsCast(const FormatToken &Tok) {
Craig Topper4b566922014-06-09 02:04:02 +0000853 FormatToken *LeftOfParens = nullptr;
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000854 if (Tok.MatchingParen)
855 LeftOfParens = Tok.MatchingParen->getPreviousNonComment();
Daniel Jasper4b3ba212014-08-25 09:36:07 +0000856 if (LeftOfParens && LeftOfParens->is(tok::r_paren) &&
857 LeftOfParens->MatchingParen)
858 LeftOfParens = LeftOfParens->MatchingParen->Previous;
Daniel Jasper8b76d602014-07-28 12:08:06 +0000859 if (LeftOfParens && LeftOfParens->is(tok::r_square) &&
860 LeftOfParens->MatchingParen &&
861 LeftOfParens->MatchingParen->Type == TT_LambdaLSquare)
862 return false;
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000863 bool IsCast = false;
864 bool ParensAreEmpty = Tok.Previous == Tok.MatchingParen;
865 bool ParensAreType = !Tok.Previous ||
866 Tok.Previous->Type == TT_PointerOrReference ||
867 Tok.Previous->Type == TT_TemplateCloser ||
868 Tok.Previous->isSimpleTypeSpecifier();
869 bool ParensCouldEndDecl =
870 Tok.Next && Tok.Next->isOneOf(tok::equal, tok::semi, tok::l_brace);
871 bool IsSizeOfOrAlignOf =
872 LeftOfParens && LeftOfParens->isOneOf(tok::kw_sizeof, tok::kw_alignof);
873 if (ParensAreType && !ParensCouldEndDecl && !IsSizeOfOrAlignOf &&
874 ((Contexts.size() > 1 && Contexts[Contexts.size() - 2].IsExpression) ||
875 (Tok.Next && Tok.Next->isBinaryOperator())))
876 IsCast = true;
877 else if (Tok.Next && Tok.Next->isNot(tok::string_literal) &&
878 (Tok.Next->Tok.isLiteral() ||
879 Tok.Next->isOneOf(tok::kw_sizeof, tok::kw_alignof)))
880 IsCast = true;
881 // If there is an identifier after the (), it is likely a cast, unless
882 // there is also an identifier before the ().
Craig Topper4b566922014-06-09 02:04:02 +0000883 else if (LeftOfParens &&
884 (LeftOfParens->Tok.getIdentifierInfo() == nullptr ||
885 LeftOfParens->is(tok::kw_return)) &&
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000886 LeftOfParens->Type != TT_OverloadedOperator &&
887 LeftOfParens->isNot(tok::at) &&
888 LeftOfParens->Type != TT_TemplateCloser && Tok.Next) {
889 if (Tok.Next->isOneOf(tok::identifier, tok::numeric_constant)) {
890 IsCast = true;
891 } else {
892 // Use heuristics to recognize c style casting.
893 FormatToken *Prev = Tok.Previous;
894 if (Prev && Prev->isOneOf(tok::amp, tok::star))
895 Prev = Prev->Previous;
896
897 if (Prev && Tok.Next && Tok.Next->Next) {
898 bool NextIsUnary = Tok.Next->isUnaryOperator() ||
899 Tok.Next->isOneOf(tok::amp, tok::star);
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000900 IsCast = NextIsUnary && Tok.Next->Next->isOneOf(
901 tok::identifier, tok::numeric_constant);
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000902 }
903
904 for (; Prev != Tok.MatchingParen; Prev = Prev->Previous) {
905 if (!Prev || !Prev->isOneOf(tok::kw_const, tok::identifier)) {
906 IsCast = false;
907 break;
908 }
909 }
910 }
911 }
912 return IsCast && !ParensAreEmpty;
913 }
914
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000915 /// \brief Return the type of the given token assuming it is * or &.
Manuel Klimekf81e5c02014-03-27 11:17:36 +0000916 TokenType determineStarAmpUsage(const FormatToken &Tok, bool IsExpression,
917 bool InTemplateArgument) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000918 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Craig Topper2145bc02014-05-09 08:15:10 +0000919 if (!PrevToken)
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000920 return TT_UnaryOperator;
921
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000922 const FormatToken *NextToken = Tok.getNextNonComment();
Daniel Jasper2520fe92014-06-30 13:54:27 +0000923 if (!NextToken || NextToken->is(tok::l_brace))
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000924 return TT_Unknown;
925
Daniel Jasper37194282013-05-28 08:33:00 +0000926 if (PrevToken->is(tok::coloncolon) ||
927 (PrevToken->is(tok::l_paren) && !IsExpression))
Daniel Jasper8eb371b2013-03-01 17:13:29 +0000928 return TT_PointerOrReference;
929
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000930 if (PrevToken->isOneOf(tok::l_paren, tok::l_square, tok::l_brace,
Daniel Jasperae907642013-03-14 10:50:25 +0000931 tok::comma, tok::semi, tok::kw_return, tok::colon,
Daniel Jasperdf620b22013-09-21 17:31:51 +0000932 tok::equal, tok::kw_delete, tok::kw_sizeof) ||
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000933 PrevToken->Type == TT_BinaryOperator ||
Daniel Jasperc0d606a2014-04-14 11:08:45 +0000934 PrevToken->Type == TT_ConditionalExpr ||
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000935 PrevToken->Type == TT_UnaryOperator || PrevToken->Type == TT_CastRParen)
936 return TT_UnaryOperator;
937
Daniel Jasperea2d0422014-05-08 08:50:10 +0000938 if (NextToken->is(tok::l_square) && NextToken->Type != TT_LambdaLSquare)
Nico Weber5d2624e2013-02-06 06:20:11 +0000939 return TT_PointerOrReference;
Daniel Jasper6ba16382014-07-28 13:19:58 +0000940 if (NextToken->isOneOf(tok::kw_operator, tok::comma))
Daniel Jasper32ccb032014-06-23 07:36:18 +0000941 return TT_PointerOrReference;
Nico Weber5d2624e2013-02-06 06:20:11 +0000942
Daniel Jasper71665cd2013-09-10 10:26:38 +0000943 if (PrevToken->is(tok::r_paren) && PrevToken->MatchingParen &&
944 PrevToken->MatchingParen->Previous &&
Daniel Jasper4ac7de72014-06-11 07:35:16 +0000945 PrevToken->MatchingParen->Previous->isOneOf(tok::kw_typeof,
946 tok::kw_decltype))
Daniel Jasper71665cd2013-09-10 10:26:38 +0000947 return TT_PointerOrReference;
948
Manuel Klimek94815562014-03-28 09:27:09 +0000949 if (PrevToken->Tok.isLiteral() ||
950 PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::kw_true,
951 tok::kw_false) ||
952 NextToken->Tok.isLiteral() ||
953 NextToken->isOneOf(tok::kw_true, tok::kw_false) ||
954 NextToken->isUnaryOperator() ||
Manuel Klimekf81e5c02014-03-27 11:17:36 +0000955 // If we know we're in a template argument, there are no named
956 // declarations. Thus, having an identifier on the right-hand side
957 // indicates a binary operator.
958 (InTemplateArgument && NextToken->Tok.isAnyIdentifier()))
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000959 return TT_BinaryOperator;
960
Daniel Jasper7d028292014-06-02 11:54:20 +0000961 // This catches some cases where evaluation order is used as control flow:
962 // aaa && aaa->f();
963 const FormatToken *NextNextToken = NextToken->getNextNonComment();
964 if (NextNextToken && NextNextToken->is(tok::arrow))
965 return TT_BinaryOperator;
966
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000967 // It is very unlikely that we are going to find a pointer or reference type
968 // definition on the RHS of an assignment.
969 if (IsExpression)
970 return TT_BinaryOperator;
971
972 return TT_PointerOrReference;
973 }
974
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000975 TokenType determinePlusMinusCaretUsage(const FormatToken &Tok) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000976 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Craig Topper2145bc02014-05-09 08:15:10 +0000977 if (!PrevToken || PrevToken->Type == TT_CastRParen)
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000978 return TT_UnaryOperator;
979
980 // Use heuristics to recognize unary operators.
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000981 if (PrevToken->isOneOf(tok::equal, tok::l_paren, tok::comma, tok::l_square,
982 tok::question, tok::colon, tok::kw_return,
983 tok::kw_case, tok::at, tok::l_brace))
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000984 return TT_UnaryOperator;
985
Nico Weberb76de882013-02-05 16:21:00 +0000986 // There can't be two consecutive binary operators.
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000987 if (PrevToken->Type == TT_BinaryOperator)
988 return TT_UnaryOperator;
989
990 // Fall back to marking the token as binary operator.
991 return TT_BinaryOperator;
992 }
993
994 /// \brief Determine whether ++/-- are pre- or post-increments/-decrements.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000995 TokenType determineIncrementUsage(const FormatToken &Tok) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000996 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Craig Topper2145bc02014-05-09 08:15:10 +0000997 if (!PrevToken || PrevToken->Type == TT_CastRParen)
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000998 return TT_UnaryOperator;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000999 if (PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::identifier))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001000 return TT_TrailingUnaryOperator;
1001
1002 return TT_UnaryOperator;
1003 }
Daniel Jasperc697ad22013-02-06 10:05:46 +00001004
1005 SmallVector<Context, 8> Contexts;
1006
Daniel Jasper8de9ed02013-08-22 15:00:41 +00001007 const FormatStyle &Style;
Daniel Jasperc697ad22013-02-06 10:05:46 +00001008 AnnotatedLine &Line;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001009 FormatToken *CurrentToken;
Daniel Jasperc697ad22013-02-06 10:05:46 +00001010 bool KeywordVirtualFound;
Daniel Jasper6cdec7c2013-07-09 14:36:48 +00001011 bool AutoFound;
Nico Weber29f9dea2013-02-11 15:32:15 +00001012 IdentifierInfo &Ident_in;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001013};
1014
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001015static int PrecedenceUnaryOperator = prec::PointerToMember + 1;
1016static int PrecedenceArrowAndPeriod = prec::PointerToMember + 2;
1017
Daniel Jasper400adc62013-02-08 15:28:42 +00001018/// \brief Parses binary expressions by inserting fake parenthesis based on
1019/// operator precedence.
1020class ExpressionParser {
1021public:
Daniel Jasper6dcecb62013-06-06 09:11:58 +00001022 ExpressionParser(AnnotatedLine &Line) : Current(Line.First) {
1023 // Skip leading "}", e.g. in "} else if (...) {".
1024 if (Current->is(tok::r_brace))
1025 next();
1026 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001027
1028 /// \brief Parse expressions with the given operatore precedence.
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001029 void parse(int Precedence = 0) {
Daniel Jasperf48b5ab2013-11-07 19:23:49 +00001030 // Skip 'return' and ObjC selector colons as they are not part of a binary
1031 // expression.
1032 while (Current &&
1033 (Current->is(tok::kw_return) ||
Daniel Jasper17062ff2014-06-10 14:44:02 +00001034 (Current->is(tok::colon) && (Current->Type == TT_ObjCMethodExpr ||
1035 Current->Type == TT_DictLiteral))))
Daniel Jaspereabede62013-09-30 08:29:03 +00001036 next();
1037
Craig Topper2145bc02014-05-09 08:15:10 +00001038 if (!Current || Precedence > PrecedenceArrowAndPeriod)
Daniel Jasper0649d362013-08-23 15:14:03 +00001039 return;
1040
Daniel Jasper2c611c02013-05-31 14:56:12 +00001041 // Conditional expressions need to be parsed separately for proper nesting.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001042 if (Precedence == prec::Conditional) {
Daniel Jasper2c611c02013-05-31 14:56:12 +00001043 parseConditionalExpr();
1044 return;
1045 }
Daniel Jasper0649d362013-08-23 15:14:03 +00001046
1047 // Parse unary operators, which all have a higher precedence than binary
1048 // operators.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001049 if (Precedence == PrecedenceUnaryOperator) {
Daniel Jasper0649d362013-08-23 15:14:03 +00001050 parseUnaryOperator();
Daniel Jasper400adc62013-02-08 15:28:42 +00001051 return;
Daniel Jasper0649d362013-08-23 15:14:03 +00001052 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001053
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001054 FormatToken *Start = Current;
Craig Topper2145bc02014-05-09 08:15:10 +00001055 FormatToken *LatestOperator = nullptr;
Daniel Jasper0e617842014-04-16 12:26:54 +00001056 unsigned OperatorIndex = 0;
Daniel Jasper400adc62013-02-08 15:28:42 +00001057
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001058 while (Current) {
Daniel Jasper400adc62013-02-08 15:28:42 +00001059 // Consume operators with higher precedence.
Daniel Jasper6bee6822013-04-08 20:33:42 +00001060 parse(Precedence + 1);
Daniel Jasper400adc62013-02-08 15:28:42 +00001061
Daniel Jasper0649d362013-08-23 15:14:03 +00001062 int CurrentPrecedence = getCurrentPrecedence();
1063
Daniel Jasper17062ff2014-06-10 14:44:02 +00001064 if (Current && Current->Type == TT_SelectorName &&
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001065 Precedence == CurrentPrecedence) {
1066 if (LatestOperator)
1067 addFakeParenthesis(Start, prec::Level(Precedence));
Daniel Jasper0649d362013-08-23 15:14:03 +00001068 Start = Current;
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001069 }
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001070
Daniel Jasper400adc62013-02-08 15:28:42 +00001071 // At the end of the line or when an operator with higher precedence is
1072 // found, insert fake parenthesis and return.
Craig Topper2145bc02014-05-09 08:15:10 +00001073 if (!Current || Current->closesScope() ||
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001074 (CurrentPrecedence != -1 && CurrentPrecedence < Precedence)) {
1075 if (LatestOperator) {
Daniel Jasper0e617842014-04-16 12:26:54 +00001076 LatestOperator->LastOperator = true;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001077 if (Precedence == PrecedenceArrowAndPeriod) {
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001078 // Call expressions don't have a binary operator precedence.
1079 addFakeParenthesis(Start, prec::Unknown);
1080 } else {
1081 addFakeParenthesis(Start, prec::Level(Precedence));
1082 }
1083 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001084 return;
1085 }
1086
1087 // Consume scopes: (), [], <> and {}
Daniel Jasperc04baae2013-04-10 09:49:49 +00001088 if (Current->opensScope()) {
1089 while (Current && !Current->closesScope()) {
Daniel Jasper400adc62013-02-08 15:28:42 +00001090 next();
1091 parse();
1092 }
1093 next();
1094 } else {
1095 // Operator found.
Daniel Jasper0e617842014-04-16 12:26:54 +00001096 if (CurrentPrecedence == Precedence) {
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001097 LatestOperator = Current;
Daniel Jasper0e617842014-04-16 12:26:54 +00001098 Current->OperatorIndex = OperatorIndex;
1099 ++OperatorIndex;
1100 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001101
1102 next();
1103 }
1104 }
1105 }
1106
1107private:
Daniel Jasper0649d362013-08-23 15:14:03 +00001108 /// \brief Gets the precedence (+1) of the given token for binary operators
1109 /// and other tokens that we treat like binary operators.
1110 int getCurrentPrecedence() {
1111 if (Current) {
1112 if (Current->Type == TT_ConditionalExpr)
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001113 return prec::Conditional;
Daniel Jasperf48b5ab2013-11-07 19:23:49 +00001114 else if (Current->is(tok::semi) || Current->Type == TT_InlineASMColon ||
Daniel Jasper17062ff2014-06-10 14:44:02 +00001115 Current->Type == TT_SelectorName)
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001116 return 0;
Daniel Jasper9cc3e972014-02-07 10:09:46 +00001117 else if (Current->Type == TT_RangeBasedForLoopColon)
1118 return prec::Comma;
Daniel Jasper0649d362013-08-23 15:14:03 +00001119 else if (Current->Type == TT_BinaryOperator || Current->is(tok::comma))
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001120 return Current->getPrecedence();
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001121 else if (Current->isOneOf(tok::period, tok::arrow))
1122 return PrecedenceArrowAndPeriod;
Daniel Jasper0649d362013-08-23 15:14:03 +00001123 }
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001124 return -1;
Daniel Jasper0649d362013-08-23 15:14:03 +00001125 }
1126
Daniel Jasper2c611c02013-05-31 14:56:12 +00001127 void addFakeParenthesis(FormatToken *Start, prec::Level Precedence) {
1128 Start->FakeLParens.push_back(Precedence);
Daniel Jasper562ecd42013-09-06 08:08:14 +00001129 if (Precedence > prec::Unknown)
1130 Start->StartsBinaryExpression = true;
1131 if (Current) {
Daniel Jasper2c611c02013-05-31 14:56:12 +00001132 ++Current->Previous->FakeRParens;
Daniel Jasper562ecd42013-09-06 08:08:14 +00001133 if (Precedence > prec::Unknown)
1134 Current->Previous->EndsBinaryExpression = true;
1135 }
Daniel Jasper2c611c02013-05-31 14:56:12 +00001136 }
1137
Daniel Jasper0649d362013-08-23 15:14:03 +00001138 /// \brief Parse unary operator expressions and surround them with fake
1139 /// parentheses if appropriate.
1140 void parseUnaryOperator() {
Craig Topper2145bc02014-05-09 08:15:10 +00001141 if (!Current || Current->Type != TT_UnaryOperator) {
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001142 parse(PrecedenceArrowAndPeriod);
Daniel Jasper0649d362013-08-23 15:14:03 +00001143 return;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001144 }
Daniel Jasper0649d362013-08-23 15:14:03 +00001145
1146 FormatToken *Start = Current;
1147 next();
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001148 parseUnaryOperator();
Daniel Jasper0649d362013-08-23 15:14:03 +00001149
Daniel Jasper0649d362013-08-23 15:14:03 +00001150 // The actual precedence doesn't matter.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001151 addFakeParenthesis(Start, prec::Unknown);
Daniel Jasper0649d362013-08-23 15:14:03 +00001152 }
1153
Daniel Jasper2c611c02013-05-31 14:56:12 +00001154 void parseConditionalExpr() {
1155 FormatToken *Start = Current;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001156 parse(prec::LogicalOr);
Daniel Jasper2c611c02013-05-31 14:56:12 +00001157 if (!Current || !Current->is(tok::question))
1158 return;
1159 next();
Daniel Jasperfc3861a2014-07-17 12:22:04 +00001160 parseConditionalExpr();
Daniel Jasper2c611c02013-05-31 14:56:12 +00001161 if (!Current || Current->Type != TT_ConditionalExpr)
1162 return;
1163 next();
1164 parseConditionalExpr();
1165 addFakeParenthesis(Start, prec::Conditional);
1166 }
1167
Daniel Jasper400adc62013-02-08 15:28:42 +00001168 void next() {
Alexander Kornienkoafaa8f52013-06-17 13:19:53 +00001169 if (Current)
1170 Current = Current->Next;
1171 while (Current && Current->isTrailingComment())
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001172 Current = Current->Next;
Daniel Jasper400adc62013-02-08 15:28:42 +00001173 }
1174
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001175 FormatToken *Current;
Daniel Jasper400adc62013-02-08 15:28:42 +00001176};
1177
Craig Topper318ed7c2013-07-01 04:03:19 +00001178} // end anonymous namespace
1179
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001180void
1181TokenAnnotator::setCommentLineLevels(SmallVectorImpl<AnnotatedLine *> &Lines) {
Craig Topper2145bc02014-05-09 08:15:10 +00001182 const AnnotatedLine *NextNonCommentLine = nullptr;
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001183 for (SmallVectorImpl<AnnotatedLine *>::reverse_iterator I = Lines.rbegin(),
1184 E = Lines.rend();
1185 I != E; ++I) {
1186 if (NextNonCommentLine && (*I)->First->is(tok::comment) &&
Craig Topper2145bc02014-05-09 08:15:10 +00001187 (*I)->First->Next == nullptr)
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001188 (*I)->Level = NextNonCommentLine->Level;
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001189 else
Craig Topper2145bc02014-05-09 08:15:10 +00001190 NextNonCommentLine = (*I)->First->isNot(tok::r_brace) ? (*I) : nullptr;
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001191
1192 setCommentLineLevels((*I)->Children);
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001193 }
1194}
1195
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001196void TokenAnnotator::annotate(AnnotatedLine &Line) {
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001197 for (SmallVectorImpl<AnnotatedLine *>::iterator I = Line.Children.begin(),
1198 E = Line.Children.end();
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001199 I != E; ++I) {
1200 annotate(**I);
1201 }
Daniel Jasper8de9ed02013-08-22 15:00:41 +00001202 AnnotatingParser Parser(Style, Line, Ident_in);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001203 Line.Type = Parser.parseLine();
1204 if (Line.Type == LT_Invalid)
1205 return;
1206
Daniel Jasper400adc62013-02-08 15:28:42 +00001207 ExpressionParser ExprParser(Line);
1208 ExprParser.parse();
1209
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001210 if (Line.First->Type == TT_ObjCMethodSpecifier)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001211 Line.Type = LT_ObjCMethodDecl;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001212 else if (Line.First->Type == TT_ObjCDecl)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001213 Line.Type = LT_ObjCDecl;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001214 else if (Line.First->Type == TT_ObjCProperty)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001215 Line.Type = LT_ObjCProperty;
1216
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001217 Line.First->SpacesRequiredBefore = 1;
1218 Line.First->CanBreakBefore = Line.First->MustBreakBefore;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001219}
1220
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001221// This function heuristically determines whether 'Current' starts the name of a
1222// function declaration.
1223static bool isFunctionDeclarationName(const FormatToken &Current) {
1224 if (Current.Type != TT_StartOfName ||
1225 Current.NestingLevel != 0 ||
1226 Current.Previous->Type == TT_StartOfName)
1227 return false;
1228 const FormatToken *Next = Current.Next;
1229 for (; Next; Next = Next->Next) {
1230 if (Next->Type == TT_TemplateOpener) {
1231 Next = Next->MatchingParen;
1232 } else if (Next->is(tok::coloncolon)) {
1233 Next = Next->Next;
1234 if (!Next || !Next->is(tok::identifier))
1235 return false;
1236 } else if (Next->is(tok::l_paren)) {
1237 break;
1238 } else {
1239 return false;
1240 }
1241 }
1242 if (!Next)
1243 return false;
1244 assert(Next->is(tok::l_paren));
1245 if (Next->Next == Next->MatchingParen)
1246 return true;
1247 for (const FormatToken *Tok = Next->Next; Tok != Next->MatchingParen;
1248 Tok = Tok->Next) {
1249 if (Tok->is(tok::kw_const) || Tok->isSimpleTypeSpecifier() ||
1250 Tok->Type == TT_PointerOrReference || Tok->Type == TT_StartOfName)
1251 return true;
1252 if (Tok->isOneOf(tok::l_brace, tok::string_literal) || Tok->Tok.isLiteral())
1253 return false;
1254 }
1255 return false;
1256}
1257
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001258void TokenAnnotator::calculateFormattingInformation(AnnotatedLine &Line) {
Daniel Jasper5f3ea472014-05-22 08:36:53 +00001259 for (SmallVectorImpl<AnnotatedLine *>::iterator I = Line.Children.begin(),
1260 E = Line.Children.end();
1261 I != E; ++I) {
1262 calculateFormattingInformation(**I);
1263 }
1264
Alexander Kornienko39856b72013-09-10 09:38:25 +00001265 Line.First->TotalLength =
1266 Line.First->IsMultiline ? Style.ColumnLimit : Line.First->ColumnWidth;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001267 if (!Line.First->Next)
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001268 return;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001269 FormatToken *Current = Line.First->Next;
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001270 bool InFunctionDecl = Line.MightBeFunctionDecl;
Craig Topper2145bc02014-05-09 08:15:10 +00001271 while (Current) {
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001272 if (isFunctionDeclarationName(*Current))
1273 Current->Type = TT_FunctionDeclarationName;
Daniel Jasper5a611392013-12-19 21:41:37 +00001274 if (Current->Type == TT_LineComment) {
Daniel Jasper84a12e12014-03-10 15:06:25 +00001275 if (Current->Previous->BlockKind == BK_BracedInit &&
1276 Current->Previous->opensScope())
Daniel Jasper5a611392013-12-19 21:41:37 +00001277 Current->SpacesRequiredBefore = Style.Cpp11BracedListStyle ? 0 : 1;
1278 else
1279 Current->SpacesRequiredBefore = Style.SpacesBeforeTrailingComments;
Daniel Jasper14e58e52014-03-21 11:58:45 +00001280
1281 // If we find a trailing comment, iterate backwards to determine whether
1282 // it seems to relate to a specific parameter. If so, break before that
1283 // parameter to avoid changing the comment's meaning. E.g. don't move 'b'
1284 // to the previous line in:
1285 // SomeFunction(a,
1286 // b, // comment
1287 // c);
Daniel Jasper28df0a32014-03-21 12:15:40 +00001288 if (!Current->HasUnescapedNewline) {
Daniel Jasper14e58e52014-03-21 11:58:45 +00001289 for (FormatToken *Parameter = Current->Previous; Parameter;
1290 Parameter = Parameter->Previous) {
1291 if (Parameter->isOneOf(tok::comment, tok::r_brace))
1292 break;
1293 if (Parameter->Previous && Parameter->Previous->is(tok::comma)) {
1294 if (Parameter->Previous->Type != TT_CtorInitializerComma &&
1295 Parameter->HasUnescapedNewline)
1296 Parameter->MustBreakBefore = true;
1297 break;
1298 }
1299 }
1300 }
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001301 } else if (Current->SpacesRequiredBefore == 0 &&
Daniel Jasper166c19b2014-05-06 14:12:21 +00001302 spaceRequiredBefore(Line, *Current)) {
Alexander Kornienko384b40b2013-10-11 21:43:05 +00001303 Current->SpacesRequiredBefore = 1;
Daniel Jasper5a611392013-12-19 21:41:37 +00001304 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001305
Daniel Jasperfb81b092013-09-17 09:52:48 +00001306 Current->MustBreakBefore =
1307 Current->MustBreakBefore || mustBreakBefore(Line, *Current);
1308
Daniel Jasperca4ea1c2014-08-05 12:16:31 +00001309 if (Style.AlwaysBreakAfterDefinitionReturnType &&
1310 InFunctionDecl && Current->Type == TT_FunctionDeclarationName &&
Daniel Jasperdb764792014-08-14 11:36:03 +00001311 !Line.Last->isOneOf(tok::semi, tok::comment)) // Only for definitions.
1312 // FIXME: Line.Last points to other characters than tok::semi
1313 // and tok::lbrace.
Daniel Jasperca4ea1c2014-08-05 12:16:31 +00001314 Current->MustBreakBefore = true;
1315
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001316 Current->CanBreakBefore =
1317 Current->MustBreakBefore || canBreakBefore(Line, *Current);
Daniel Jasper5f3ea472014-05-22 08:36:53 +00001318 unsigned ChildSize = 0;
1319 if (Current->Previous->Children.size() == 1) {
1320 FormatToken &LastOfChild = *Current->Previous->Children[0]->Last;
1321 ChildSize = LastOfChild.isTrailingComment() ? Style.ColumnLimit
1322 : LastOfChild.TotalLength + 1;
1323 }
1324 if (Current->MustBreakBefore || Current->Previous->Children.size() > 1 ||
Alexander Kornienko39856b72013-09-10 09:38:25 +00001325 Current->IsMultiline)
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001326 Current->TotalLength = Current->Previous->TotalLength + Style.ColumnLimit;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001327 else
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +00001328 Current->TotalLength = Current->Previous->TotalLength +
Daniel Jasper5f3ea472014-05-22 08:36:53 +00001329 Current->ColumnWidth + ChildSize +
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +00001330 Current->SpacesRequiredBefore;
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001331
1332 if (Current->Type == TT_CtorInitializerColon)
1333 InFunctionDecl = false;
1334
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001335 // FIXME: Only calculate this if CanBreakBefore is true once static
1336 // initializers etc. are sorted out.
1337 // FIXME: Move magic numbers to a better place.
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001338 Current->SplitPenalty = 20 * Current->BindingStrength +
1339 splitPenalty(Line, *Current, InFunctionDecl);
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001340
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001341 Current = Current->Next;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001342 }
Daniel Jasper6bee6822013-04-08 20:33:42 +00001343
Manuel Klimek4fe43002013-05-22 12:51:29 +00001344 calculateUnbreakableTailLengths(Line);
Craig Topper2145bc02014-05-09 08:15:10 +00001345 for (Current = Line.First; Current != nullptr; Current = Current->Next) {
Daniel Jasper8de9ed02013-08-22 15:00:41 +00001346 if (Current->Role)
1347 Current->Role->precomputeFormattingInfos(Current);
1348 }
1349
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001350 DEBUG({ printDebugInfo(Line); });
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001351}
1352
Manuel Klimek4fe43002013-05-22 12:51:29 +00001353void TokenAnnotator::calculateUnbreakableTailLengths(AnnotatedLine &Line) {
1354 unsigned UnbreakableTailLength = 0;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001355 FormatToken *Current = Line.Last;
Craig Topper2145bc02014-05-09 08:15:10 +00001356 while (Current) {
Manuel Klimek4fe43002013-05-22 12:51:29 +00001357 Current->UnbreakableTailLength = UnbreakableTailLength;
1358 if (Current->CanBreakBefore ||
1359 Current->isOneOf(tok::comment, tok::string_literal)) {
1360 UnbreakableTailLength = 0;
1361 } else {
1362 UnbreakableTailLength +=
Alexander Kornienko39856b72013-09-10 09:38:25 +00001363 Current->ColumnWidth + Current->SpacesRequiredBefore;
Manuel Klimek4fe43002013-05-22 12:51:29 +00001364 }
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001365 Current = Current->Previous;
Manuel Klimek4fe43002013-05-22 12:51:29 +00001366 }
1367}
1368
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001369unsigned TokenAnnotator::splitPenalty(const AnnotatedLine &Line,
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001370 const FormatToken &Tok,
1371 bool InFunctionDecl) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001372 const FormatToken &Left = *Tok.Previous;
1373 const FormatToken &Right = Tok;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001374
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00001375 if (Left.is(tok::semi))
1376 return 0;
Daniel Jasper783bac62014-04-15 09:54:30 +00001377 if (Left.is(tok::comma) || (Right.is(tok::identifier) && Right.Next &&
1378 Right.Next->Type == TT_DictLiteral))
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00001379 return 1;
Daniel Jasper7052ce62014-01-19 09:04:08 +00001380 if (Right.is(tok::l_square)) {
1381 if (Style.Language == FormatStyle::LK_Proto)
1382 return 1;
Daniel Jaspera2fb50f2014-06-24 09:15:49 +00001383 if (Right.Type != TT_ObjCMethodExpr && Right.Type != TT_LambdaLSquare)
Daniel Jasperecaba172014-06-10 13:27:57 +00001384 return 500;
Daniel Jasper7052ce62014-01-19 09:04:08 +00001385 }
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001386 if (Right.Type == TT_StartOfName ||
1387 Right.Type == TT_FunctionDeclarationName || Right.is(tok::kw_operator)) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001388 if (Line.First->is(tok::kw_for) && Right.PartOfMultiVariableDeclStmt)
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001389 return 3;
Daniel Jasper40db06a2013-07-11 12:34:23 +00001390 if (Left.Type == TT_StartOfName)
1391 return 20;
Daniel Jasper63af7c42013-12-09 14:40:19 +00001392 if (InFunctionDecl && Right.NestingLevel == 0)
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001393 return Style.PenaltyReturnTypeOnItsOwnLine;
Daniel Jasper53643062013-08-19 10:16:18 +00001394 return 200;
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001395 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001396 if (Left.is(tok::equal) && Right.is(tok::l_brace))
1397 return 150;
Daniel Jasper1bc1b502013-07-05 07:58:34 +00001398 if (Left.Type == TT_CastRParen)
1399 return 100;
Daniel Jasper215d6c82014-01-22 08:04:52 +00001400 if (Left.is(tok::coloncolon) ||
1401 (Right.is(tok::period) && Style.Language == FormatStyle::LK_Proto))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001402 return 500;
Daniel Jasper83193602013-04-05 17:22:09 +00001403 if (Left.isOneOf(tok::kw_class, tok::kw_struct))
1404 return 5000;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001405
Daniel Jaspereead02b2013-02-14 08:42:54 +00001406 if (Left.Type == TT_RangeBasedForLoopColon ||
1407 Left.Type == TT_InheritanceColon)
Daniel Jasper16b35622013-02-26 13:18:08 +00001408 return 2;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001409
Daniel Jasper4c6e0052013-08-27 14:24:43 +00001410 if (Right.isMemberAccess()) {
Daniel Jasper4d7a97a2014-01-10 08:40:17 +00001411 if (Left.is(tok::r_paren) && Left.MatchingParen &&
Daniel Jasper36c28ce2013-09-06 08:54:24 +00001412 Left.MatchingParen->ParameterCount > 0)
Daniel Jasper70bc8742013-02-26 13:59:14 +00001413 return 20; // Should be smaller than breaking at a nested comma.
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001414 return 150;
1415 }
1416
Daniel Jaspere3f907f2014-06-02 09:52:08 +00001417 if (Right.Type == TT_TrailingAnnotation &&
1418 (!Right.Next || Right.Next->isNot(tok::l_paren))) {
Daniel Jasper5550de62014-02-17 07:57:46 +00001419 // Generally, breaking before a trailing annotation is bad unless it is
1420 // function-like. It seems to be especially preferable to keep standard
1421 // annotations (i.e. "const", "final" and "override") on the same line.
Daniel Jasper43e6a282013-12-16 15:01:54 +00001422 // Use a slightly higher penalty after ")" so that annotations like
1423 // "const override" are kept together.
Daniel Jasperb48d3af2014-04-09 10:01:49 +00001424 bool is_short_annotation = Right.TokenText.size() < 10;
Daniel Jasperb05a81d2014-05-09 13:11:16 +00001425 return (Left.is(tok::r_paren) ? 100 : 120) + (is_short_annotation ? 50 : 0);
Daniel Jasper43e6a282013-12-16 15:01:54 +00001426 }
Daniel Jasper13c37b32013-05-22 08:28:26 +00001427
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001428 // In for-loops, prefer breaking at ',' and ';'.
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001429 if (Line.First->is(tok::kw_for) && Left.is(tok::equal))
Daniel Jasper37905f72013-02-21 15:00:29 +00001430 return 4;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001431
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001432 // In Objective-C method expressions, prefer breaking before "param:" over
1433 // breaking after it.
Daniel Jasper17062ff2014-06-10 14:44:02 +00001434 if (Right.Type == TT_SelectorName)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001435 return 0;
Daniel Jasper1ac3e052013-02-05 10:07:47 +00001436 if (Left.is(tok::colon) && Left.Type == TT_ObjCMethodExpr)
Daniel Jasper4bf0d802013-11-23 14:27:27 +00001437 return Line.MightBeFunctionDecl ? 50 : 500;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001438
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001439 if (Left.is(tok::l_paren) && InFunctionDecl)
Daniel Jasper6728fc12013-04-11 14:29:13 +00001440 return 100;
Daniel Jasper126153a2013-12-27 06:39:56 +00001441 if (Left.is(tok::equal) && InFunctionDecl)
1442 return 110;
Daniel Jaspera5621202014-08-08 12:00:13 +00001443 if (Right.is(tok::r_brace))
1444 return 1;
Daniel Jasperea79ea12014-08-15 05:00:39 +00001445 if (Left.Type == TT_TemplateOpener)
1446 return 100;
Daniel Jasperc04baae2013-04-10 09:49:49 +00001447 if (Left.opensScope())
Daniel Jasper33b909c2013-10-25 14:29:37 +00001448 return Left.ParameterCount > 1 ? Style.PenaltyBreakBeforeFirstCallParameter
1449 : 19;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001450
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001451 if (Right.is(tok::lessless)) {
1452 if (Left.is(tok::string_literal)) {
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001453 StringRef Content = Left.TokenText;
Daniel Jasper0b1f76b2013-09-29 12:02:57 +00001454 if (Content.startswith("\""))
1455 Content = Content.drop_front(1);
1456 if (Content.endswith("\""))
1457 Content = Content.drop_back(1);
1458 Content = Content.trim();
Daniel Jasperf38a0ac2013-03-14 14:00:17 +00001459 if (Content.size() > 1 &&
1460 (Content.back() == ':' || Content.back() == '='))
Daniel Jasperfa21c072013-07-15 14:33:14 +00001461 return 25;
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001462 }
Daniel Jasper49a94482013-07-15 15:04:42 +00001463 return 1; // Breaking at a << is really cheap.
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001464 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001465 if (Left.Type == TT_ConditionalExpr)
Daniel Jasper70bc8742013-02-26 13:59:14 +00001466 return prec::Conditional;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001467 prec::Level Level = Left.getPrecedence();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001468
1469 if (Level != prec::Unknown)
1470 return Level;
Daniel Jasperf9a84b52013-03-01 16:48:32 +00001471
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001472 return 3;
1473}
1474
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001475bool TokenAnnotator::spaceRequiredBetween(const AnnotatedLine &Line,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001476 const FormatToken &Left,
1477 const FormatToken &Right) {
Daniel Jasper7052ce62014-01-19 09:04:08 +00001478 if (Style.Language == FormatStyle::LK_Proto) {
Daniel Jasper9c2820c2014-06-23 07:36:25 +00001479 if (Right.is(tok::period) &&
1480 (Left.TokenText == "optional" || Left.TokenText == "required" ||
1481 Left.TokenText == "repeated"))
1482 return true;
Daniel Jasper929b1db2014-01-20 16:47:22 +00001483 if (Right.is(tok::l_paren) &&
1484 (Left.TokenText == "returns" || Left.TokenText == "option"))
Daniel Jasper7052ce62014-01-19 09:04:08 +00001485 return true;
Daniel Jasper0dd52912014-05-19 07:37:07 +00001486 } else if (Style.Language == FormatStyle::LK_JavaScript) {
1487 if (Left.TokenText == "var")
1488 return true;
Daniel Jasper7052ce62014-01-19 09:04:08 +00001489 }
Daniel Jasper166c19b2014-05-06 14:12:21 +00001490 if (Left.is(tok::kw_return) && Right.isNot(tok::semi))
1491 return true;
Daniel Jaspere9beea22014-01-28 15:20:33 +00001492 if (Style.ObjCSpaceAfterProperty && Line.Type == LT_ObjCProperty &&
1493 Left.Tok.getObjCKeywordID() == tok::objc_property)
1494 return true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001495 if (Right.is(tok::hashhash))
1496 return Left.is(tok::hash);
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001497 if (Left.isOneOf(tok::hashhash, tok::hash))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001498 return Right.is(tok::hash);
Daniel Jasperb55acad2013-08-20 12:36:34 +00001499 if (Left.is(tok::l_paren) && Right.is(tok::r_paren))
1500 return Style.SpaceInEmptyParentheses;
1501 if (Left.is(tok::l_paren) || Right.is(tok::r_paren))
Daniel Jasperf110e202013-08-21 08:39:01 +00001502 return (Right.Type == TT_CastRParen ||
1503 (Left.MatchingParen && Left.MatchingParen->Type == TT_CastRParen))
Daniel Jasperb55acad2013-08-20 12:36:34 +00001504 ? Style.SpacesInCStyleCastParentheses
1505 : Style.SpacesInParentheses;
Daniel Jasperdd978ae2013-10-29 14:52:02 +00001506 if (Style.SpacesInAngles &&
1507 ((Left.Type == TT_TemplateOpener) != (Right.Type == TT_TemplateCloser)))
1508 return true;
Daniel Jasperb55acad2013-08-20 12:36:34 +00001509 if (Right.isOneOf(tok::semi, tok::comma))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001510 return false;
1511 if (Right.is(tok::less) &&
Daniel Jasperdcf37fb2014-08-01 13:03:05 +00001512 (Left.isOneOf(tok::kw_template, tok::r_paren) ||
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001513 (Line.Type == LT_ObjCDecl && Style.ObjCSpaceBeforeProtocolList)))
1514 return true;
1515 if (Left.is(tok::arrow) || Right.is(tok::arrow))
1516 return false;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001517 if (Left.isOneOf(tok::exclaim, tok::tilde))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001518 return false;
1519 if (Left.is(tok::at) &&
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001520 Right.isOneOf(tok::identifier, tok::string_literal, tok::char_constant,
1521 tok::numeric_constant, tok::l_paren, tok::l_brace,
1522 tok::kw_true, tok::kw_false))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001523 return false;
1524 if (Left.is(tok::coloncolon))
1525 return false;
Daniel Jasper7620b662014-01-08 15:41:13 +00001526 if (Right.is(tok::coloncolon) && Left.isNot(tok::l_brace))
Daniel Jasperfba84ff2013-10-12 05:16:06 +00001527 return (Left.is(tok::less) && Style.Standard == FormatStyle::LS_Cpp03) ||
1528 !Left.isOneOf(tok::identifier, tok::greater, tok::l_paren,
1529 tok::r_paren, tok::less);
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001530 if (Left.is(tok::less) || Right.isOneOf(tok::greater, tok::less))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001531 return false;
Daniel Jasperbafa6b72013-07-01 09:47:25 +00001532 if (Right.is(tok::ellipsis))
Daniel Jasper2d0cd492013-10-20 16:56:16 +00001533 return Left.Tok.isLiteral();
Manuel Klimekbab25fd2013-09-04 08:20:47 +00001534 if (Left.is(tok::l_square) && Right.is(tok::amp))
1535 return false;
Alexander Kornienkoa5151272013-03-12 16:28:18 +00001536 if (Right.Type == TT_PointerOrReference)
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001537 return Left.Tok.isLiteral() ||
Alexander Kornienkoa5151272013-03-12 16:28:18 +00001538 ((Left.Type != TT_PointerOrReference) && Left.isNot(tok::l_paren) &&
Daniel Jasper553d4872014-06-17 12:40:34 +00001539 Style.PointerAlignment != FormatStyle::PAS_Left);
Daniel Jasper4d03d3b2013-05-28 15:27:10 +00001540 if (Right.Type == TT_FunctionTypeLParen && Left.isNot(tok::l_paren) &&
Daniel Jasperdcf37fb2014-08-01 13:03:05 +00001541 (Left.Type != TT_PointerOrReference ||
1542 Style.PointerAlignment != FormatStyle::PAS_Right))
Daniel Jaspercfda5172013-05-08 14:58:20 +00001543 return true;
Alexander Kornienkoa5151272013-03-12 16:28:18 +00001544 if (Left.Type == TT_PointerOrReference)
Daniel Jasper022612d2013-07-01 09:34:09 +00001545 return Right.Tok.isLiteral() || Right.Type == TT_BlockComment ||
Daniel Jasperb8914dd2013-03-20 09:53:18 +00001546 ((Right.Type != TT_PointerOrReference) &&
Daniel Jasperdcf37fb2014-08-01 13:03:05 +00001547 Right.isNot(tok::l_paren) &&
1548 Style.PointerAlignment != FormatStyle::PAS_Right && Left.Previous &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001549 !Left.Previous->isOneOf(tok::l_paren, tok::coloncolon));
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001550 if (Right.is(tok::star) && Left.is(tok::l_paren))
1551 return false;
Nico Weber2a726b62013-02-10 02:08:05 +00001552 if (Left.is(tok::l_square))
Daniel Jasper1db6c382013-10-22 15:30:28 +00001553 return Left.Type == TT_ArrayInitializerLSquare &&
Daniel Jasperb2e10a52014-01-15 15:09:08 +00001554 Style.SpacesInContainerLiterals && Right.isNot(tok::r_square);
Nico Weber2a726b62013-02-10 02:08:05 +00001555 if (Right.is(tok::r_square))
Daniel Jasperb2e10a52014-01-15 15:09:08 +00001556 return Right.MatchingParen && Style.SpacesInContainerLiterals &&
Daniel Jasper1db6c382013-10-22 15:30:28 +00001557 Right.MatchingParen->Type == TT_ArrayInitializerLSquare;
Daniel Jasper8ddfa842013-08-30 10:36:58 +00001558 if (Right.is(tok::l_square) && Right.Type != TT_ObjCMethodExpr &&
Daniel Jasper89519082014-05-09 10:26:08 +00001559 Right.Type != TT_LambdaLSquare && Left.isNot(tok::numeric_constant) &&
1560 Left.Type != TT_DictLiteral)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001561 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001562 if (Left.is(tok::colon))
1563 return Left.Type != TT_ObjCMethodExpr;
Daniel Jasper484033b2014-05-06 14:41:29 +00001564 if (Left.Type == TT_BlockComment)
1565 return !Left.TokenText.endswith("=*/");
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001566 if (Right.is(tok::l_paren)) {
Daniel Jasper559b63c2014-01-28 20:13:43 +00001567 if (Left.is(tok::r_paren) && Left.Type == TT_AttributeParen)
Daniel Jasperee6d6502013-07-17 20:25:02 +00001568 return true;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001569 return Line.Type == LT_ObjCDecl ||
Daniel Jasper166c19b2014-05-06 14:12:21 +00001570 Left.isOneOf(tok::kw_new, tok::kw_delete, tok::semi) ||
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00001571 (Style.SpaceBeforeParens != FormatStyle::SBPO_Never &&
Daniel Jaspere1e43192014-04-01 12:55:11 +00001572 (Left.isOneOf(tok::kw_if, tok::kw_for, tok::kw_while,
Daniel Jasper031e2402014-04-28 07:48:36 +00001573 tok::kw_switch, tok::kw_catch, tok::kw_case) ||
Daniel Jaspere1e43192014-04-01 12:55:11 +00001574 Left.IsForEachMacro)) ||
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00001575 (Style.SpaceBeforeParens == FormatStyle::SBPO_Always &&
Daniel Jasper78b194992014-08-06 14:15:41 +00001576 (Left.is(tok::identifier) || Left.isFunctionLikeKeyword()) &&
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00001577 Line.Type != LT_PreprocessorDirective);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001578 }
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001579 if (Left.is(tok::at) && Right.Tok.getObjCKeywordID() != tok::objc_not_keyword)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001580 return false;
1581 if (Left.is(tok::l_brace) && Right.is(tok::r_brace))
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001582 return !Left.Children.empty(); // No spaces in "{}".
Daniel Jasper1a148b42014-01-05 13:23:23 +00001583 if ((Left.is(tok::l_brace) && Left.BlockKind != BK_Block) ||
1584 (Right.is(tok::r_brace) && Right.MatchingParen &&
1585 Right.MatchingParen->BlockKind != BK_Block))
Daniel Jasper6ab54682013-07-16 18:22:10 +00001586 return !Style.Cpp11BracedListStyle;
Daniel Jasper5bd0b9e2013-05-23 18:05:18 +00001587 if (Right.Type == TT_UnaryOperator)
1588 return !Left.isOneOf(tok::l_paren, tok::l_square, tok::at) &&
1589 (Left.isNot(tok::colon) || Left.Type != TT_ObjCMethodExpr);
Daniel Jasper4afc6b32014-06-02 10:57:55 +00001590 if ((Left.isOneOf(tok::identifier, tok::greater, tok::r_square,
1591 tok::r_paren) ||
Daniel Jasper7a2d60e2014-05-07 07:59:03 +00001592 Left.isSimpleTypeSpecifier()) &&
Manuel Klimekbab25fd2013-09-04 08:20:47 +00001593 Right.is(tok::l_brace) && Right.getNextNonComment() &&
1594 Right.BlockKind != BK_Block)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001595 return false;
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00001596 if (Left.is(tok::period) || Right.is(tok::period))
1597 return false;
Alexander Kornienkod8d47fa2013-09-10 13:41:43 +00001598 if (Right.is(tok::hash) && Left.is(tok::identifier) && Left.TokenText == "L")
1599 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001600 return true;
1601}
1602
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001603bool TokenAnnotator::spaceRequiredBefore(const AnnotatedLine &Line,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001604 const FormatToken &Tok) {
1605 if (Tok.Tok.getIdentifierInfo() && Tok.Previous->Tok.getIdentifierInfo())
Daniel Jasper35d2dc72013-02-11 08:01:18 +00001606 return true; // Never ever merge two identifiers.
Daniel Jasper877615c2013-10-11 19:45:02 +00001607 if (Tok.Previous->Type == TT_ImplicitStringLiteral)
1608 return Tok.WhitespaceRange.getBegin() != Tok.WhitespaceRange.getEnd();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001609 if (Line.Type == LT_ObjCMethodDecl) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001610 if (Tok.Previous->Type == TT_ObjCMethodSpecifier)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001611 return true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001612 if (Tok.Previous->is(tok::r_paren) && Tok.is(tok::identifier))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001613 // Don't space between ')' and <id>
1614 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001615 }
1616 if (Line.Type == LT_ObjCProperty &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001617 (Tok.is(tok::equal) || Tok.Previous->is(tok::equal)))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001618 return false;
1619
Daniel Jasper6cdec7c2013-07-09 14:36:48 +00001620 if (Tok.Type == TT_TrailingReturnArrow ||
1621 Tok.Previous->Type == TT_TrailingReturnArrow)
1622 return true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001623 if (Tok.Previous->is(tok::comma))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001624 return true;
Daniel Jasperff6c3a92013-02-28 13:40:17 +00001625 if (Tok.is(tok::comma))
1626 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001627 if (Tok.Type == TT_CtorInitializerColon || Tok.Type == TT_ObjCBlockLParen)
1628 return true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001629 if (Tok.Previous->Tok.is(tok::kw_operator))
Daniel Jasperedc5f092013-10-29 12:24:23 +00001630 return Tok.is(tok::coloncolon);
Daniel Jasper35d2dc72013-02-11 08:01:18 +00001631 if (Tok.Type == TT_OverloadedOperatorLParen)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001632 return false;
1633 if (Tok.is(tok::colon))
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001634 return !Line.First->isOneOf(tok::kw_case, tok::kw_default) &&
Daniel Jasperb05a81d2014-05-09 13:11:16 +00001635 Tok.getNextNonComment() && Tok.Type != TT_ObjCMethodExpr &&
1636 !Tok.Previous->is(tok::question) &&
Daniel Jasperb2e10a52014-01-15 15:09:08 +00001637 (Tok.Type != TT_DictLiteral || Style.SpacesInContainerLiterals);
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001638 if (Tok.Previous->Type == TT_UnaryOperator ||
1639 Tok.Previous->Type == TT_CastRParen)
Daniel Jasperff974ab2014-01-25 09:16:02 +00001640 return Tok.Type == TT_BinaryOperator;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001641 if (Tok.Previous->is(tok::greater) && Tok.is(tok::greater)) {
Daniel Jasper400adc62013-02-08 15:28:42 +00001642 return Tok.Type == TT_TemplateCloser &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001643 Tok.Previous->Type == TT_TemplateCloser &&
Daniel Jasperdd978ae2013-10-29 14:52:02 +00001644 (Style.Standard != FormatStyle::LS_Cpp11 || Style.SpacesInAngles);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001645 }
Alexander Kornienko674be0a2013-03-20 16:41:56 +00001646 if (Tok.isOneOf(tok::arrowstar, tok::periodstar) ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001647 Tok.Previous->isOneOf(tok::arrowstar, tok::periodstar))
Daniel Jasperff6c3a92013-02-28 13:40:17 +00001648 return false;
Daniel Jasperd94bff32013-09-25 15:15:02 +00001649 if (!Style.SpaceBeforeAssignmentOperators &&
1650 Tok.getPrecedence() == prec::Assignment)
1651 return false;
Daniel Jasper9613c812013-08-07 16:29:23 +00001652 if ((Tok.Type == TT_BinaryOperator && !Tok.Previous->is(tok::l_paren)) ||
Daniel Jasperc0d606a2014-04-14 11:08:45 +00001653 Tok.Previous->Type == TT_BinaryOperator ||
1654 Tok.Previous->Type == TT_ConditionalExpr)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001655 return true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001656 if (Tok.Previous->Type == TT_TemplateCloser && Tok.is(tok::l_paren))
Chad Rosier0a84f172014-08-05 17:58:54 +00001657 return Style.SpaceBeforeParens == FormatStyle::SBPO_Always;
Daniel Jaspered8f1c62013-08-28 08:24:04 +00001658 if (Tok.is(tok::less) && Tok.Previous->isNot(tok::l_paren) &&
1659 Line.First->is(tok::hash))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001660 return true;
1661 if (Tok.Type == TT_TrailingUnaryOperator)
1662 return false;
Daniel Jasperf9ae3122014-05-08 07:01:45 +00001663 if (Tok.Previous->Type == TT_RegexLiteral)
1664 return false;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001665 return spaceRequiredBetween(Line, *Tok.Previous, Tok);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001666}
1667
Daniel Jaspere18ff372014-06-02 10:17:32 +00001668// Returns 'true' if 'Tok' is a brace we'd want to break before in Allman style.
1669static bool isAllmanBrace(const FormatToken &Tok) {
1670 return Tok.is(tok::l_brace) && Tok.BlockKind == BK_Block &&
1671 Tok.Type != TT_ObjCBlockLBrace && Tok.Type != TT_DictLiteral;
1672}
1673
Daniel Jasperfb81b092013-09-17 09:52:48 +00001674bool TokenAnnotator::mustBreakBefore(const AnnotatedLine &Line,
1675 const FormatToken &Right) {
Daniel Jaspera125d532014-03-21 12:38:57 +00001676 const FormatToken &Left = *Right.Previous;
Daniel Jaspera69ca9b2014-06-04 12:40:57 +00001677 if (Right.NewlinesBefore > 1)
1678 return true;
Daniel Jasperfb81b092013-09-17 09:52:48 +00001679 if (Right.is(tok::comment)) {
Daniel Jasper5a611392013-12-19 21:41:37 +00001680 return Right.Previous->BlockKind != BK_BracedInit &&
Daniel Jasperf6c7c182014-01-13 14:10:04 +00001681 Right.Previous->Type != TT_CtorInitializerColon &&
Manuel Klimek1fcbe672014-04-11 12:27:47 +00001682 (Right.NewlinesBefore > 0 && Right.HasUnescapedNewline);
Daniel Jasperfb81b092013-09-17 09:52:48 +00001683 } else if (Right.Previous->isTrailingComment() ||
Daniel Jasper04b6a082013-12-20 06:22:01 +00001684 (Right.isStringLiteral() && Right.Previous->isStringLiteral())) {
Daniel Jasperfb81b092013-09-17 09:52:48 +00001685 return true;
1686 } else if (Right.Previous->IsUnterminatedLiteral) {
1687 return true;
1688 } else if (Right.is(tok::lessless) && Right.Next &&
1689 Right.Previous->is(tok::string_literal) &&
1690 Right.Next->is(tok::string_literal)) {
1691 return true;
1692 } else if (Right.Previous->ClosesTemplateDeclaration &&
1693 Right.Previous->MatchingParen &&
Daniel Jasper63af7c42013-12-09 14:40:19 +00001694 Right.Previous->MatchingParen->NestingLevel == 0 &&
Daniel Jasperfb81b092013-09-17 09:52:48 +00001695 Style.AlwaysBreakTemplateDeclarations) {
Daniel Jasperfb81b092013-09-17 09:52:48 +00001696 return true;
Alexander Kornienkoa594ba82013-12-16 14:35:51 +00001697 } else if ((Right.Type == TT_CtorInitializerComma ||
1698 Right.Type == TT_CtorInitializerColon) &&
Daniel Jasperec01cd62013-10-08 05:11:18 +00001699 Style.BreakConstructorInitializersBeforeComma &&
1700 !Style.ConstructorInitializerAllOnOneLineOrOnePerLine) {
Daniel Jasperfb81b092013-09-17 09:52:48 +00001701 return true;
Daniel Jasperc39b56f2013-12-16 07:23:08 +00001702 } else if (Right.is(tok::string_literal) &&
1703 Right.TokenText.startswith("R\"")) {
1704 // Raw string literals are special wrt. line breaks. The author has made a
1705 // deliberate choice and might have aligned the contents of the string
1706 // literal accordingly. Thus, we try keep existing line breaks.
1707 return Right.NewlinesBefore > 0;
Daniel Jasper6e58fee2014-01-29 18:43:40 +00001708 } else if (Right.Previous->is(tok::l_brace) && Right.NestingLevel == 1 &&
Daniel Jasper7052ce62014-01-19 09:04:08 +00001709 Style.Language == FormatStyle::LK_Proto) {
1710 // Don't enums onto single lines in protocol buffers.
1711 return true;
Daniel Jaspere18ff372014-06-02 10:17:32 +00001712 } else if (isAllmanBrace(Left) || isAllmanBrace(Right)) {
1713 return Style.BreakBeforeBraces == FormatStyle::BS_Allman ||
1714 Style.BreakBeforeBraces == FormatStyle::BS_GNU;
Daniel Jaspera382cbe2014-07-28 14:08:09 +00001715 } else if (Style.Language == FormatStyle::LK_Proto &&
1716 Left.isNot(tok::l_brace) && Right.Type == TT_SelectorName) {
1717 return true;
Daniel Jasperfb81b092013-09-17 09:52:48 +00001718 }
Daniel Jasperb175d572014-04-09 09:53:23 +00001719
Daniel Jasperf9fc2152014-04-09 13:18:49 +00001720 // If the last token before a '}' is a comma or a comment, the intention is to
1721 // insert a line break after it in order to make shuffling around entries
1722 // easier.
Daniel Jasperb175d572014-04-09 09:53:23 +00001723 const FormatToken *BeforeClosingBrace = nullptr;
1724 if (Left.is(tok::l_brace) && Left.MatchingParen)
Daniel Jasperf9fc2152014-04-09 13:18:49 +00001725 BeforeClosingBrace = Left.MatchingParen->Previous;
Daniel Jasperb175d572014-04-09 09:53:23 +00001726 else if (Right.is(tok::r_brace))
Daniel Jasperf9fc2152014-04-09 13:18:49 +00001727 BeforeClosingBrace = Right.Previous;
1728 if (BeforeClosingBrace &&
1729 BeforeClosingBrace->isOneOf(tok::comma, tok::comment))
Daniel Jasperb175d572014-04-09 09:53:23 +00001730 return true;
1731
Daniel Jasper49802ef2014-05-22 09:10:04 +00001732 if (Style.Language == FormatStyle::LK_JavaScript) {
1733 // FIXME: This might apply to other languages and token kinds.
1734 if (Right.is(tok::char_constant) && Left.is(tok::plus) && Left.Previous &&
1735 Left.Previous->is(tok::char_constant))
1736 return true;
1737 }
1738
Daniel Jasperfb81b092013-09-17 09:52:48 +00001739 return false;
1740}
1741
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001742bool TokenAnnotator::canBreakBefore(const AnnotatedLine &Line,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001743 const FormatToken &Right) {
1744 const FormatToken &Left = *Right.Previous;
Daniel Jasper4bf0d802013-11-23 14:27:27 +00001745 if (Left.is(tok::at))
1746 return false;
Daniel Jasper437c3f52014-04-28 07:34:48 +00001747 if (Left.Tok.getObjCKeywordID() == tok::objc_interface)
1748 return false;
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001749 if (Right.Type == TT_StartOfName ||
1750 Right.Type == TT_FunctionDeclarationName || Right.is(tok::kw_operator))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001751 return true;
Daniel Jasper165b29e2013-11-08 00:57:11 +00001752 if (Right.isTrailingComment())
1753 // We rely on MustBreakBefore being set correctly here as we should not
1754 // change the "binding" behavior of a comment.
Daniel Jasper5a611392013-12-19 21:41:37 +00001755 // The first comment in a braced lists is always interpreted as belonging to
1756 // the first list element. Otherwise, it should be placed outside of the
1757 // list.
1758 return Left.BlockKind == BK_BracedInit;
Daniel Jasper165b29e2013-11-08 00:57:11 +00001759 if (Left.is(tok::question) && Right.is(tok::colon))
1760 return false;
1761 if (Right.Type == TT_ConditionalExpr || Right.is(tok::question))
1762 return Style.BreakBeforeTernaryOperators;
1763 if (Left.Type == TT_ConditionalExpr || Left.is(tok::question))
1764 return !Style.BreakBeforeTernaryOperators;
Daniel Jasper3a122c02014-02-14 18:22:40 +00001765 if (Right.Type == TT_InheritanceColon)
1766 return true;
Daniel Jasperd39312ec2014-05-28 10:09:11 +00001767 if (Right.is(tok::colon) && (Right.Type != TT_CtorInitializerColon &&
1768 Right.Type != TT_InlineASMColon))
1769 return false;
Nico Weberced7d412013-05-26 05:39:26 +00001770 if (Left.is(tok::colon) &&
Daniel Jasperb596fb22013-10-24 10:31:50 +00001771 (Left.Type == TT_DictLiteral || Left.Type == TT_ObjCMethodExpr))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001772 return true;
Daniel Jasper17062ff2014-06-10 14:44:02 +00001773 if (Right.Type == TT_SelectorName)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001774 return true;
Daniel Jasper9688ff12013-08-01 13:46:58 +00001775 if (Left.is(tok::r_paren) && Line.Type == LT_ObjCProperty)
1776 return true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001777 if (Left.ClosesTemplateDeclaration)
1778 return true;
Daniel Jaspereead02b2013-02-14 08:42:54 +00001779 if (Right.Type == TT_RangeBasedForLoopColon ||
Daniel Jasperd215b8b2013-08-28 07:27:35 +00001780 Right.Type == TT_OverloadedOperatorLParen ||
1781 Right.Type == TT_OverloadedOperator)
Daniel Jaspereead02b2013-02-14 08:42:54 +00001782 return false;
Daniel Jaspera61aefb2013-05-06 06:45:09 +00001783 if (Left.Type == TT_RangeBasedForLoopColon)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001784 return true;
Daniel Jasper37905f72013-02-21 15:00:29 +00001785 if (Right.Type == TT_RangeBasedForLoopColon)
1786 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001787 if (Left.Type == TT_PointerOrReference || Left.Type == TT_TemplateCloser ||
Daniel Jasper165b29e2013-11-08 00:57:11 +00001788 Left.Type == TT_UnaryOperator || Left.is(tok::kw_operator))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001789 return false;
1790 if (Left.is(tok::equal) && Line.Type == LT_VirtualFunctionDecl)
1791 return false;
Daniel Jasper559b63c2014-01-28 20:13:43 +00001792 if (Left.is(tok::l_paren) && Left.Type == TT_AttributeParen)
1793 return false;
1794 if (Left.is(tok::l_paren) && Left.Previous &&
1795 (Left.Previous->Type == TT_BinaryOperator ||
Daniel Jasper8acf8222014-05-07 09:23:05 +00001796 Left.Previous->Type == TT_CastRParen || Left.Previous->is(tok::kw_if)))
Daniel Jasper559b63c2014-01-28 20:13:43 +00001797 return false;
Daniel Jasper98857842013-10-30 13:54:53 +00001798 if (Right.Type == TT_ImplicitStringLiteral)
1799 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001800
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001801 if (Right.is(tok::r_paren) || Right.Type == TT_TemplateCloser)
1802 return false;
1803
Daniel Jasper13c37b32013-05-22 08:28:26 +00001804 // We only break before r_brace if there was a corresponding break before
1805 // the l_brace, which is tracked by BreakBeforeClosingBrace.
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001806 if (Right.is(tok::r_brace))
1807 return Right.MatchingParen && Right.MatchingParen->BlockKind == BK_Block;
Daniel Jasper13c37b32013-05-22 08:28:26 +00001808
Daniel Jasperf9a09062014-04-09 10:29:11 +00001809 // Allow breaking after a trailing annotation, e.g. after a method
1810 // declaration.
1811 if (Left.Type == TT_TrailingAnnotation)
1812 return !Right.isOneOf(tok::l_brace, tok::semi, tok::equal, tok::l_paren,
1813 tok::less, tok::coloncolon);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001814
Daniel Jasperbf4755b2013-03-14 09:50:46 +00001815 if (Right.is(tok::kw___attribute))
1816 return true;
1817
Daniel Jasperaf5ba0e2013-02-23 07:46:38 +00001818 if (Left.is(tok::identifier) && Right.is(tok::string_literal))
1819 return true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +00001820
Daniel Jasper783bac62014-04-15 09:54:30 +00001821 if (Right.is(tok::identifier) && Right.Next &&
1822 Right.Next->Type == TT_DictLiteral)
1823 return true;
1824
Daniel Jaspere33d4af2013-07-26 16:56:36 +00001825 if (Left.Type == TT_CtorInitializerComma &&
1826 Style.BreakConstructorInitializersBeforeComma)
1827 return false;
Daniel Jasperec01cd62013-10-08 05:11:18 +00001828 if (Right.Type == TT_CtorInitializerComma &&
1829 Style.BreakConstructorInitializersBeforeComma)
1830 return true;
Daniel Jasper0de8efa2013-09-17 08:15:46 +00001831 if (Left.is(tok::greater) && Right.is(tok::greater) &&
1832 Left.Type != TT_TemplateCloser)
1833 return false;
Daniel Jasper0a1e5ac2014-05-13 08:01:47 +00001834 if (Right.Type == TT_BinaryOperator && Style.BreakBeforeBinaryOperators)
1835 return true;
Daniel Jasper1db6c382013-10-22 15:30:28 +00001836 if (Left.Type == TT_ArrayInitializerLSquare)
1837 return true;
Daniel Jasper598dd332014-08-12 13:22:26 +00001838 if (Right.is(tok::kw_typename) && Left.isNot(tok::kw_const))
1839 return true;
Daniel Jasper85bcadc2014-07-09 13:07:57 +00001840 return (Left.isBinaryOperator() &&
1841 !Left.isOneOf(tok::arrowstar, tok::lessless) &&
Daniel Jaspere33d4af2013-07-26 16:56:36 +00001842 !Style.BreakBeforeBinaryOperators) ||
Daniel Jasper83193602013-04-05 17:22:09 +00001843 Left.isOneOf(tok::comma, tok::coloncolon, tok::semi, tok::l_brace,
1844 tok::kw_class, tok::kw_struct) ||
Daniel Jasper85bcadc2014-07-09 13:07:57 +00001845 Right.isMemberAccess() ||
Daniel Jasper598dd332014-08-12 13:22:26 +00001846 Right.isOneOf(tok::lessless, tok::colon, tok::l_square, tok::at) ||
Daniel Jasper1bc1b502013-07-05 07:58:34 +00001847 (Left.is(tok::r_paren) &&
Daniel Jasper559b63c2014-01-28 20:13:43 +00001848 Right.isOneOf(tok::identifier, tok::kw_const)) ||
Daniel Jasper1db6c382013-10-22 15:30:28 +00001849 (Left.is(tok::l_paren) && !Right.is(tok::r_paren));
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001850}
1851
Daniel Jasper6bee6822013-04-08 20:33:42 +00001852void TokenAnnotator::printDebugInfo(const AnnotatedLine &Line) {
1853 llvm::errs() << "AnnotatedTokens:\n";
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001854 const FormatToken *Tok = Line.First;
Daniel Jasper6bee6822013-04-08 20:33:42 +00001855 while (Tok) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001856 llvm::errs() << " M=" << Tok->MustBreakBefore
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001857 << " C=" << Tok->CanBreakBefore << " T=" << Tok->Type
1858 << " S=" << Tok->SpacesRequiredBefore
Daniel Jasper17062ff2014-06-10 14:44:02 +00001859 << " B=" << Tok->BlockParameterCount
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001860 << " P=" << Tok->SplitPenalty << " Name=" << Tok->Tok.getName()
Manuel Klimek71814b42013-10-11 21:25:45 +00001861 << " L=" << Tok->TotalLength << " PPK=" << Tok->PackingKind
1862 << " FakeLParens=";
Daniel Jasper6bee6822013-04-08 20:33:42 +00001863 for (unsigned i = 0, e = Tok->FakeLParens.size(); i != e; ++i)
1864 llvm::errs() << Tok->FakeLParens[i] << "/";
1865 llvm::errs() << " FakeRParens=" << Tok->FakeRParens << "\n";
Daniel Jasperb05a81d2014-05-09 13:11:16 +00001866 if (!Tok->Next)
Manuel Klimek71814b42013-10-11 21:25:45 +00001867 assert(Tok == Line.Last);
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001868 Tok = Tok->Next;
Daniel Jasper6bee6822013-04-08 20:33:42 +00001869 }
1870 llvm::errs() << "----\n";
1871}
1872
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001873} // namespace format
1874} // namespace clang