blob: 8b62c97a9d5e7e737a1a22e5149ebe0a00d57a7e [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();
Daniel Jasper168c8aa2014-08-27 11:53:26 +0000316 if ((CurrentToken->is(tok::colon) ||
317 Style.Language == FormatStyle::LK_Proto) &&
318 Previous->is(tok::identifier))
Daniel Jasper497d9fd2014-08-15 05:00:35 +0000319 Previous->Type = TT_SelectorName;
320 if (CurrentToken->is(tok::colon))
321 Left->Type = TT_DictLiteral;
Daniel Jasper17062ff2014-06-10 14:44:02 +0000322 }
Daniel Jasper8e357692013-05-06 08:27:33 +0000323 if (!consumeToken())
324 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000325 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000326 }
327 return true;
328 }
Daniel Jasperdc7d5812013-02-20 12:56:39 +0000329
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000330 void updateParameterCount(FormatToken *Left, FormatToken *Current) {
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000331 if (Current->Type == TT_LambdaLSquare ||
332 (Current->is(tok::caret) && Current->Type == TT_UnaryOperator) ||
333 (Style.Language == FormatStyle::LK_JavaScript &&
334 Current->TokenText == "function")) {
335 ++Left->BlockParameterCount;
336 }
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000337 if (Current->is(tok::comma)) {
Daniel Jaspere11095a2013-02-14 15:01:34 +0000338 ++Left->ParameterCount;
Daniel Jasper8de9ed02013-08-22 15:00:41 +0000339 if (!Left->Role)
340 Left->Role.reset(new CommaSeparatedList(Style));
341 Left->Role->CommaFound(Current);
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000342 } else if (Left->ParameterCount == 0 && Current->isNot(tok::comment)) {
Daniel Jaspere11095a2013-02-14 15:01:34 +0000343 Left->ParameterCount = 1;
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000344 }
Daniel Jaspere11095a2013-02-14 15:01:34 +0000345 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000346
347 bool parseConditional() {
Craig Topper2145bc02014-05-09 08:15:10 +0000348 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000349 if (CurrentToken->is(tok::colon)) {
350 CurrentToken->Type = TT_ConditionalExpr;
351 next();
352 return true;
353 }
354 if (!consumeToken())
355 return false;
356 }
357 return false;
358 }
359
360 bool parseTemplateDeclaration() {
Craig Topper2145bc02014-05-09 08:15:10 +0000361 if (CurrentToken && CurrentToken->is(tok::less)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000362 CurrentToken->Type = TT_TemplateOpener;
363 next();
364 if (!parseAngle())
365 return false;
Craig Topper2145bc02014-05-09 08:15:10 +0000366 if (CurrentToken)
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000367 CurrentToken->Previous->ClosesTemplateDeclaration = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000368 return true;
369 }
370 return false;
371 }
372
373 bool consumeToken() {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000374 FormatToken *Tok = CurrentToken;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000375 next();
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000376 switch (Tok->Tok.getKind()) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000377 case tok::plus:
378 case tok::minus:
Craig Topper2145bc02014-05-09 08:15:10 +0000379 if (!Tok->Previous && Line.MustBeDeclaration)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000380 Tok->Type = TT_ObjCMethodSpecifier;
381 break;
382 case tok::colon:
Craig Topper2145bc02014-05-09 08:15:10 +0000383 if (!Tok->Previous)
Daniel Jasper850677d2013-03-18 12:50:26 +0000384 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000385 // Colons from ?: are handled in parseConditional().
Daniel Jasper031e2402014-04-28 07:48:36 +0000386 if (Tok->Previous->is(tok::r_paren) && Contexts.size() == 1 &&
387 Line.First->isNot(tok::kw_case)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000388 Tok->Type = TT_CtorInitializerColon;
Daniel Jasperb596fb22013-10-24 10:31:50 +0000389 } else if (Contexts.back().ColonIsDictLiteral) {
390 Tok->Type = TT_DictLiteral;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000391 } else if (Contexts.back().ColonIsObjCMethodExpr ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000392 Line.First->Type == TT_ObjCMethodSpecifier) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000393 Tok->Type = TT_ObjCMethodExpr;
Daniel Jasper17062ff2014-06-10 14:44:02 +0000394 Tok->Previous->Type = TT_SelectorName;
Alexander Kornienko39856b72013-09-10 09:38:25 +0000395 if (Tok->Previous->ColumnWidth >
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000396 Contexts.back().LongestObjCSelectorName) {
Alexander Kornienko60d1b042013-10-10 13:36:20 +0000397 Contexts.back().LongestObjCSelectorName = Tok->Previous->ColumnWidth;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000398 }
Craig Topper2145bc02014-05-09 08:15:10 +0000399 if (!Contexts.back().FirstObjCSelectorName)
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000400 Contexts.back().FirstObjCSelectorName = Tok->Previous;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000401 } else if (Contexts.back().ColonIsForRangeExpr) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000402 Tok->Type = TT_RangeBasedForLoopColon;
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000403 } else if (CurrentToken && CurrentToken->is(tok::numeric_constant)) {
Alexander Kornienko60d1b042013-10-10 13:36:20 +0000404 Tok->Type = TT_BitFieldColon;
Daniel Jasperd39312ec2014-05-28 10:09:11 +0000405 } else if (Contexts.size() == 1 &&
406 !Line.First->isOneOf(tok::kw_enum, tok::kw_case)) {
Daniel Jaspereead02b2013-02-14 08:42:54 +0000407 Tok->Type = TT_InheritanceColon;
Daniel Jasper40aacf42013-03-14 13:45:21 +0000408 } else if (Contexts.back().ContextKind == tok::l_paren) {
409 Tok->Type = TT_InlineASMColon;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000410 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000411 break;
412 case tok::kw_if:
413 case tok::kw_while:
Craig Topper2145bc02014-05-09 08:15:10 +0000414 if (CurrentToken && CurrentToken->is(tok::l_paren)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000415 next();
Nico Weber9096fc02013-06-26 00:30:14 +0000416 if (!parseParens(/*LookForDecls=*/true))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000417 return false;
418 }
419 break;
420 case tok::kw_for:
Daniel Jasperc697ad22013-02-06 10:05:46 +0000421 Contexts.back().ColonIsForRangeExpr = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000422 next();
423 if (!parseParens())
424 return false;
425 break;
426 case tok::l_paren:
427 if (!parseParens())
428 return false;
Daniel Jasperbc5cb4e2013-11-07 17:43:07 +0000429 if (Line.MustBeDeclaration && Contexts.size() == 1 &&
Daniel Jasperf10a28d2014-05-05 13:48:09 +0000430 !Contexts.back().IsExpression &&
431 Line.First->Type != TT_ObjCProperty &&
432 (!Tok->Previous || Tok->Previous->isNot(tok::kw_decltype)))
Daniel Jasper26d1b1d2013-02-24 18:54:32 +0000433 Line.MightBeFunctionDecl = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000434 break;
435 case tok::l_square:
436 if (!parseSquare())
437 return false;
438 break;
439 case tok::l_brace:
440 if (!parseBrace())
441 return false;
442 break;
443 case tok::less:
Daniel Jasper62c0ac02013-07-30 22:37:19 +0000444 if (Tok->Previous && !Tok->Previous->Tok.isLiteral() && parseAngle())
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000445 Tok->Type = TT_TemplateOpener;
446 else {
447 Tok->Type = TT_BinaryOperator;
448 CurrentToken = Tok;
449 next();
450 }
451 break;
452 case tok::r_paren:
453 case tok::r_square:
454 return false;
455 case tok::r_brace:
456 // Lines can start with '}'.
Craig Topper2145bc02014-05-09 08:15:10 +0000457 if (Tok->Previous)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000458 return false;
459 break;
460 case tok::greater:
461 Tok->Type = TT_BinaryOperator;
462 break;
463 case tok::kw_operator:
Daniel Jasper42401c82013-09-02 09:20:39 +0000464 while (CurrentToken &&
465 !CurrentToken->isOneOf(tok::l_paren, tok::semi, tok::r_paren)) {
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000466 if (CurrentToken->isOneOf(tok::star, tok::amp))
Daniel Jasper35d2dc72013-02-11 08:01:18 +0000467 CurrentToken->Type = TT_PointerOrReference;
468 consumeToken();
Daniel Jasper42401c82013-09-02 09:20:39 +0000469 if (CurrentToken && CurrentToken->Previous->Type == TT_BinaryOperator)
Daniel Jasperd215b8b2013-08-28 07:27:35 +0000470 CurrentToken->Previous->Type = TT_OverloadedOperator;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000471 }
Daniel Jasper8f9624b2013-05-10 07:59:58 +0000472 if (CurrentToken) {
Daniel Jasper35d2dc72013-02-11 08:01:18 +0000473 CurrentToken->Type = TT_OverloadedOperatorLParen;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000474 if (CurrentToken->Previous->Type == TT_BinaryOperator)
475 CurrentToken->Previous->Type = TT_OverloadedOperator;
Daniel Jasper8f9624b2013-05-10 07:59:58 +0000476 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000477 break;
478 case tok::question:
479 parseConditional();
480 break;
481 case tok::kw_template:
482 parseTemplateDeclaration();
483 break;
Nico Weber29f9dea2013-02-11 15:32:15 +0000484 case tok::identifier:
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000485 if (Line.First->is(tok::kw_for) &&
486 Tok->Tok.getIdentifierInfo() == &Ident_in)
Nico Weber29f9dea2013-02-11 15:32:15 +0000487 Tok->Type = TT_ObjCForIn;
488 break;
Daniel Jaspera628c982013-04-03 13:36:17 +0000489 case tok::comma:
490 if (Contexts.back().FirstStartOfName)
491 Contexts.back().FirstStartOfName->PartOfMultiVariableDeclStmt = true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000492 if (Contexts.back().InCtorInitializer)
493 Tok->Type = TT_CtorInitializerComma;
Daniel Jaspere1e43192014-04-01 12:55:11 +0000494 if (Contexts.back().IsForEachMacro)
495 Contexts.back().IsExpression = true;
Daniel Jaspera628c982013-04-03 13:36:17 +0000496 break;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000497 default:
498 break;
499 }
500 return true;
501 }
502
503 void parseIncludeDirective() {
Craig Topper2145bc02014-05-09 08:15:10 +0000504 if (CurrentToken && CurrentToken->is(tok::less)) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000505 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000506 while (CurrentToken) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000507 if (CurrentToken->isNot(tok::comment) || CurrentToken->Next)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000508 CurrentToken->Type = TT_ImplicitStringLiteral;
509 next();
510 }
511 } else {
Craig Topper2145bc02014-05-09 08:15:10 +0000512 while (CurrentToken) {
Daniel Jasperaf5ba0e2013-02-23 07:46:38 +0000513 if (CurrentToken->is(tok::string_literal))
514 // Mark these string literals as "implicit" literals, too, so that
515 // they are not split or line-wrapped.
516 CurrentToken->Type = TT_ImplicitStringLiteral;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000517 next();
518 }
519 }
520 }
521
522 void parseWarningOrError() {
523 next();
524 // We still want to format the whitespace left of the first token of the
525 // warning or error.
526 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000527 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000528 CurrentToken->Type = TT_ImplicitStringLiteral;
529 next();
530 }
531 }
532
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000533 void parsePragma() {
534 next(); // Consume "pragma".
535 if (CurrentToken && CurrentToken->TokenText == "mark") {
536 next(); // Consume "mark".
537 next(); // Consume first token (so we fix leading whitespace).
Craig Topper2145bc02014-05-09 08:15:10 +0000538 while (CurrentToken) {
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000539 CurrentToken->Type = TT_ImplicitStringLiteral;
540 next();
541 }
542 }
543 }
544
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000545 void parsePreprocessorDirective() {
546 next();
Craig Topper2145bc02014-05-09 08:15:10 +0000547 if (!CurrentToken)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000548 return;
Alexander Kornienko384b40b2013-10-11 21:43:05 +0000549 if (CurrentToken->Tok.is(tok::numeric_constant)) {
550 CurrentToken->SpacesRequiredBefore = 1;
551 return;
552 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000553 // Hashes in the middle of a line can lead to any strange token
554 // sequence.
Craig Topper2145bc02014-05-09 08:15:10 +0000555 if (!CurrentToken->Tok.getIdentifierInfo())
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000556 return;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000557 switch (CurrentToken->Tok.getIdentifierInfo()->getPPKeywordID()) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000558 case tok::pp_include:
559 case tok::pp_import:
Daniel Jasper343643b2014-08-13 08:29:18 +0000560 next();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000561 parseIncludeDirective();
562 break;
563 case tok::pp_error:
564 case tok::pp_warning:
565 parseWarningOrError();
566 break;
Daniel Jasperdc32c1b2014-01-09 13:56:49 +0000567 case tok::pp_pragma:
568 parsePragma();
569 break;
Daniel Jasper4431aa92013-04-23 13:54:04 +0000570 case tok::pp_if:
571 case tok::pp_elif:
Daniel Jasper7cfde412014-01-21 08:56:09 +0000572 Contexts.back().IsExpression = true;
Daniel Jasper4431aa92013-04-23 13:54:04 +0000573 parseLine();
574 break;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000575 default:
576 break;
577 }
Craig Topper2145bc02014-05-09 08:15:10 +0000578 while (CurrentToken)
Daniel Jaspera885dbe2013-02-05 09:34:14 +0000579 next();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000580 }
581
Nico Weber44449172013-02-12 16:17:07 +0000582public:
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000583 LineType parseLine() {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000584 if (CurrentToken->is(tok::hash)) {
585 parsePreprocessorDirective();
586 return LT_PreprocessorDirective;
587 }
Daniel Jasper7cfde412014-01-21 08:56:09 +0000588
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000589 // Directly allow to 'import <string-literal>' to support protocol buffer
590 // definitions (code.google.com/p/protobuf) or missing "#" (either way we
591 // should not break the line).
592 IdentifierInfo *Info = CurrentToken->Tok.getIdentifierInfo();
593 if (Info && Info->getPPKeywordID() == tok::pp_import &&
Daniel Jasper343643b2014-08-13 08:29:18 +0000594 CurrentToken->Next && CurrentToken->Next->is(tok::string_literal)) {
595 next();
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000596 parseIncludeDirective();
Daniel Jasper343643b2014-08-13 08:29:18 +0000597 return LT_Other;
598 }
599
600 // If this line starts and ends in '<' and '>', respectively, it is likely
601 // part of "#define <a/b.h>".
602 if (CurrentToken->is(tok::less) && Line.Last->is(tok::greater)) {
603 parseIncludeDirective();
604 return LT_Other;
605 }
Daniel Jasper47ef6dd2014-01-17 16:21:39 +0000606
Craig Topper2145bc02014-05-09 08:15:10 +0000607 while (CurrentToken) {
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000608 if (CurrentToken->is(tok::kw_virtual))
609 KeywordVirtualFound = true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000610 if (!consumeToken())
611 return LT_Invalid;
612 }
613 if (KeywordVirtualFound)
614 return LT_VirtualFunctionDecl;
615
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000616 if (Line.First->Type == TT_ObjCMethodSpecifier) {
Craig Topper2145bc02014-05-09 08:15:10 +0000617 if (Contexts.back().FirstObjCSelectorName)
Daniel Jasperc697ad22013-02-06 10:05:46 +0000618 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
619 Contexts.back().LongestObjCSelectorName;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000620 return LT_ObjCMethodDecl;
621 }
622
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000623 return LT_Other;
624 }
625
Nico Weber44449172013-02-12 16:17:07 +0000626private:
Manuel Klimek819788d2014-03-18 11:22:45 +0000627 void resetTokenMetadata(FormatToken *Token) {
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000628 if (!Token)
629 return;
Manuel Klimek819788d2014-03-18 11:22:45 +0000630
631 // Reset token type in case we have already looked at it and then
632 // recovered from an error (e.g. failure to find the matching >).
633 if (CurrentToken->Type != TT_LambdaLSquare &&
634 CurrentToken->Type != TT_FunctionLBrace &&
635 CurrentToken->Type != TT_ImplicitStringLiteral &&
Daniel Jasperf9ae3122014-05-08 07:01:45 +0000636 CurrentToken->Type != TT_RegexLiteral &&
Manuel Klimek819788d2014-03-18 11:22:45 +0000637 CurrentToken->Type != TT_TrailingReturnArrow)
638 CurrentToken->Type = TT_Unknown;
David Blaikie3875a822014-07-19 01:06:45 +0000639 CurrentToken->Role.reset();
Manuel Klimek819788d2014-03-18 11:22:45 +0000640 CurrentToken->FakeLParens.clear();
641 CurrentToken->FakeRParens = 0;
642 }
643
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000644 void next() {
Craig Topper2145bc02014-05-09 08:15:10 +0000645 if (CurrentToken) {
Daniel Jasper63af7c42013-12-09 14:40:19 +0000646 CurrentToken->NestingLevel = Contexts.size() - 1;
Daniel Jasper78b45332014-08-14 10:52:56 +0000647 CurrentToken->BindingStrength = Contexts.back().BindingStrength;
648 determineTokenType(*CurrentToken);
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000649 CurrentToken = CurrentToken->Next;
Daniel Jasperf9ae3122014-05-08 07:01:45 +0000650 }
Daniel Jasper5065bc42013-02-18 12:44:35 +0000651
Manuel Klimek819788d2014-03-18 11:22:45 +0000652 resetTokenMetadata(CurrentToken);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +0000653 }
654
Daniel Jasperc697ad22013-02-06 10:05:46 +0000655 /// \brief A struct to hold information valid in a specific context, e.g.
656 /// a pair of parenthesis.
657 struct Context {
Daniel Jasper40aacf42013-03-14 13:45:21 +0000658 Context(tok::TokenKind ContextKind, unsigned BindingStrength,
659 bool IsExpression)
660 : ContextKind(ContextKind), BindingStrength(BindingStrength),
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000661 LongestObjCSelectorName(0), ColonIsForRangeExpr(false),
662 ColonIsDictLiteral(false), ColonIsObjCMethodExpr(false),
663 FirstObjCSelectorName(nullptr), FirstStartOfName(nullptr),
664 IsExpression(IsExpression), CanBeExpression(true),
665 InTemplateArgument(false), InCtorInitializer(false),
666 CaretFound(false), IsForEachMacro(false) {}
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000667
Daniel Jasper40aacf42013-03-14 13:45:21 +0000668 tok::TokenKind ContextKind;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000669 unsigned BindingStrength;
670 unsigned LongestObjCSelectorName;
671 bool ColonIsForRangeExpr;
Daniel Jasperb596fb22013-10-24 10:31:50 +0000672 bool ColonIsDictLiteral;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000673 bool ColonIsObjCMethodExpr;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000674 FormatToken *FirstObjCSelectorName;
675 FormatToken *FirstStartOfName;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000676 bool IsExpression;
Daniel Jasper97b89482013-03-13 07:49:51 +0000677 bool CanBeExpression;
Manuel Klimekf81e5c02014-03-27 11:17:36 +0000678 bool InTemplateArgument;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000679 bool InCtorInitializer;
Daniel Jaspera225bce2014-01-16 19:14:34 +0000680 bool CaretFound;
Daniel Jaspere1e43192014-04-01 12:55:11 +0000681 bool IsForEachMacro;
Daniel Jasperc697ad22013-02-06 10:05:46 +0000682 };
683
684 /// \brief Puts a new \c Context onto the stack \c Contexts for the lifetime
685 /// of each instance.
686 struct ScopedContextCreator {
687 AnnotatingParser &P;
688
Daniel Jasper40aacf42013-03-14 13:45:21 +0000689 ScopedContextCreator(AnnotatingParser &P, tok::TokenKind ContextKind,
690 unsigned Increase)
691 : P(P) {
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +0000692 P.Contexts.push_back(Context(ContextKind,
693 P.Contexts.back().BindingStrength + Increase,
694 P.Contexts.back().IsExpression));
Daniel Jasperc697ad22013-02-06 10:05:46 +0000695 }
696
697 ~ScopedContextCreator() { P.Contexts.pop_back(); }
698 };
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000699
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000700 void determineTokenType(FormatToken &Current) {
701 if (Current.getPrecedence() == prec::Assignment &&
Daniel Jasper59036852013-08-12 12:16:34 +0000702 !Line.First->isOneOf(tok::kw_template, tok::kw_using) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000703 (!Current.Previous || Current.Previous->isNot(tok::kw_operator))) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000704 Contexts.back().IsExpression = true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000705 for (FormatToken *Previous = Current.Previous;
Daniel Jasper5ca9b712013-09-11 20:37:10 +0000706 Previous && !Previous->isOneOf(tok::comma, tok::semi);
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000707 Previous = Previous->Previous) {
Manuel Klimek5f594f82014-08-13 14:00:41 +0000708 if (Previous->isOneOf(tok::r_square, tok::r_paren)) {
Daniel Jasper8e559272013-02-27 11:43:50 +0000709 Previous = Previous->MatchingParen;
Manuel Klimek5f594f82014-08-13 14:00:41 +0000710 if (!Previous)
711 break;
712 }
Daniel Jasper8184d662014-07-28 12:24:21 +0000713 if ((Previous->Type == TT_BinaryOperator ||
714 Previous->Type == TT_UnaryOperator) &&
Daniel Jasper1904e9b2014-08-14 10:53:19 +0000715 Previous->isOneOf(tok::star, tok::amp) && Previous->Previous &&
716 Previous->Previous->isNot(tok::equal)) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000717 Previous->Type = TT_PointerOrReference;
718 }
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000719 }
Daniel Jasper3682fcd2013-12-16 08:36:18 +0000720 } else if (Current.isOneOf(tok::kw_return, tok::kw_throw)) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000721 Contexts.back().IsExpression = true;
Daniel Jasper3682fcd2013-12-16 08:36:18 +0000722 } else if (Current.is(tok::l_paren) && !Line.MustBeDeclaration &&
Dinesh Dwivedi2e92e662014-05-06 11:46:49 +0000723 !Line.InPPDirective &&
724 (!Current.Previous ||
725 Current.Previous->isNot(tok::kw_decltype))) {
Daniel Jasper3682fcd2013-12-16 08:36:18 +0000726 bool ParametersOfFunctionType =
727 Current.Previous && Current.Previous->is(tok::r_paren) &&
728 Current.Previous->MatchingParen &&
729 Current.Previous->MatchingParen->Type == TT_FunctionTypeLParen;
730 bool IsForOrCatch = Current.Previous &&
731 Current.Previous->isOneOf(tok::kw_for, tok::kw_catch);
732 Contexts.back().IsExpression = !ParametersOfFunctionType && !IsForOrCatch;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000733 } else if (Current.isOneOf(tok::r_paren, tok::greater, tok::comma)) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000734 for (FormatToken *Previous = Current.Previous;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000735 Previous && Previous->isOneOf(tok::star, tok::amp);
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000736 Previous = Previous->Previous)
Nico Weber44449172013-02-12 16:17:07 +0000737 Previous->Type = TT_PointerOrReference;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000738 } else if (Current.Previous &&
739 Current.Previous->Type == TT_CtorInitializerColon) {
Daniel Jasper5065bc42013-02-18 12:44:35 +0000740 Contexts.back().IsExpression = true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +0000741 Contexts.back().InCtorInitializer = true;
Daniel Jasper97b89482013-03-13 07:49:51 +0000742 } else if (Current.is(tok::kw_new)) {
743 Contexts.back().CanBeExpression = false;
Daniel Jaspera98da3d2013-11-07 19:56:07 +0000744 } else if (Current.is(tok::semi) || Current.is(tok::exclaim)) {
Daniel Jasperc37de302013-05-03 14:41:24 +0000745 // This should be the condition or increment in a for-loop.
746 Contexts.back().IsExpression = true;
Nico Weber44449172013-02-12 16:17:07 +0000747 }
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000748
749 if (Current.Type == TT_Unknown) {
Daniel Jasperf3167902013-09-27 08:29:16 +0000750 // Line.MightBeFunctionDecl can only be true after the parentheses of a
751 // function declaration have been found. In this case, 'Current' is a
752 // trailing token of this declaration and thus cannot be a name.
Daniel Jasper78b45332014-08-14 10:52:56 +0000753 if (isStartOfName(Current) &&
754 (!Line.MightBeFunctionDecl || Current.NestingLevel != 0)) {
Daniel Jaspera628c982013-04-03 13:36:17 +0000755 Contexts.back().FirstStartOfName = &Current;
Daniel Jasper26d1b1d2013-02-24 18:54:32 +0000756 Current.Type = TT_StartOfName;
Daniel Jasper6cdec7c2013-07-09 14:36:48 +0000757 } else if (Current.is(tok::kw_auto)) {
758 AutoFound = true;
Daniel Jaspera3501d42013-07-11 14:33:06 +0000759 } else if (Current.is(tok::arrow) && AutoFound &&
760 Line.MustBeDeclaration) {
Daniel Jasper6cdec7c2013-07-09 14:36:48 +0000761 Current.Type = TT_TrailingReturnArrow;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000762 } else if (Current.isOneOf(tok::star, tok::amp, tok::ampamp)) {
Daniel Jasperc697ad22013-02-06 10:05:46 +0000763 Current.Type =
Daniel Jasper6f9c8d22013-07-05 13:30:40 +0000764 determineStarAmpUsage(Current, Contexts.back().CanBeExpression &&
Manuel Klimekf81e5c02014-03-27 11:17:36 +0000765 Contexts.back().IsExpression,
766 Contexts.back().InTemplateArgument);
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000767 } else if (Current.isOneOf(tok::minus, tok::plus, tok::caret)) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000768 Current.Type = determinePlusMinusCaretUsage(Current);
Daniel Jasper114a2bc2014-06-03 12:02:45 +0000769 if (Current.Type == TT_UnaryOperator && Current.is(tok::caret))
Daniel Jasperb77105d2014-04-08 14:04:31 +0000770 Contexts.back().CaretFound = true;
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000771 } else if (Current.isOneOf(tok::minusminus, tok::plusplus)) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000772 Current.Type = determineIncrementUsage(Current);
Daniel Jasper2ac3fdf2014-07-28 12:08:16 +0000773 } else if (Current.isOneOf(tok::exclaim, tok::tilde)) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000774 Current.Type = TT_UnaryOperator;
Daniel Jasperc0d606a2014-04-14 11:08:45 +0000775 } else if (Current.is(tok::question)) {
776 Current.Type = TT_ConditionalExpr;
Manuel Klimekbab25fd2013-09-04 08:20:47 +0000777 } else if (Current.isBinaryOperator() &&
778 (!Current.Previous ||
779 Current.Previous->isNot(tok::l_square))) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000780 Current.Type = TT_BinaryOperator;
781 } else if (Current.is(tok::comment)) {
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000782 if (Current.TokenText.startswith("//"))
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000783 Current.Type = TT_LineComment;
784 else
785 Current.Type = TT_BlockComment;
Nico Weberc6fe2162013-02-13 04:13:13 +0000786 } else if (Current.is(tok::r_paren)) {
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000787 if (rParenEndsCast(Current))
Nico Weberc6fe2162013-02-13 04:13:13 +0000788 Current.Type = TT_CastRParen;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000789 } else if (Current.is(tok::at) && Current.Next) {
790 switch (Current.Next->Tok.getObjCKeywordID()) {
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000791 case tok::objc_interface:
792 case tok::objc_implementation:
793 case tok::objc_protocol:
794 Current.Type = TT_ObjCDecl;
795 break;
796 case tok::objc_property:
797 Current.Type = TT_ObjCProperty;
798 break;
799 default:
800 break;
801 }
Daniel Jasperbca4bbe2013-05-28 11:30:49 +0000802 } else if (Current.is(tok::period)) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000803 FormatToken *PreviousNoComment = Current.getPreviousNonComment();
Daniel Jasperbca4bbe2013-05-28 11:30:49 +0000804 if (PreviousNoComment &&
805 PreviousNoComment->isOneOf(tok::comma, tok::l_brace))
806 Current.Type = TT_DesignatedInitializerPeriod;
Daniel Jasper43e6a282013-12-16 15:01:54 +0000807 } else if (Current.isOneOf(tok::identifier, tok::kw_const) &&
Daniel Jasper35ec2b22014-04-14 08:15:20 +0000808 Current.Previous && Current.Previous->isNot(tok::equal) &&
Daniel Jasper43e6a282013-12-16 15:01:54 +0000809 Line.MightBeFunctionDecl && Contexts.size() == 1) {
810 // Line.MightBeFunctionDecl can only be true after the parentheses of a
811 // function declaration have been found.
812 Current.Type = TT_TrailingAnnotation;
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000813 }
814 }
815 }
816
Daniel Jasperdba1c552013-07-02 09:47:29 +0000817 /// \brief Take a guess at whether \p Tok starts a name of a function or
818 /// variable declaration.
819 ///
820 /// This is a heuristic based on whether \p Tok is an identifier following
821 /// something that is likely a type.
822 bool isStartOfName(const FormatToken &Tok) {
Craig Topper2145bc02014-05-09 08:15:10 +0000823 if (Tok.isNot(tok::identifier) || !Tok.Previous)
Daniel Jasperdba1c552013-07-02 09:47:29 +0000824 return false;
825
826 // Skip "const" as it does not have an influence on whether this is a name.
827 FormatToken *PreviousNotConst = Tok.Previous;
Craig Topper2145bc02014-05-09 08:15:10 +0000828 while (PreviousNotConst && PreviousNotConst->is(tok::kw_const))
Daniel Jasperdba1c552013-07-02 09:47:29 +0000829 PreviousNotConst = PreviousNotConst->Previous;
830
Craig Topper2145bc02014-05-09 08:15:10 +0000831 if (!PreviousNotConst)
Daniel Jasperdba1c552013-07-02 09:47:29 +0000832 return false;
833
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +0000834 bool IsPPKeyword = PreviousNotConst->is(tok::identifier) &&
835 PreviousNotConst->Previous &&
836 PreviousNotConst->Previous->is(tok::hash);
Daniel Jasperdba1c552013-07-02 09:47:29 +0000837
Daniel Jasper53643062013-08-19 10:16:18 +0000838 if (PreviousNotConst->Type == TT_TemplateCloser)
839 return PreviousNotConst && PreviousNotConst->MatchingParen &&
840 PreviousNotConst->MatchingParen->Previous &&
841 PreviousNotConst->MatchingParen->Previous->isNot(tok::kw_template);
842
Daniel Jasperf10a28d2014-05-05 13:48:09 +0000843 if (PreviousNotConst->is(tok::r_paren) && PreviousNotConst->MatchingParen &&
844 PreviousNotConst->MatchingParen->Previous &&
845 PreviousNotConst->MatchingParen->Previous->is(tok::kw_decltype))
846 return true;
847
Daniel Jasperdba1c552013-07-02 09:47:29 +0000848 return (!IsPPKeyword && PreviousNotConst->is(tok::identifier)) ||
849 PreviousNotConst->Type == TT_PointerOrReference ||
Daniel Jaspercb51cf42014-01-16 09:11:55 +0000850 PreviousNotConst->isSimpleTypeSpecifier();
Daniel Jasperdba1c552013-07-02 09:47:29 +0000851 }
852
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000853 /// \brief Determine whether ')' is ending a cast.
854 bool rParenEndsCast(const FormatToken &Tok) {
Craig Topper4b566922014-06-09 02:04:02 +0000855 FormatToken *LeftOfParens = nullptr;
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000856 if (Tok.MatchingParen)
857 LeftOfParens = Tok.MatchingParen->getPreviousNonComment();
Daniel Jasper4b3ba212014-08-25 09:36:07 +0000858 if (LeftOfParens && LeftOfParens->is(tok::r_paren) &&
859 LeftOfParens->MatchingParen)
860 LeftOfParens = LeftOfParens->MatchingParen->Previous;
Daniel Jasper8b76d602014-07-28 12:08:06 +0000861 if (LeftOfParens && LeftOfParens->is(tok::r_square) &&
862 LeftOfParens->MatchingParen &&
863 LeftOfParens->MatchingParen->Type == TT_LambdaLSquare)
864 return false;
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000865 bool IsCast = false;
866 bool ParensAreEmpty = Tok.Previous == Tok.MatchingParen;
867 bool ParensAreType = !Tok.Previous ||
868 Tok.Previous->Type == TT_PointerOrReference ||
869 Tok.Previous->Type == TT_TemplateCloser ||
870 Tok.Previous->isSimpleTypeSpecifier();
871 bool ParensCouldEndDecl =
872 Tok.Next && Tok.Next->isOneOf(tok::equal, tok::semi, tok::l_brace);
873 bool IsSizeOfOrAlignOf =
874 LeftOfParens && LeftOfParens->isOneOf(tok::kw_sizeof, tok::kw_alignof);
875 if (ParensAreType && !ParensCouldEndDecl && !IsSizeOfOrAlignOf &&
876 ((Contexts.size() > 1 && Contexts[Contexts.size() - 2].IsExpression) ||
877 (Tok.Next && Tok.Next->isBinaryOperator())))
878 IsCast = true;
879 else if (Tok.Next && Tok.Next->isNot(tok::string_literal) &&
880 (Tok.Next->Tok.isLiteral() ||
881 Tok.Next->isOneOf(tok::kw_sizeof, tok::kw_alignof)))
882 IsCast = true;
883 // If there is an identifier after the (), it is likely a cast, unless
884 // there is also an identifier before the ().
Craig Topper4b566922014-06-09 02:04:02 +0000885 else if (LeftOfParens &&
886 (LeftOfParens->Tok.getIdentifierInfo() == nullptr ||
887 LeftOfParens->is(tok::kw_return)) &&
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000888 LeftOfParens->Type != TT_OverloadedOperator &&
889 LeftOfParens->isNot(tok::at) &&
890 LeftOfParens->Type != TT_TemplateCloser && Tok.Next) {
891 if (Tok.Next->isOneOf(tok::identifier, tok::numeric_constant)) {
892 IsCast = true;
893 } else {
894 // Use heuristics to recognize c style casting.
895 FormatToken *Prev = Tok.Previous;
896 if (Prev && Prev->isOneOf(tok::amp, tok::star))
897 Prev = Prev->Previous;
898
899 if (Prev && Tok.Next && Tok.Next->Next) {
900 bool NextIsUnary = Tok.Next->isUnaryOperator() ||
901 Tok.Next->isOneOf(tok::amp, tok::star);
Daniel Jasperb05a81d2014-05-09 13:11:16 +0000902 IsCast = NextIsUnary && Tok.Next->Next->isOneOf(
903 tok::identifier, tok::numeric_constant);
Dinesh Dwivedi13b9b7e2014-05-06 09:08:34 +0000904 }
905
906 for (; Prev != Tok.MatchingParen; Prev = Prev->Previous) {
907 if (!Prev || !Prev->isOneOf(tok::kw_const, tok::identifier)) {
908 IsCast = false;
909 break;
910 }
911 }
912 }
913 }
914 return IsCast && !ParensAreEmpty;
915 }
916
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000917 /// \brief Return the type of the given token assuming it is * or &.
Manuel Klimekf81e5c02014-03-27 11:17:36 +0000918 TokenType determineStarAmpUsage(const FormatToken &Tok, bool IsExpression,
919 bool InTemplateArgument) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000920 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Craig Topper2145bc02014-05-09 08:15:10 +0000921 if (!PrevToken)
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000922 return TT_UnaryOperator;
923
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000924 const FormatToken *NextToken = Tok.getNextNonComment();
Daniel Jasper2520fe92014-06-30 13:54:27 +0000925 if (!NextToken || NextToken->is(tok::l_brace))
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000926 return TT_Unknown;
927
Daniel Jasper73e171f2014-08-29 12:54:38 +0000928 if (PrevToken->is(tok::coloncolon))
Daniel Jasper8eb371b2013-03-01 17:13:29 +0000929 return TT_PointerOrReference;
930
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000931 if (PrevToken->isOneOf(tok::l_paren, tok::l_square, tok::l_brace,
Daniel Jasperae907642013-03-14 10:50:25 +0000932 tok::comma, tok::semi, tok::kw_return, tok::colon,
Daniel Jasperdf620b22013-09-21 17:31:51 +0000933 tok::equal, tok::kw_delete, tok::kw_sizeof) ||
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000934 PrevToken->Type == TT_BinaryOperator ||
Daniel Jasperc0d606a2014-04-14 11:08:45 +0000935 PrevToken->Type == TT_ConditionalExpr ||
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000936 PrevToken->Type == TT_UnaryOperator || PrevToken->Type == TT_CastRParen)
937 return TT_UnaryOperator;
938
Daniel Jasperea2d0422014-05-08 08:50:10 +0000939 if (NextToken->is(tok::l_square) && NextToken->Type != TT_LambdaLSquare)
Nico Weber5d2624e2013-02-06 06:20:11 +0000940 return TT_PointerOrReference;
Daniel Jasper6ba16382014-07-28 13:19:58 +0000941 if (NextToken->isOneOf(tok::kw_operator, tok::comma))
Daniel Jasper32ccb032014-06-23 07:36:18 +0000942 return TT_PointerOrReference;
Nico Weber5d2624e2013-02-06 06:20:11 +0000943
Daniel Jasper71665cd2013-09-10 10:26:38 +0000944 if (PrevToken->is(tok::r_paren) && PrevToken->MatchingParen &&
945 PrevToken->MatchingParen->Previous &&
Daniel Jasper4ac7de72014-06-11 07:35:16 +0000946 PrevToken->MatchingParen->Previous->isOneOf(tok::kw_typeof,
947 tok::kw_decltype))
Daniel Jasper71665cd2013-09-10 10:26:38 +0000948 return TT_PointerOrReference;
949
Manuel Klimek94815562014-03-28 09:27:09 +0000950 if (PrevToken->Tok.isLiteral() ||
951 PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::kw_true,
952 tok::kw_false) ||
953 NextToken->Tok.isLiteral() ||
954 NextToken->isOneOf(tok::kw_true, tok::kw_false) ||
955 NextToken->isUnaryOperator() ||
Manuel Klimekf81e5c02014-03-27 11:17:36 +0000956 // If we know we're in a template argument, there are no named
957 // declarations. Thus, having an identifier on the right-hand side
958 // indicates a binary operator.
959 (InTemplateArgument && NextToken->Tok.isAnyIdentifier()))
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000960 return TT_BinaryOperator;
961
Daniel Jasper7d028292014-06-02 11:54:20 +0000962 // This catches some cases where evaluation order is used as control flow:
963 // aaa && aaa->f();
964 const FormatToken *NextNextToken = NextToken->getNextNonComment();
965 if (NextNextToken && NextNextToken->is(tok::arrow))
966 return TT_BinaryOperator;
967
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000968 // It is very unlikely that we are going to find a pointer or reference type
969 // definition on the RHS of an assignment.
970 if (IsExpression)
971 return TT_BinaryOperator;
972
973 return TT_PointerOrReference;
974 }
975
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000976 TokenType determinePlusMinusCaretUsage(const FormatToken &Tok) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000977 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Craig Topper2145bc02014-05-09 08:15:10 +0000978 if (!PrevToken || PrevToken->Type == TT_CastRParen)
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000979 return TT_UnaryOperator;
980
981 // Use heuristics to recognize unary operators.
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000982 if (PrevToken->isOneOf(tok::equal, tok::l_paren, tok::comma, tok::l_square,
983 tok::question, tok::colon, tok::kw_return,
984 tok::kw_case, tok::at, tok::l_brace))
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000985 return TT_UnaryOperator;
986
Nico Weberb76de882013-02-05 16:21:00 +0000987 // There can't be two consecutive binary operators.
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000988 if (PrevToken->Type == TT_BinaryOperator)
989 return TT_UnaryOperator;
990
991 // Fall back to marking the token as binary operator.
992 return TT_BinaryOperator;
993 }
994
995 /// \brief Determine whether ++/-- are pre- or post-increments/-decrements.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000996 TokenType determineIncrementUsage(const FormatToken &Tok) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000997 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Craig Topper2145bc02014-05-09 08:15:10 +0000998 if (!PrevToken || PrevToken->Type == TT_CastRParen)
Daniel Jasper3a9370c2013-02-04 07:21:18 +0000999 return TT_UnaryOperator;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001000 if (PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::identifier))
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001001 return TT_TrailingUnaryOperator;
1002
1003 return TT_UnaryOperator;
1004 }
Daniel Jasperc697ad22013-02-06 10:05:46 +00001005
1006 SmallVector<Context, 8> Contexts;
1007
Daniel Jasper8de9ed02013-08-22 15:00:41 +00001008 const FormatStyle &Style;
Daniel Jasperc697ad22013-02-06 10:05:46 +00001009 AnnotatedLine &Line;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001010 FormatToken *CurrentToken;
Daniel Jasperc697ad22013-02-06 10:05:46 +00001011 bool KeywordVirtualFound;
Daniel Jasper6cdec7c2013-07-09 14:36:48 +00001012 bool AutoFound;
Nico Weber29f9dea2013-02-11 15:32:15 +00001013 IdentifierInfo &Ident_in;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001014};
1015
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001016static int PrecedenceUnaryOperator = prec::PointerToMember + 1;
1017static int PrecedenceArrowAndPeriod = prec::PointerToMember + 2;
1018
Daniel Jasper400adc62013-02-08 15:28:42 +00001019/// \brief Parses binary expressions by inserting fake parenthesis based on
1020/// operator precedence.
1021class ExpressionParser {
1022public:
Daniel Jasper6dcecb62013-06-06 09:11:58 +00001023 ExpressionParser(AnnotatedLine &Line) : Current(Line.First) {
1024 // Skip leading "}", e.g. in "} else if (...) {".
1025 if (Current->is(tok::r_brace))
1026 next();
1027 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001028
1029 /// \brief Parse expressions with the given operatore precedence.
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001030 void parse(int Precedence = 0) {
Daniel Jasperf48b5ab2013-11-07 19:23:49 +00001031 // Skip 'return' and ObjC selector colons as they are not part of a binary
1032 // expression.
1033 while (Current &&
1034 (Current->is(tok::kw_return) ||
Daniel Jasper17062ff2014-06-10 14:44:02 +00001035 (Current->is(tok::colon) && (Current->Type == TT_ObjCMethodExpr ||
1036 Current->Type == TT_DictLiteral))))
Daniel Jaspereabede62013-09-30 08:29:03 +00001037 next();
1038
Craig Topper2145bc02014-05-09 08:15:10 +00001039 if (!Current || Precedence > PrecedenceArrowAndPeriod)
Daniel Jasper0649d362013-08-23 15:14:03 +00001040 return;
1041
Daniel Jasper2c611c02013-05-31 14:56:12 +00001042 // Conditional expressions need to be parsed separately for proper nesting.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001043 if (Precedence == prec::Conditional) {
Daniel Jasper2c611c02013-05-31 14:56:12 +00001044 parseConditionalExpr();
1045 return;
1046 }
Daniel Jasper0649d362013-08-23 15:14:03 +00001047
1048 // Parse unary operators, which all have a higher precedence than binary
1049 // operators.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001050 if (Precedence == PrecedenceUnaryOperator) {
Daniel Jasper0649d362013-08-23 15:14:03 +00001051 parseUnaryOperator();
Daniel Jasper400adc62013-02-08 15:28:42 +00001052 return;
Daniel Jasper0649d362013-08-23 15:14:03 +00001053 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001054
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001055 FormatToken *Start = Current;
Craig Topper2145bc02014-05-09 08:15:10 +00001056 FormatToken *LatestOperator = nullptr;
Daniel Jasper0e617842014-04-16 12:26:54 +00001057 unsigned OperatorIndex = 0;
Daniel Jasper400adc62013-02-08 15:28:42 +00001058
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001059 while (Current) {
Daniel Jasper400adc62013-02-08 15:28:42 +00001060 // Consume operators with higher precedence.
Daniel Jasper6bee6822013-04-08 20:33:42 +00001061 parse(Precedence + 1);
Daniel Jasper400adc62013-02-08 15:28:42 +00001062
Daniel Jasper0649d362013-08-23 15:14:03 +00001063 int CurrentPrecedence = getCurrentPrecedence();
1064
Daniel Jasper17062ff2014-06-10 14:44:02 +00001065 if (Current && Current->Type == TT_SelectorName &&
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001066 Precedence == CurrentPrecedence) {
1067 if (LatestOperator)
1068 addFakeParenthesis(Start, prec::Level(Precedence));
Daniel Jasper0649d362013-08-23 15:14:03 +00001069 Start = Current;
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001070 }
Daniel Jaspercd8599e2013-02-23 21:01:55 +00001071
Daniel Jasper400adc62013-02-08 15:28:42 +00001072 // At the end of the line or when an operator with higher precedence is
1073 // found, insert fake parenthesis and return.
Craig Topper2145bc02014-05-09 08:15:10 +00001074 if (!Current || Current->closesScope() ||
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001075 (CurrentPrecedence != -1 && CurrentPrecedence < Precedence)) {
1076 if (LatestOperator) {
Daniel Jasper0e617842014-04-16 12:26:54 +00001077 LatestOperator->LastOperator = true;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001078 if (Precedence == PrecedenceArrowAndPeriod) {
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001079 // Call expressions don't have a binary operator precedence.
1080 addFakeParenthesis(Start, prec::Unknown);
1081 } else {
1082 addFakeParenthesis(Start, prec::Level(Precedence));
1083 }
1084 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001085 return;
1086 }
1087
1088 // Consume scopes: (), [], <> and {}
Daniel Jasperc04baae2013-04-10 09:49:49 +00001089 if (Current->opensScope()) {
1090 while (Current && !Current->closesScope()) {
Daniel Jasper400adc62013-02-08 15:28:42 +00001091 next();
1092 parse();
1093 }
1094 next();
1095 } else {
1096 // Operator found.
Daniel Jasper0e617842014-04-16 12:26:54 +00001097 if (CurrentPrecedence == Precedence) {
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001098 LatestOperator = Current;
Daniel Jasper0e617842014-04-16 12:26:54 +00001099 Current->OperatorIndex = OperatorIndex;
1100 ++OperatorIndex;
1101 }
Daniel Jasper400adc62013-02-08 15:28:42 +00001102
1103 next();
1104 }
1105 }
1106 }
1107
1108private:
Daniel Jasper0649d362013-08-23 15:14:03 +00001109 /// \brief Gets the precedence (+1) of the given token for binary operators
1110 /// and other tokens that we treat like binary operators.
1111 int getCurrentPrecedence() {
1112 if (Current) {
1113 if (Current->Type == TT_ConditionalExpr)
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001114 return prec::Conditional;
Daniel Jasperf48b5ab2013-11-07 19:23:49 +00001115 else if (Current->is(tok::semi) || Current->Type == TT_InlineASMColon ||
Daniel Jasper17062ff2014-06-10 14:44:02 +00001116 Current->Type == TT_SelectorName)
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001117 return 0;
Daniel Jasper9cc3e972014-02-07 10:09:46 +00001118 else if (Current->Type == TT_RangeBasedForLoopColon)
1119 return prec::Comma;
Daniel Jasper0649d362013-08-23 15:14:03 +00001120 else if (Current->Type == TT_BinaryOperator || Current->is(tok::comma))
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001121 return Current->getPrecedence();
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001122 else if (Current->isOneOf(tok::period, tok::arrow))
1123 return PrecedenceArrowAndPeriod;
Daniel Jasper0649d362013-08-23 15:14:03 +00001124 }
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001125 return -1;
Daniel Jasper0649d362013-08-23 15:14:03 +00001126 }
1127
Daniel Jasper2c611c02013-05-31 14:56:12 +00001128 void addFakeParenthesis(FormatToken *Start, prec::Level Precedence) {
1129 Start->FakeLParens.push_back(Precedence);
Daniel Jasper562ecd42013-09-06 08:08:14 +00001130 if (Precedence > prec::Unknown)
1131 Start->StartsBinaryExpression = true;
1132 if (Current) {
Daniel Jasper2c611c02013-05-31 14:56:12 +00001133 ++Current->Previous->FakeRParens;
Daniel Jasper562ecd42013-09-06 08:08:14 +00001134 if (Precedence > prec::Unknown)
1135 Current->Previous->EndsBinaryExpression = true;
1136 }
Daniel Jasper2c611c02013-05-31 14:56:12 +00001137 }
1138
Daniel Jasper0649d362013-08-23 15:14:03 +00001139 /// \brief Parse unary operator expressions and surround them with fake
1140 /// parentheses if appropriate.
1141 void parseUnaryOperator() {
Craig Topper2145bc02014-05-09 08:15:10 +00001142 if (!Current || Current->Type != TT_UnaryOperator) {
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001143 parse(PrecedenceArrowAndPeriod);
Daniel Jasper0649d362013-08-23 15:14:03 +00001144 return;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001145 }
Daniel Jasper0649d362013-08-23 15:14:03 +00001146
1147 FormatToken *Start = Current;
1148 next();
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001149 parseUnaryOperator();
Daniel Jasper0649d362013-08-23 15:14:03 +00001150
Daniel Jasper0649d362013-08-23 15:14:03 +00001151 // The actual precedence doesn't matter.
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001152 addFakeParenthesis(Start, prec::Unknown);
Daniel Jasper0649d362013-08-23 15:14:03 +00001153 }
1154
Daniel Jasper2c611c02013-05-31 14:56:12 +00001155 void parseConditionalExpr() {
1156 FormatToken *Start = Current;
Daniel Jasperb27c4b72013-08-27 11:09:05 +00001157 parse(prec::LogicalOr);
Daniel Jasper2c611c02013-05-31 14:56:12 +00001158 if (!Current || !Current->is(tok::question))
1159 return;
1160 next();
Daniel Jasperfc3861a2014-07-17 12:22:04 +00001161 parseConditionalExpr();
Daniel Jasper2c611c02013-05-31 14:56:12 +00001162 if (!Current || Current->Type != TT_ConditionalExpr)
1163 return;
1164 next();
1165 parseConditionalExpr();
1166 addFakeParenthesis(Start, prec::Conditional);
1167 }
1168
Daniel Jasper400adc62013-02-08 15:28:42 +00001169 void next() {
Alexander Kornienkoafaa8f52013-06-17 13:19:53 +00001170 if (Current)
1171 Current = Current->Next;
1172 while (Current && Current->isTrailingComment())
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001173 Current = Current->Next;
Daniel Jasper400adc62013-02-08 15:28:42 +00001174 }
1175
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001176 FormatToken *Current;
Daniel Jasper400adc62013-02-08 15:28:42 +00001177};
1178
Craig Topper318ed7c2013-07-01 04:03:19 +00001179} // end anonymous namespace
1180
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001181void
1182TokenAnnotator::setCommentLineLevels(SmallVectorImpl<AnnotatedLine *> &Lines) {
Craig Topper2145bc02014-05-09 08:15:10 +00001183 const AnnotatedLine *NextNonCommentLine = nullptr;
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001184 for (SmallVectorImpl<AnnotatedLine *>::reverse_iterator I = Lines.rbegin(),
1185 E = Lines.rend();
1186 I != E; ++I) {
1187 if (NextNonCommentLine && (*I)->First->is(tok::comment) &&
Craig Topper2145bc02014-05-09 08:15:10 +00001188 (*I)->First->Next == nullptr)
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001189 (*I)->Level = NextNonCommentLine->Level;
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001190 else
Craig Topper2145bc02014-05-09 08:15:10 +00001191 NextNonCommentLine = (*I)->First->isNot(tok::r_brace) ? (*I) : nullptr;
Daniel Jasperbbf5c1c2013-11-05 19:10:03 +00001192
1193 setCommentLineLevels((*I)->Children);
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001194 }
1195}
1196
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001197void TokenAnnotator::annotate(AnnotatedLine &Line) {
Daniel Jasper1c5d9df2013-09-06 07:54:20 +00001198 for (SmallVectorImpl<AnnotatedLine *>::iterator I = Line.Children.begin(),
1199 E = Line.Children.end();
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001200 I != E; ++I) {
1201 annotate(**I);
1202 }
Daniel Jasper8de9ed02013-08-22 15:00:41 +00001203 AnnotatingParser Parser(Style, Line, Ident_in);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001204 Line.Type = Parser.parseLine();
1205 if (Line.Type == LT_Invalid)
1206 return;
1207
Daniel Jasper400adc62013-02-08 15:28:42 +00001208 ExpressionParser ExprParser(Line);
1209 ExprParser.parse();
1210
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001211 if (Line.First->Type == TT_ObjCMethodSpecifier)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001212 Line.Type = LT_ObjCMethodDecl;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001213 else if (Line.First->Type == TT_ObjCDecl)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001214 Line.Type = LT_ObjCDecl;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001215 else if (Line.First->Type == TT_ObjCProperty)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001216 Line.Type = LT_ObjCProperty;
1217
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001218 Line.First->SpacesRequiredBefore = 1;
1219 Line.First->CanBreakBefore = Line.First->MustBreakBefore;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001220}
1221
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001222// This function heuristically determines whether 'Current' starts the name of a
1223// function declaration.
1224static bool isFunctionDeclarationName(const FormatToken &Current) {
1225 if (Current.Type != TT_StartOfName ||
1226 Current.NestingLevel != 0 ||
1227 Current.Previous->Type == TT_StartOfName)
1228 return false;
1229 const FormatToken *Next = Current.Next;
1230 for (; Next; Next = Next->Next) {
1231 if (Next->Type == TT_TemplateOpener) {
1232 Next = Next->MatchingParen;
1233 } else if (Next->is(tok::coloncolon)) {
1234 Next = Next->Next;
1235 if (!Next || !Next->is(tok::identifier))
1236 return false;
1237 } else if (Next->is(tok::l_paren)) {
1238 break;
1239 } else {
1240 return false;
1241 }
1242 }
1243 if (!Next)
1244 return false;
1245 assert(Next->is(tok::l_paren));
1246 if (Next->Next == Next->MatchingParen)
1247 return true;
1248 for (const FormatToken *Tok = Next->Next; Tok != Next->MatchingParen;
1249 Tok = Tok->Next) {
1250 if (Tok->is(tok::kw_const) || Tok->isSimpleTypeSpecifier() ||
1251 Tok->Type == TT_PointerOrReference || Tok->Type == TT_StartOfName)
1252 return true;
1253 if (Tok->isOneOf(tok::l_brace, tok::string_literal) || Tok->Tok.isLiteral())
1254 return false;
1255 }
1256 return false;
1257}
1258
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001259void TokenAnnotator::calculateFormattingInformation(AnnotatedLine &Line) {
Daniel Jasper5f3ea472014-05-22 08:36:53 +00001260 for (SmallVectorImpl<AnnotatedLine *>::iterator I = Line.Children.begin(),
1261 E = Line.Children.end();
1262 I != E; ++I) {
1263 calculateFormattingInformation(**I);
1264 }
1265
Alexander Kornienko39856b72013-09-10 09:38:25 +00001266 Line.First->TotalLength =
1267 Line.First->IsMultiline ? Style.ColumnLimit : Line.First->ColumnWidth;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001268 if (!Line.First->Next)
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001269 return;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001270 FormatToken *Current = Line.First->Next;
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001271 bool InFunctionDecl = Line.MightBeFunctionDecl;
Craig Topper2145bc02014-05-09 08:15:10 +00001272 while (Current) {
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001273 if (isFunctionDeclarationName(*Current))
1274 Current->Type = TT_FunctionDeclarationName;
Daniel Jasper5a611392013-12-19 21:41:37 +00001275 if (Current->Type == TT_LineComment) {
Daniel Jasper84a12e12014-03-10 15:06:25 +00001276 if (Current->Previous->BlockKind == BK_BracedInit &&
1277 Current->Previous->opensScope())
Daniel Jasper5a611392013-12-19 21:41:37 +00001278 Current->SpacesRequiredBefore = Style.Cpp11BracedListStyle ? 0 : 1;
1279 else
1280 Current->SpacesRequiredBefore = Style.SpacesBeforeTrailingComments;
Daniel Jasper14e58e52014-03-21 11:58:45 +00001281
1282 // If we find a trailing comment, iterate backwards to determine whether
1283 // it seems to relate to a specific parameter. If so, break before that
1284 // parameter to avoid changing the comment's meaning. E.g. don't move 'b'
1285 // to the previous line in:
1286 // SomeFunction(a,
1287 // b, // comment
1288 // c);
Daniel Jasper28df0a32014-03-21 12:15:40 +00001289 if (!Current->HasUnescapedNewline) {
Daniel Jasper14e58e52014-03-21 11:58:45 +00001290 for (FormatToken *Parameter = Current->Previous; Parameter;
1291 Parameter = Parameter->Previous) {
1292 if (Parameter->isOneOf(tok::comment, tok::r_brace))
1293 break;
1294 if (Parameter->Previous && Parameter->Previous->is(tok::comma)) {
1295 if (Parameter->Previous->Type != TT_CtorInitializerComma &&
1296 Parameter->HasUnescapedNewline)
1297 Parameter->MustBreakBefore = true;
1298 break;
1299 }
1300 }
1301 }
Daniel Jasperb88b25f2013-12-23 07:29:06 +00001302 } else if (Current->SpacesRequiredBefore == 0 &&
Daniel Jasper166c19b2014-05-06 14:12:21 +00001303 spaceRequiredBefore(Line, *Current)) {
Alexander Kornienko384b40b2013-10-11 21:43:05 +00001304 Current->SpacesRequiredBefore = 1;
Daniel Jasper5a611392013-12-19 21:41:37 +00001305 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001306
Daniel Jasperfb81b092013-09-17 09:52:48 +00001307 Current->MustBreakBefore =
1308 Current->MustBreakBefore || mustBreakBefore(Line, *Current);
1309
Daniel Jasperca4ea1c2014-08-05 12:16:31 +00001310 if (Style.AlwaysBreakAfterDefinitionReturnType &&
1311 InFunctionDecl && Current->Type == TT_FunctionDeclarationName &&
Daniel Jasperdb764792014-08-14 11:36:03 +00001312 !Line.Last->isOneOf(tok::semi, tok::comment)) // Only for definitions.
1313 // FIXME: Line.Last points to other characters than tok::semi
1314 // and tok::lbrace.
Daniel Jasperca4ea1c2014-08-05 12:16:31 +00001315 Current->MustBreakBefore = true;
1316
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001317 Current->CanBreakBefore =
1318 Current->MustBreakBefore || canBreakBefore(Line, *Current);
Daniel Jasper5f3ea472014-05-22 08:36:53 +00001319 unsigned ChildSize = 0;
1320 if (Current->Previous->Children.size() == 1) {
1321 FormatToken &LastOfChild = *Current->Previous->Children[0]->Last;
1322 ChildSize = LastOfChild.isTrailingComment() ? Style.ColumnLimit
1323 : LastOfChild.TotalLength + 1;
1324 }
1325 if (Current->MustBreakBefore || Current->Previous->Children.size() > 1 ||
Alexander Kornienko39856b72013-09-10 09:38:25 +00001326 Current->IsMultiline)
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001327 Current->TotalLength = Current->Previous->TotalLength + Style.ColumnLimit;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001328 else
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +00001329 Current->TotalLength = Current->Previous->TotalLength +
Daniel Jasper5f3ea472014-05-22 08:36:53 +00001330 Current->ColumnWidth + ChildSize +
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +00001331 Current->SpacesRequiredBefore;
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001332
1333 if (Current->Type == TT_CtorInitializerColon)
1334 InFunctionDecl = false;
1335
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001336 // FIXME: Only calculate this if CanBreakBefore is true once static
1337 // initializers etc. are sorted out.
1338 // FIXME: Move magic numbers to a better place.
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001339 Current->SplitPenalty = 20 * Current->BindingStrength +
1340 splitPenalty(Line, *Current, InFunctionDecl);
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001341
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001342 Current = Current->Next;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001343 }
Daniel Jasper6bee6822013-04-08 20:33:42 +00001344
Manuel Klimek4fe43002013-05-22 12:51:29 +00001345 calculateUnbreakableTailLengths(Line);
Craig Topper2145bc02014-05-09 08:15:10 +00001346 for (Current = Line.First; Current != nullptr; Current = Current->Next) {
Daniel Jasper8de9ed02013-08-22 15:00:41 +00001347 if (Current->Role)
1348 Current->Role->precomputeFormattingInfos(Current);
1349 }
1350
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001351 DEBUG({ printDebugInfo(Line); });
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001352}
1353
Manuel Klimek4fe43002013-05-22 12:51:29 +00001354void TokenAnnotator::calculateUnbreakableTailLengths(AnnotatedLine &Line) {
1355 unsigned UnbreakableTailLength = 0;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001356 FormatToken *Current = Line.Last;
Craig Topper2145bc02014-05-09 08:15:10 +00001357 while (Current) {
Manuel Klimek4fe43002013-05-22 12:51:29 +00001358 Current->UnbreakableTailLength = UnbreakableTailLength;
1359 if (Current->CanBreakBefore ||
1360 Current->isOneOf(tok::comment, tok::string_literal)) {
1361 UnbreakableTailLength = 0;
1362 } else {
1363 UnbreakableTailLength +=
Alexander Kornienko39856b72013-09-10 09:38:25 +00001364 Current->ColumnWidth + Current->SpacesRequiredBefore;
Manuel Klimek4fe43002013-05-22 12:51:29 +00001365 }
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001366 Current = Current->Previous;
Manuel Klimek4fe43002013-05-22 12:51:29 +00001367 }
1368}
1369
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001370unsigned TokenAnnotator::splitPenalty(const AnnotatedLine &Line,
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001371 const FormatToken &Tok,
1372 bool InFunctionDecl) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001373 const FormatToken &Left = *Tok.Previous;
1374 const FormatToken &Right = Tok;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001375
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00001376 if (Left.is(tok::semi))
1377 return 0;
Daniel Jasper783bac62014-04-15 09:54:30 +00001378 if (Left.is(tok::comma) || (Right.is(tok::identifier) && Right.Next &&
1379 Right.Next->Type == TT_DictLiteral))
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00001380 return 1;
Daniel Jasper7052ce62014-01-19 09:04:08 +00001381 if (Right.is(tok::l_square)) {
1382 if (Style.Language == FormatStyle::LK_Proto)
1383 return 1;
Daniel Jaspera2fb50f2014-06-24 09:15:49 +00001384 if (Right.Type != TT_ObjCMethodExpr && Right.Type != TT_LambdaLSquare)
Daniel Jasperecaba172014-06-10 13:27:57 +00001385 return 500;
Daniel Jasper7052ce62014-01-19 09:04:08 +00001386 }
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001387 if (Right.Type == TT_StartOfName ||
1388 Right.Type == TT_FunctionDeclarationName || Right.is(tok::kw_operator)) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001389 if (Line.First->is(tok::kw_for) && Right.PartOfMultiVariableDeclStmt)
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001390 return 3;
Daniel Jasper40db06a2013-07-11 12:34:23 +00001391 if (Left.Type == TT_StartOfName)
1392 return 20;
Daniel Jasper63af7c42013-12-09 14:40:19 +00001393 if (InFunctionDecl && Right.NestingLevel == 0)
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001394 return Style.PenaltyReturnTypeOnItsOwnLine;
Daniel Jasper53643062013-08-19 10:16:18 +00001395 return 200;
Daniel Jasper26d1b1d2013-02-24 18:54:32 +00001396 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001397 if (Left.is(tok::equal) && Right.is(tok::l_brace))
1398 return 150;
Daniel Jasper1bc1b502013-07-05 07:58:34 +00001399 if (Left.Type == TT_CastRParen)
1400 return 100;
Daniel Jasper215d6c82014-01-22 08:04:52 +00001401 if (Left.is(tok::coloncolon) ||
1402 (Right.is(tok::period) && Style.Language == FormatStyle::LK_Proto))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001403 return 500;
Daniel Jasper83193602013-04-05 17:22:09 +00001404 if (Left.isOneOf(tok::kw_class, tok::kw_struct))
1405 return 5000;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001406
Daniel Jaspereead02b2013-02-14 08:42:54 +00001407 if (Left.Type == TT_RangeBasedForLoopColon ||
1408 Left.Type == TT_InheritanceColon)
Daniel Jasper16b35622013-02-26 13:18:08 +00001409 return 2;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001410
Daniel Jasper4c6e0052013-08-27 14:24:43 +00001411 if (Right.isMemberAccess()) {
Daniel Jasper4d7a97a2014-01-10 08:40:17 +00001412 if (Left.is(tok::r_paren) && Left.MatchingParen &&
Daniel Jasper36c28ce2013-09-06 08:54:24 +00001413 Left.MatchingParen->ParameterCount > 0)
Daniel Jasper70bc8742013-02-26 13:59:14 +00001414 return 20; // Should be smaller than breaking at a nested comma.
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001415 return 150;
1416 }
1417
Daniel Jaspere3f907f2014-06-02 09:52:08 +00001418 if (Right.Type == TT_TrailingAnnotation &&
1419 (!Right.Next || Right.Next->isNot(tok::l_paren))) {
Daniel Jasper5550de62014-02-17 07:57:46 +00001420 // Generally, breaking before a trailing annotation is bad unless it is
1421 // function-like. It seems to be especially preferable to keep standard
1422 // annotations (i.e. "const", "final" and "override") on the same line.
Daniel Jasper43e6a282013-12-16 15:01:54 +00001423 // Use a slightly higher penalty after ")" so that annotations like
1424 // "const override" are kept together.
Daniel Jasperb48d3af2014-04-09 10:01:49 +00001425 bool is_short_annotation = Right.TokenText.size() < 10;
Daniel Jasperb05a81d2014-05-09 13:11:16 +00001426 return (Left.is(tok::r_paren) ? 100 : 120) + (is_short_annotation ? 50 : 0);
Daniel Jasper43e6a282013-12-16 15:01:54 +00001427 }
Daniel Jasper13c37b32013-05-22 08:28:26 +00001428
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001429 // In for-loops, prefer breaking at ',' and ';'.
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001430 if (Line.First->is(tok::kw_for) && Left.is(tok::equal))
Daniel Jasper37905f72013-02-21 15:00:29 +00001431 return 4;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001432
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001433 // In Objective-C method expressions, prefer breaking before "param:" over
1434 // breaking after it.
Daniel Jasper17062ff2014-06-10 14:44:02 +00001435 if (Right.Type == TT_SelectorName)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001436 return 0;
Daniel Jasper1ac3e052013-02-05 10:07:47 +00001437 if (Left.is(tok::colon) && Left.Type == TT_ObjCMethodExpr)
Daniel Jasper4bf0d802013-11-23 14:27:27 +00001438 return Line.MightBeFunctionDecl ? 50 : 500;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001439
Daniel Jasper4fcc8b92013-11-07 17:52:51 +00001440 if (Left.is(tok::l_paren) && InFunctionDecl)
Daniel Jasper6728fc12013-04-11 14:29:13 +00001441 return 100;
Daniel Jasper126153a2013-12-27 06:39:56 +00001442 if (Left.is(tok::equal) && InFunctionDecl)
1443 return 110;
Daniel Jaspera5621202014-08-08 12:00:13 +00001444 if (Right.is(tok::r_brace))
1445 return 1;
Daniel Jasperea79ea12014-08-15 05:00:39 +00001446 if (Left.Type == TT_TemplateOpener)
1447 return 100;
Daniel Jasperc04baae2013-04-10 09:49:49 +00001448 if (Left.opensScope())
Daniel Jasper33b909c2013-10-25 14:29:37 +00001449 return Left.ParameterCount > 1 ? Style.PenaltyBreakBeforeFirstCallParameter
1450 : 19;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001451
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001452 if (Right.is(tok::lessless)) {
1453 if (Left.is(tok::string_literal)) {
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001454 StringRef Content = Left.TokenText;
Daniel Jasper0b1f76b2013-09-29 12:02:57 +00001455 if (Content.startswith("\""))
1456 Content = Content.drop_front(1);
1457 if (Content.endswith("\""))
1458 Content = Content.drop_back(1);
1459 Content = Content.trim();
Daniel Jasperf38a0ac2013-03-14 14:00:17 +00001460 if (Content.size() > 1 &&
1461 (Content.back() == ':' || Content.back() == '='))
Daniel Jasperfa21c072013-07-15 14:33:14 +00001462 return 25;
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001463 }
Daniel Jasper49a94482013-07-15 15:04:42 +00001464 return 1; // Breaking at a << is really cheap.
Daniel Jasperba9ddb62013-02-06 21:04:05 +00001465 }
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001466 if (Left.Type == TT_ConditionalExpr)
Daniel Jasper70bc8742013-02-26 13:59:14 +00001467 return prec::Conditional;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001468 prec::Level Level = Left.getPrecedence();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001469
1470 if (Level != prec::Unknown)
1471 return Level;
Daniel Jasperf9a84b52013-03-01 16:48:32 +00001472
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001473 return 3;
1474}
1475
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001476bool TokenAnnotator::spaceRequiredBetween(const AnnotatedLine &Line,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001477 const FormatToken &Left,
1478 const FormatToken &Right) {
Daniel Jasper7052ce62014-01-19 09:04:08 +00001479 if (Style.Language == FormatStyle::LK_Proto) {
Daniel Jasper9c2820c2014-06-23 07:36:25 +00001480 if (Right.is(tok::period) &&
1481 (Left.TokenText == "optional" || Left.TokenText == "required" ||
1482 Left.TokenText == "repeated"))
1483 return true;
Daniel Jasper929b1db2014-01-20 16:47:22 +00001484 if (Right.is(tok::l_paren) &&
1485 (Left.TokenText == "returns" || Left.TokenText == "option"))
Daniel Jasper7052ce62014-01-19 09:04:08 +00001486 return true;
Daniel Jasper0dd52912014-05-19 07:37:07 +00001487 } else if (Style.Language == FormatStyle::LK_JavaScript) {
1488 if (Left.TokenText == "var")
1489 return true;
Daniel Jasper7052ce62014-01-19 09:04:08 +00001490 }
Daniel Jasper166c19b2014-05-06 14:12:21 +00001491 if (Left.is(tok::kw_return) && Right.isNot(tok::semi))
1492 return true;
Daniel Jaspere9beea22014-01-28 15:20:33 +00001493 if (Style.ObjCSpaceAfterProperty && Line.Type == LT_ObjCProperty &&
1494 Left.Tok.getObjCKeywordID() == tok::objc_property)
1495 return true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001496 if (Right.is(tok::hashhash))
1497 return Left.is(tok::hash);
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001498 if (Left.isOneOf(tok::hashhash, tok::hash))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001499 return Right.is(tok::hash);
Daniel Jasperb55acad2013-08-20 12:36:34 +00001500 if (Left.is(tok::l_paren) && Right.is(tok::r_paren))
1501 return Style.SpaceInEmptyParentheses;
1502 if (Left.is(tok::l_paren) || Right.is(tok::r_paren))
Daniel Jasperf110e202013-08-21 08:39:01 +00001503 return (Right.Type == TT_CastRParen ||
1504 (Left.MatchingParen && Left.MatchingParen->Type == TT_CastRParen))
Daniel Jasperb55acad2013-08-20 12:36:34 +00001505 ? Style.SpacesInCStyleCastParentheses
1506 : Style.SpacesInParentheses;
Daniel Jasperdd978ae2013-10-29 14:52:02 +00001507 if (Style.SpacesInAngles &&
1508 ((Left.Type == TT_TemplateOpener) != (Right.Type == TT_TemplateCloser)))
1509 return true;
Daniel Jasperb55acad2013-08-20 12:36:34 +00001510 if (Right.isOneOf(tok::semi, tok::comma))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001511 return false;
1512 if (Right.is(tok::less) &&
Daniel Jasperdcf37fb2014-08-01 13:03:05 +00001513 (Left.isOneOf(tok::kw_template, tok::r_paren) ||
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001514 (Line.Type == LT_ObjCDecl && Style.ObjCSpaceBeforeProtocolList)))
1515 return true;
1516 if (Left.is(tok::arrow) || Right.is(tok::arrow))
1517 return false;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001518 if (Left.isOneOf(tok::exclaim, tok::tilde))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001519 return false;
1520 if (Left.is(tok::at) &&
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001521 Right.isOneOf(tok::identifier, tok::string_literal, tok::char_constant,
1522 tok::numeric_constant, tok::l_paren, tok::l_brace,
1523 tok::kw_true, tok::kw_false))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001524 return false;
1525 if (Left.is(tok::coloncolon))
1526 return false;
Daniel Jasper7620b662014-01-08 15:41:13 +00001527 if (Right.is(tok::coloncolon) && Left.isNot(tok::l_brace))
Daniel Jasperfba84ff2013-10-12 05:16:06 +00001528 return (Left.is(tok::less) && Style.Standard == FormatStyle::LS_Cpp03) ||
1529 !Left.isOneOf(tok::identifier, tok::greater, tok::l_paren,
1530 tok::r_paren, tok::less);
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001531 if (Left.is(tok::less) || Right.isOneOf(tok::greater, tok::less))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001532 return false;
Daniel Jasperbafa6b72013-07-01 09:47:25 +00001533 if (Right.is(tok::ellipsis))
Daniel Jasper2d0cd492013-10-20 16:56:16 +00001534 return Left.Tok.isLiteral();
Manuel Klimekbab25fd2013-09-04 08:20:47 +00001535 if (Left.is(tok::l_square) && Right.is(tok::amp))
1536 return false;
Alexander Kornienkoa5151272013-03-12 16:28:18 +00001537 if (Right.Type == TT_PointerOrReference)
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001538 return Left.Tok.isLiteral() ||
Alexander Kornienkoa5151272013-03-12 16:28:18 +00001539 ((Left.Type != TT_PointerOrReference) && Left.isNot(tok::l_paren) &&
Daniel Jasper553d4872014-06-17 12:40:34 +00001540 Style.PointerAlignment != FormatStyle::PAS_Left);
Daniel Jasper4d03d3b2013-05-28 15:27:10 +00001541 if (Right.Type == TT_FunctionTypeLParen && Left.isNot(tok::l_paren) &&
Daniel Jasperdcf37fb2014-08-01 13:03:05 +00001542 (Left.Type != TT_PointerOrReference ||
1543 Style.PointerAlignment != FormatStyle::PAS_Right))
Daniel Jaspercfda5172013-05-08 14:58:20 +00001544 return true;
Alexander Kornienkoa5151272013-03-12 16:28:18 +00001545 if (Left.Type == TT_PointerOrReference)
Daniel Jasper022612d2013-07-01 09:34:09 +00001546 return Right.Tok.isLiteral() || Right.Type == TT_BlockComment ||
Daniel Jasperb8914dd2013-03-20 09:53:18 +00001547 ((Right.Type != TT_PointerOrReference) &&
Daniel Jasperdcf37fb2014-08-01 13:03:05 +00001548 Right.isNot(tok::l_paren) &&
1549 Style.PointerAlignment != FormatStyle::PAS_Right && Left.Previous &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001550 !Left.Previous->isOneOf(tok::l_paren, tok::coloncolon));
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001551 if (Right.is(tok::star) && Left.is(tok::l_paren))
1552 return false;
Nico Weber2a726b62013-02-10 02:08:05 +00001553 if (Left.is(tok::l_square))
Daniel Jasperad981f82014-08-26 11:41:14 +00001554 return (Left.Type == TT_ArrayInitializerLSquare &&
1555 Style.SpacesInContainerLiterals && Right.isNot(tok::r_square)) ||
1556 (Left.Type == TT_ArraySubscriptLSquare &&
1557 Style.SpacesInSquareBrackets && Right.isNot(tok::r_square));
Nico Weber2a726b62013-02-10 02:08:05 +00001558 if (Right.is(tok::r_square))
Daniel Jasperad981f82014-08-26 11:41:14 +00001559 return Right.MatchingParen &&
1560 ((Style.SpacesInContainerLiterals &&
1561 Right.MatchingParen->Type == TT_ArrayInitializerLSquare) ||
1562 (Style.SpacesInSquareBrackets &&
1563 Right.MatchingParen->Type == TT_ArraySubscriptLSquare));
Daniel Jasper8ddfa842013-08-30 10:36:58 +00001564 if (Right.is(tok::l_square) && Right.Type != TT_ObjCMethodExpr &&
Daniel Jasper89519082014-05-09 10:26:08 +00001565 Right.Type != TT_LambdaLSquare && Left.isNot(tok::numeric_constant) &&
1566 Left.Type != TT_DictLiteral)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001567 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001568 if (Left.is(tok::colon))
1569 return Left.Type != TT_ObjCMethodExpr;
Daniel Jasper610381f2014-08-26 09:37:52 +00001570 if (Left.is(tok::l_brace) && Right.is(tok::r_brace))
1571 return !Left.Children.empty(); // No spaces in "{}".
1572 if ((Left.is(tok::l_brace) && Left.BlockKind != BK_Block) ||
1573 (Right.is(tok::r_brace) && Right.MatchingParen &&
1574 Right.MatchingParen->BlockKind != BK_Block))
1575 return !Style.Cpp11BracedListStyle;
Daniel Jasper484033b2014-05-06 14:41:29 +00001576 if (Left.Type == TT_BlockComment)
1577 return !Left.TokenText.endswith("=*/");
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001578 if (Right.is(tok::l_paren)) {
Daniel Jasper559b63c2014-01-28 20:13:43 +00001579 if (Left.is(tok::r_paren) && Left.Type == TT_AttributeParen)
Daniel Jasperee6d6502013-07-17 20:25:02 +00001580 return true;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001581 return Line.Type == LT_ObjCDecl ||
Daniel Jasper166c19b2014-05-06 14:12:21 +00001582 Left.isOneOf(tok::kw_new, tok::kw_delete, tok::semi) ||
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00001583 (Style.SpaceBeforeParens != FormatStyle::SBPO_Never &&
Daniel Jaspere1e43192014-04-01 12:55:11 +00001584 (Left.isOneOf(tok::kw_if, tok::kw_for, tok::kw_while,
Daniel Jasper031e2402014-04-28 07:48:36 +00001585 tok::kw_switch, tok::kw_catch, tok::kw_case) ||
Daniel Jaspere1e43192014-04-01 12:55:11 +00001586 Left.IsForEachMacro)) ||
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00001587 (Style.SpaceBeforeParens == FormatStyle::SBPO_Always &&
Daniel Jasper78b194992014-08-06 14:15:41 +00001588 (Left.is(tok::identifier) || Left.isFunctionLikeKeyword()) &&
Alexander Kornienkofdca83d2013-12-10 10:18:34 +00001589 Line.Type != LT_PreprocessorDirective);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001590 }
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001591 if (Left.is(tok::at) && Right.Tok.getObjCKeywordID() != tok::objc_not_keyword)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001592 return false;
Daniel Jasper5bd0b9e2013-05-23 18:05:18 +00001593 if (Right.Type == TT_UnaryOperator)
1594 return !Left.isOneOf(tok::l_paren, tok::l_square, tok::at) &&
1595 (Left.isNot(tok::colon) || Left.Type != TT_ObjCMethodExpr);
Daniel Jasper4afc6b32014-06-02 10:57:55 +00001596 if ((Left.isOneOf(tok::identifier, tok::greater, tok::r_square,
1597 tok::r_paren) ||
Daniel Jasper7a2d60e2014-05-07 07:59:03 +00001598 Left.isSimpleTypeSpecifier()) &&
Manuel Klimekbab25fd2013-09-04 08:20:47 +00001599 Right.is(tok::l_brace) && Right.getNextNonComment() &&
1600 Right.BlockKind != BK_Block)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001601 return false;
Daniel Jasperbca4bbe2013-05-28 11:30:49 +00001602 if (Left.is(tok::period) || Right.is(tok::period))
1603 return false;
Alexander Kornienkod8d47fa2013-09-10 13:41:43 +00001604 if (Right.is(tok::hash) && Left.is(tok::identifier) && Left.TokenText == "L")
1605 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001606 return true;
1607}
1608
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001609bool TokenAnnotator::spaceRequiredBefore(const AnnotatedLine &Line,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001610 const FormatToken &Tok) {
1611 if (Tok.Tok.getIdentifierInfo() && Tok.Previous->Tok.getIdentifierInfo())
Daniel Jasper35d2dc72013-02-11 08:01:18 +00001612 return true; // Never ever merge two identifiers.
Daniel Jasper877615c2013-10-11 19:45:02 +00001613 if (Tok.Previous->Type == TT_ImplicitStringLiteral)
1614 return Tok.WhitespaceRange.getBegin() != Tok.WhitespaceRange.getEnd();
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001615 if (Line.Type == LT_ObjCMethodDecl) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001616 if (Tok.Previous->Type == TT_ObjCMethodSpecifier)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001617 return true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001618 if (Tok.Previous->is(tok::r_paren) && Tok.is(tok::identifier))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001619 // Don't space between ')' and <id>
1620 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001621 }
1622 if (Line.Type == LT_ObjCProperty &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001623 (Tok.is(tok::equal) || Tok.Previous->is(tok::equal)))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001624 return false;
1625
Daniel Jasper6cdec7c2013-07-09 14:36:48 +00001626 if (Tok.Type == TT_TrailingReturnArrow ||
1627 Tok.Previous->Type == TT_TrailingReturnArrow)
1628 return true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001629 if (Tok.Previous->is(tok::comma))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001630 return true;
Daniel Jasperff6c3a92013-02-28 13:40:17 +00001631 if (Tok.is(tok::comma))
1632 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001633 if (Tok.Type == TT_CtorInitializerColon || Tok.Type == TT_ObjCBlockLParen)
1634 return true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001635 if (Tok.Previous->Tok.is(tok::kw_operator))
Daniel Jasperedc5f092013-10-29 12:24:23 +00001636 return Tok.is(tok::coloncolon);
Daniel Jasper35d2dc72013-02-11 08:01:18 +00001637 if (Tok.Type == TT_OverloadedOperatorLParen)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001638 return false;
1639 if (Tok.is(tok::colon))
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001640 return !Line.First->isOneOf(tok::kw_case, tok::kw_default) &&
Daniel Jasperb05a81d2014-05-09 13:11:16 +00001641 Tok.getNextNonComment() && Tok.Type != TT_ObjCMethodExpr &&
1642 !Tok.Previous->is(tok::question) &&
Daniel Jasperb2e10a52014-01-15 15:09:08 +00001643 (Tok.Type != TT_DictLiteral || Style.SpacesInContainerLiterals);
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001644 if (Tok.Previous->Type == TT_UnaryOperator ||
1645 Tok.Previous->Type == TT_CastRParen)
Daniel Jasperff974ab2014-01-25 09:16:02 +00001646 return Tok.Type == TT_BinaryOperator;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001647 if (Tok.Previous->is(tok::greater) && Tok.is(tok::greater)) {
Daniel Jasper400adc62013-02-08 15:28:42 +00001648 return Tok.Type == TT_TemplateCloser &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001649 Tok.Previous->Type == TT_TemplateCloser &&
Daniel Jasperdd978ae2013-10-29 14:52:02 +00001650 (Style.Standard != FormatStyle::LS_Cpp11 || Style.SpacesInAngles);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001651 }
Alexander Kornienko674be0a2013-03-20 16:41:56 +00001652 if (Tok.isOneOf(tok::arrowstar, tok::periodstar) ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001653 Tok.Previous->isOneOf(tok::arrowstar, tok::periodstar))
Daniel Jasperff6c3a92013-02-28 13:40:17 +00001654 return false;
Daniel Jasperd94bff32013-09-25 15:15:02 +00001655 if (!Style.SpaceBeforeAssignmentOperators &&
1656 Tok.getPrecedence() == prec::Assignment)
1657 return false;
Daniel Jasper9613c812013-08-07 16:29:23 +00001658 if ((Tok.Type == TT_BinaryOperator && !Tok.Previous->is(tok::l_paren)) ||
Daniel Jasperc0d606a2014-04-14 11:08:45 +00001659 Tok.Previous->Type == TT_BinaryOperator ||
1660 Tok.Previous->Type == TT_ConditionalExpr)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001661 return true;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001662 if (Tok.Previous->Type == TT_TemplateCloser && Tok.is(tok::l_paren))
Chad Rosier0a84f172014-08-05 17:58:54 +00001663 return Style.SpaceBeforeParens == FormatStyle::SBPO_Always;
Daniel Jaspered8f1c62013-08-28 08:24:04 +00001664 if (Tok.is(tok::less) && Tok.Previous->isNot(tok::l_paren) &&
1665 Line.First->is(tok::hash))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001666 return true;
1667 if (Tok.Type == TT_TrailingUnaryOperator)
1668 return false;
Daniel Jasperf9ae3122014-05-08 07:01:45 +00001669 if (Tok.Previous->Type == TT_RegexLiteral)
1670 return false;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001671 return spaceRequiredBetween(Line, *Tok.Previous, Tok);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001672}
1673
Daniel Jaspere18ff372014-06-02 10:17:32 +00001674// Returns 'true' if 'Tok' is a brace we'd want to break before in Allman style.
1675static bool isAllmanBrace(const FormatToken &Tok) {
1676 return Tok.is(tok::l_brace) && Tok.BlockKind == BK_Block &&
1677 Tok.Type != TT_ObjCBlockLBrace && Tok.Type != TT_DictLiteral;
1678}
1679
Daniel Jasperfb81b092013-09-17 09:52:48 +00001680bool TokenAnnotator::mustBreakBefore(const AnnotatedLine &Line,
1681 const FormatToken &Right) {
Daniel Jaspera125d532014-03-21 12:38:57 +00001682 const FormatToken &Left = *Right.Previous;
Daniel Jaspera69ca9b2014-06-04 12:40:57 +00001683 if (Right.NewlinesBefore > 1)
1684 return true;
Daniel Jasperfb81b092013-09-17 09:52:48 +00001685 if (Right.is(tok::comment)) {
Daniel Jasper5a611392013-12-19 21:41:37 +00001686 return Right.Previous->BlockKind != BK_BracedInit &&
Daniel Jasperf6c7c182014-01-13 14:10:04 +00001687 Right.Previous->Type != TT_CtorInitializerColon &&
Manuel Klimek1fcbe672014-04-11 12:27:47 +00001688 (Right.NewlinesBefore > 0 && Right.HasUnescapedNewline);
Daniel Jasperfb81b092013-09-17 09:52:48 +00001689 } else if (Right.Previous->isTrailingComment() ||
Daniel Jasper04b6a082013-12-20 06:22:01 +00001690 (Right.isStringLiteral() && Right.Previous->isStringLiteral())) {
Daniel Jasperfb81b092013-09-17 09:52:48 +00001691 return true;
1692 } else if (Right.Previous->IsUnterminatedLiteral) {
1693 return true;
1694 } else if (Right.is(tok::lessless) && Right.Next &&
1695 Right.Previous->is(tok::string_literal) &&
1696 Right.Next->is(tok::string_literal)) {
1697 return true;
1698 } else if (Right.Previous->ClosesTemplateDeclaration &&
1699 Right.Previous->MatchingParen &&
Daniel Jasper63af7c42013-12-09 14:40:19 +00001700 Right.Previous->MatchingParen->NestingLevel == 0 &&
Daniel Jasperfb81b092013-09-17 09:52:48 +00001701 Style.AlwaysBreakTemplateDeclarations) {
Daniel Jasperfb81b092013-09-17 09:52:48 +00001702 return true;
Alexander Kornienkoa594ba82013-12-16 14:35:51 +00001703 } else if ((Right.Type == TT_CtorInitializerComma ||
1704 Right.Type == TT_CtorInitializerColon) &&
Daniel Jasperec01cd62013-10-08 05:11:18 +00001705 Style.BreakConstructorInitializersBeforeComma &&
1706 !Style.ConstructorInitializerAllOnOneLineOrOnePerLine) {
Daniel Jasperfb81b092013-09-17 09:52:48 +00001707 return true;
Daniel Jasperc39b56f2013-12-16 07:23:08 +00001708 } else if (Right.is(tok::string_literal) &&
1709 Right.TokenText.startswith("R\"")) {
1710 // Raw string literals are special wrt. line breaks. The author has made a
1711 // deliberate choice and might have aligned the contents of the string
1712 // literal accordingly. Thus, we try keep existing line breaks.
1713 return Right.NewlinesBefore > 0;
Daniel Jasper6e58fee2014-01-29 18:43:40 +00001714 } else if (Right.Previous->is(tok::l_brace) && Right.NestingLevel == 1 &&
Daniel Jasper7052ce62014-01-19 09:04:08 +00001715 Style.Language == FormatStyle::LK_Proto) {
1716 // Don't enums onto single lines in protocol buffers.
1717 return true;
Daniel Jaspere18ff372014-06-02 10:17:32 +00001718 } else if (isAllmanBrace(Left) || isAllmanBrace(Right)) {
1719 return Style.BreakBeforeBraces == FormatStyle::BS_Allman ||
1720 Style.BreakBeforeBraces == FormatStyle::BS_GNU;
Daniel Jaspera382cbe2014-07-28 14:08:09 +00001721 } else if (Style.Language == FormatStyle::LK_Proto &&
1722 Left.isNot(tok::l_brace) && Right.Type == TT_SelectorName) {
1723 return true;
Daniel Jasperfb81b092013-09-17 09:52:48 +00001724 }
Daniel Jasperb175d572014-04-09 09:53:23 +00001725
Daniel Jasper610381f2014-08-26 09:37:52 +00001726 // If the last token before a '}' is a comma or a trailing comment, the
1727 // intention is to insert a line break after it in order to make shuffling
1728 // around entries easier.
Daniel Jasperb175d572014-04-09 09:53:23 +00001729 const FormatToken *BeforeClosingBrace = nullptr;
1730 if (Left.is(tok::l_brace) && Left.MatchingParen)
Daniel Jasperf9fc2152014-04-09 13:18:49 +00001731 BeforeClosingBrace = Left.MatchingParen->Previous;
Daniel Jasperb175d572014-04-09 09:53:23 +00001732 else if (Right.is(tok::r_brace))
Daniel Jasperf9fc2152014-04-09 13:18:49 +00001733 BeforeClosingBrace = Right.Previous;
Daniel Jasper610381f2014-08-26 09:37:52 +00001734 if (BeforeClosingBrace && (BeforeClosingBrace->is(tok::comma) ||
1735 BeforeClosingBrace->isTrailingComment()))
Daniel Jasperb175d572014-04-09 09:53:23 +00001736 return true;
1737
Daniel Jasper49802ef2014-05-22 09:10:04 +00001738 if (Style.Language == FormatStyle::LK_JavaScript) {
1739 // FIXME: This might apply to other languages and token kinds.
1740 if (Right.is(tok::char_constant) && Left.is(tok::plus) && Left.Previous &&
1741 Left.Previous->is(tok::char_constant))
1742 return true;
1743 }
1744
Daniel Jasperfb81b092013-09-17 09:52:48 +00001745 return false;
1746}
1747
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001748bool TokenAnnotator::canBreakBefore(const AnnotatedLine &Line,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001749 const FormatToken &Right) {
1750 const FormatToken &Left = *Right.Previous;
Daniel Jasper4bf0d802013-11-23 14:27:27 +00001751 if (Left.is(tok::at))
1752 return false;
Daniel Jasper437c3f52014-04-28 07:34:48 +00001753 if (Left.Tok.getObjCKeywordID() == tok::objc_interface)
1754 return false;
Daniel Jasper4355e7f2014-07-09 07:50:33 +00001755 if (Right.Type == TT_StartOfName ||
1756 Right.Type == TT_FunctionDeclarationName || Right.is(tok::kw_operator))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001757 return true;
Daniel Jasper165b29e2013-11-08 00:57:11 +00001758 if (Right.isTrailingComment())
1759 // We rely on MustBreakBefore being set correctly here as we should not
1760 // change the "binding" behavior of a comment.
Daniel Jasper5a611392013-12-19 21:41:37 +00001761 // The first comment in a braced lists is always interpreted as belonging to
1762 // the first list element. Otherwise, it should be placed outside of the
1763 // list.
1764 return Left.BlockKind == BK_BracedInit;
Daniel Jasper165b29e2013-11-08 00:57:11 +00001765 if (Left.is(tok::question) && Right.is(tok::colon))
1766 return false;
1767 if (Right.Type == TT_ConditionalExpr || Right.is(tok::question))
1768 return Style.BreakBeforeTernaryOperators;
1769 if (Left.Type == TT_ConditionalExpr || Left.is(tok::question))
1770 return !Style.BreakBeforeTernaryOperators;
Daniel Jasper3a122c02014-02-14 18:22:40 +00001771 if (Right.Type == TT_InheritanceColon)
1772 return true;
Daniel Jasperd39312ec2014-05-28 10:09:11 +00001773 if (Right.is(tok::colon) && (Right.Type != TT_CtorInitializerColon &&
1774 Right.Type != TT_InlineASMColon))
1775 return false;
Nico Weberced7d412013-05-26 05:39:26 +00001776 if (Left.is(tok::colon) &&
Daniel Jasperb596fb22013-10-24 10:31:50 +00001777 (Left.Type == TT_DictLiteral || Left.Type == TT_ObjCMethodExpr))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001778 return true;
Daniel Jasper17062ff2014-06-10 14:44:02 +00001779 if (Right.Type == TT_SelectorName)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001780 return true;
Daniel Jasper9688ff12013-08-01 13:46:58 +00001781 if (Left.is(tok::r_paren) && Line.Type == LT_ObjCProperty)
1782 return true;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001783 if (Left.ClosesTemplateDeclaration)
1784 return true;
Daniel Jaspereead02b2013-02-14 08:42:54 +00001785 if (Right.Type == TT_RangeBasedForLoopColon ||
Daniel Jasperd215b8b2013-08-28 07:27:35 +00001786 Right.Type == TT_OverloadedOperatorLParen ||
1787 Right.Type == TT_OverloadedOperator)
Daniel Jaspereead02b2013-02-14 08:42:54 +00001788 return false;
Daniel Jaspera61aefb2013-05-06 06:45:09 +00001789 if (Left.Type == TT_RangeBasedForLoopColon)
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001790 return true;
Daniel Jasper37905f72013-02-21 15:00:29 +00001791 if (Right.Type == TT_RangeBasedForLoopColon)
1792 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001793 if (Left.Type == TT_PointerOrReference || Left.Type == TT_TemplateCloser ||
Daniel Jasper165b29e2013-11-08 00:57:11 +00001794 Left.Type == TT_UnaryOperator || Left.is(tok::kw_operator))
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001795 return false;
1796 if (Left.is(tok::equal) && Line.Type == LT_VirtualFunctionDecl)
1797 return false;
Daniel Jasper559b63c2014-01-28 20:13:43 +00001798 if (Left.is(tok::l_paren) && Left.Type == TT_AttributeParen)
1799 return false;
1800 if (Left.is(tok::l_paren) && Left.Previous &&
1801 (Left.Previous->Type == TT_BinaryOperator ||
Daniel Jasper8acf8222014-05-07 09:23:05 +00001802 Left.Previous->Type == TT_CastRParen || Left.Previous->is(tok::kw_if)))
Daniel Jasper559b63c2014-01-28 20:13:43 +00001803 return false;
Daniel Jasper98857842013-10-30 13:54:53 +00001804 if (Right.Type == TT_ImplicitStringLiteral)
1805 return false;
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001806
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001807 if (Right.is(tok::r_paren) || Right.Type == TT_TemplateCloser)
1808 return false;
1809
Daniel Jasper13c37b32013-05-22 08:28:26 +00001810 // We only break before r_brace if there was a corresponding break before
1811 // the l_brace, which is tracked by BreakBeforeClosingBrace.
Daniel Jasper9fe0e8d2013-09-05 09:29:45 +00001812 if (Right.is(tok::r_brace))
1813 return Right.MatchingParen && Right.MatchingParen->BlockKind == BK_Block;
Daniel Jasper13c37b32013-05-22 08:28:26 +00001814
Daniel Jasperf9a09062014-04-09 10:29:11 +00001815 // Allow breaking after a trailing annotation, e.g. after a method
1816 // declaration.
1817 if (Left.Type == TT_TrailingAnnotation)
1818 return !Right.isOneOf(tok::l_brace, tok::semi, tok::equal, tok::l_paren,
1819 tok::less, tok::coloncolon);
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001820
Daniel Jasperbf4755b2013-03-14 09:50:46 +00001821 if (Right.is(tok::kw___attribute))
1822 return true;
1823
Daniel Jasperaf5ba0e2013-02-23 07:46:38 +00001824 if (Left.is(tok::identifier) && Right.is(tok::string_literal))
1825 return true;
Daniel Jaspere33d4af2013-07-26 16:56:36 +00001826
Daniel Jasper783bac62014-04-15 09:54:30 +00001827 if (Right.is(tok::identifier) && Right.Next &&
1828 Right.Next->Type == TT_DictLiteral)
1829 return true;
1830
Daniel Jaspere33d4af2013-07-26 16:56:36 +00001831 if (Left.Type == TT_CtorInitializerComma &&
1832 Style.BreakConstructorInitializersBeforeComma)
1833 return false;
Daniel Jasperec01cd62013-10-08 05:11:18 +00001834 if (Right.Type == TT_CtorInitializerComma &&
1835 Style.BreakConstructorInitializersBeforeComma)
1836 return true;
Daniel Jasper0de8efa2013-09-17 08:15:46 +00001837 if (Left.is(tok::greater) && Right.is(tok::greater) &&
1838 Left.Type != TT_TemplateCloser)
1839 return false;
Daniel Jasper0a1e5ac2014-05-13 08:01:47 +00001840 if (Right.Type == TT_BinaryOperator && Style.BreakBeforeBinaryOperators)
1841 return true;
Daniel Jasper1db6c382013-10-22 15:30:28 +00001842 if (Left.Type == TT_ArrayInitializerLSquare)
1843 return true;
Daniel Jasper598dd332014-08-12 13:22:26 +00001844 if (Right.is(tok::kw_typename) && Left.isNot(tok::kw_const))
1845 return true;
Daniel Jasper85bcadc2014-07-09 13:07:57 +00001846 return (Left.isBinaryOperator() &&
1847 !Left.isOneOf(tok::arrowstar, tok::lessless) &&
Daniel Jaspere33d4af2013-07-26 16:56:36 +00001848 !Style.BreakBeforeBinaryOperators) ||
Daniel Jasper83193602013-04-05 17:22:09 +00001849 Left.isOneOf(tok::comma, tok::coloncolon, tok::semi, tok::l_brace,
1850 tok::kw_class, tok::kw_struct) ||
Daniel Jasper85bcadc2014-07-09 13:07:57 +00001851 Right.isMemberAccess() ||
Daniel Jasper598dd332014-08-12 13:22:26 +00001852 Right.isOneOf(tok::lessless, tok::colon, tok::l_square, tok::at) ||
Daniel Jasper1bc1b502013-07-05 07:58:34 +00001853 (Left.is(tok::r_paren) &&
Daniel Jasper559b63c2014-01-28 20:13:43 +00001854 Right.isOneOf(tok::identifier, tok::kw_const)) ||
Daniel Jasper1db6c382013-10-22 15:30:28 +00001855 (Left.is(tok::l_paren) && !Right.is(tok::r_paren));
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001856}
1857
Daniel Jasper6bee6822013-04-08 20:33:42 +00001858void TokenAnnotator::printDebugInfo(const AnnotatedLine &Line) {
1859 llvm::errs() << "AnnotatedTokens:\n";
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001860 const FormatToken *Tok = Line.First;
Daniel Jasper6bee6822013-04-08 20:33:42 +00001861 while (Tok) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001862 llvm::errs() << " M=" << Tok->MustBreakBefore
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001863 << " C=" << Tok->CanBreakBefore << " T=" << Tok->Type
1864 << " S=" << Tok->SpacesRequiredBefore
Daniel Jasper17062ff2014-06-10 14:44:02 +00001865 << " B=" << Tok->BlockParameterCount
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001866 << " P=" << Tok->SplitPenalty << " Name=" << Tok->Tok.getName()
Manuel Klimek71814b42013-10-11 21:25:45 +00001867 << " L=" << Tok->TotalLength << " PPK=" << Tok->PackingKind
1868 << " FakeLParens=";
Daniel Jasper6bee6822013-04-08 20:33:42 +00001869 for (unsigned i = 0, e = Tok->FakeLParens.size(); i != e; ++i)
1870 llvm::errs() << Tok->FakeLParens[i] << "/";
1871 llvm::errs() << " FakeRParens=" << Tok->FakeRParens << "\n";
Daniel Jasperb05a81d2014-05-09 13:11:16 +00001872 if (!Tok->Next)
Manuel Klimek71814b42013-10-11 21:25:45 +00001873 assert(Tok == Line.Last);
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001874 Tok = Tok->Next;
Daniel Jasper6bee6822013-04-08 20:33:42 +00001875 }
1876 llvm::errs() << "----\n";
1877}
1878
Daniel Jasper7a6d09b2013-01-29 21:01:14 +00001879} // namespace format
1880} // namespace clang