blob: b9d26ca521911bf7fd96591c81ab3bca0893bf44 [file] [log] [blame]
Daniel Jasper32d28ee2013-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 Jasperbf71ba22013-04-08 20:33:42 +000018#include "llvm/Support/Debug.h"
Daniel Jasper32d28ee2013-01-29 21:01:14 +000019
20namespace clang {
21namespace format {
22
Craig Topper14e66492013-07-01 04:03:19 +000023namespace {
24
Daniel Jasper32d28ee2013-01-29 21:01:14 +000025/// \brief A parser that gathers additional information about tokens.
26///
Alexander Kornienko3fd9ccd2013-03-12 16:28:18 +000027/// The \c TokenAnnotator tries to match parenthesis and square brakets and
Daniel Jasper32d28ee2013-01-29 21:01:14 +000028/// store a parenthesis levels. It also tries to resolve matching "<" and ">"
29/// into template parameter lists.
30class AnnotatingParser {
31public:
Alexander Kornienko00895102013-06-05 14:09:10 +000032 AnnotatingParser(AnnotatedLine &Line, IdentifierInfo &Ident_in)
33 : Line(Line), CurrentToken(Line.First), KeywordVirtualFound(false),
Daniel Jasper2ca37412013-07-09 14:36:48 +000034 NameFound(false), AutoFound(false), Ident_in(Ident_in) {
Nico Weber27268772013-06-26 00:30:14 +000035 Contexts.push_back(Context(tok::unknown, 1, /*IsExpression=*/false));
Daniel Jasper32d28ee2013-01-29 21:01:14 +000036 }
37
Nico Weber95e8e462013-02-12 16:17:07 +000038private:
Daniel Jasper32d28ee2013-01-29 21:01:14 +000039 bool parseAngle() {
40 if (CurrentToken == NULL)
41 return false;
Daniel Jasper923ebef2013-03-14 13:45:21 +000042 ScopedContextCreator ContextCreator(*this, tok::less, 10);
Manuel Klimekb3987012013-05-29 14:47:47 +000043 FormatToken *Left = CurrentToken->Previous;
Daniel Jasper4e778092013-02-06 10:05:46 +000044 Contexts.back().IsExpression = false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +000045 while (CurrentToken != NULL) {
46 if (CurrentToken->is(tok::greater)) {
47 Left->MatchingParen = CurrentToken;
48 CurrentToken->MatchingParen = Left;
49 CurrentToken->Type = TT_TemplateCloser;
50 next();
51 return true;
52 }
Alexander Kornienkoe74de282013-03-13 14:41:29 +000053 if (CurrentToken->isOneOf(tok::r_paren, tok::r_square, tok::r_brace,
Daniel Jasper5d823e32013-05-15 13:46:48 +000054 tok::question, tok::colon))
55 return false;
Daniel Jasper0348be02013-06-01 18:56:00 +000056 // If a && or || is found and interpreted as a binary operator, this set
Daniel Jasper15f33f02013-06-03 16:16:41 +000057 // of angles is likely part of something like "a < b && c > d". If the
Daniel Jasper0348be02013-06-01 18:56:00 +000058 // angles are inside an expression, the ||/&& might also be a binary
59 // operator that was misinterpreted because we are parsing template
60 // parameters.
61 // FIXME: This is getting out of hand, write a decent parser.
Manuel Klimekb3987012013-05-29 14:47:47 +000062 if (CurrentToken->Previous->isOneOf(tok::pipepipe, tok::ampamp) &&
Daniel Jasper0348be02013-06-01 18:56:00 +000063 (CurrentToken->Previous->Type == TT_BinaryOperator ||
64 Contexts[Contexts.size() - 2].IsExpression) &&
Manuel Klimekb3987012013-05-29 14:47:47 +000065 Line.First->isNot(tok::kw_template))
Daniel Jasper32d28ee2013-01-29 21:01:14 +000066 return false;
Daniel Jasper9fc56f22013-02-14 15:01:34 +000067 updateParameterCount(Left, CurrentToken);
Daniel Jasper32d28ee2013-01-29 21:01:14 +000068 if (!consumeToken())
69 return false;
70 }
71 return false;
72 }
73
74 bool parseParens(bool LookForDecls = false) {
75 if (CurrentToken == NULL)
76 return false;
Daniel Jasper923ebef2013-03-14 13:45:21 +000077 ScopedContextCreator ContextCreator(*this, tok::l_paren, 1);
Daniel Jasper4e778092013-02-06 10:05:46 +000078
79 // FIXME: This is a bit of a hack. Do better.
80 Contexts.back().ColonIsForRangeExpr =
81 Contexts.size() == 2 && Contexts[0].ColonIsForRangeExpr;
82
Daniel Jasper32d28ee2013-01-29 21:01:14 +000083 bool StartsObjCMethodExpr = false;
Manuel Klimekb3987012013-05-29 14:47:47 +000084 FormatToken *Left = CurrentToken->Previous;
Daniel Jasper32d28ee2013-01-29 21:01:14 +000085 if (CurrentToken->is(tok::caret)) {
86 // ^( starts a block.
87 Left->Type = TT_ObjCBlockLParen;
Manuel Klimekb3987012013-05-29 14:47:47 +000088 } else if (FormatToken *MaybeSel = Left->Previous) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +000089 // @selector( starts a selector.
Manuel Klimekb3987012013-05-29 14:47:47 +000090 if (MaybeSel->isObjCAtKeyword(tok::objc_selector) && MaybeSel->Previous &&
91 MaybeSel->Previous->is(tok::at)) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +000092 StartsObjCMethodExpr = true;
93 }
94 }
95
Daniel Jasper4e778092013-02-06 10:05:46 +000096 if (StartsObjCMethodExpr) {
97 Contexts.back().ColonIsObjCMethodExpr = true;
98 Left->Type = TT_ObjCMethodExpr;
99 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000100
Daniel Jasper431f5912013-05-28 08:33:00 +0000101 bool MightBeFunctionType = CurrentToken->is(tok::star);
Daniel Jasperc7bd68f2013-07-10 14:02:49 +0000102 bool HasMultipleLines = false;
103 bool HasMultipleParametersOnALine = false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000104 while (CurrentToken != NULL) {
105 // LookForDecls is set when "if (" has been seen. Check for
106 // 'identifier' '*' 'identifier' followed by not '=' -- this
107 // '*' has to be a binary operator but determineStarAmpUsage() will
108 // categorize it as an unary operator, so set the right type here.
Manuel Klimekb3987012013-05-29 14:47:47 +0000109 if (LookForDecls && CurrentToken->Next) {
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000110 FormatToken *Prev = CurrentToken->getPreviousNonComment();
Alexander Kornienko2785b9a2013-06-07 16:02:52 +0000111 if (Prev) {
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000112 FormatToken *PrevPrev = Prev->getPreviousNonComment();
Alexander Kornienko2785b9a2013-06-07 16:02:52 +0000113 FormatToken *Next = CurrentToken->Next;
114 if (PrevPrev && PrevPrev->is(tok::identifier) &&
115 Prev->isOneOf(tok::star, tok::amp, tok::ampamp) &&
116 CurrentToken->is(tok::identifier) && Next->isNot(tok::equal)) {
117 Prev->Type = TT_BinaryOperator;
118 LookForDecls = false;
119 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000120 }
121 }
122
123 if (CurrentToken->is(tok::r_paren)) {
Manuel Klimekb3987012013-05-29 14:47:47 +0000124 if (MightBeFunctionType && CurrentToken->Next &&
Daniel Jaspere7d3bff2013-07-16 11:37:21 +0000125 (CurrentToken->Next->is(tok::l_paren) ||
126 (CurrentToken->Next->is(tok::l_square) &&
127 !Contexts.back().IsExpression)))
Daniel Jasper431f5912013-05-28 08:33:00 +0000128 Left->Type = TT_FunctionTypeLParen;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000129 Left->MatchingParen = CurrentToken;
130 CurrentToken->MatchingParen = Left;
131
Daniel Jasper63d7ced2013-02-05 10:07:47 +0000132 if (StartsObjCMethodExpr) {
Daniel Jasper4e778092013-02-06 10:05:46 +0000133 CurrentToken->Type = TT_ObjCMethodExpr;
134 if (Contexts.back().FirstObjCSelectorName != NULL) {
135 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
136 Contexts.back().LongestObjCSelectorName;
Daniel Jasper63d7ced2013-02-05 10:07:47 +0000137 }
138 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000139
Daniel Jasperc7bd68f2013-07-10 14:02:49 +0000140 if (!HasMultipleLines)
141 Left->PackingKind = PPK_Inconclusive;
142 else if (HasMultipleParametersOnALine)
143 Left->PackingKind = PPK_BinPacked;
144 else
145 Left->PackingKind = PPK_OnePerLine;
146
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000147 next();
148 return true;
149 }
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000150 if (CurrentToken->isOneOf(tok::r_square, tok::r_brace))
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000151 return false;
Manuel Klimekb3987012013-05-29 14:47:47 +0000152 if (CurrentToken->Previous->Type == TT_PointerOrReference &&
153 CurrentToken->Previous->Previous->isOneOf(tok::l_paren,
154 tok::coloncolon))
Daniel Jasper431f5912013-05-28 08:33:00 +0000155 MightBeFunctionType = true;
Daniel Jasper9fc56f22013-02-14 15:01:34 +0000156 updateParameterCount(Left, CurrentToken);
Daniel Jasperc7bd68f2013-07-10 14:02:49 +0000157 if (CurrentToken->is(tok::comma) && CurrentToken->Next &&
158 !CurrentToken->Next->HasUnescapedNewline &&
159 !CurrentToken->Next->isTrailingComment())
160 HasMultipleParametersOnALine = true;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000161 if (!consumeToken())
162 return false;
Daniel Jasperc7bd68f2013-07-10 14:02:49 +0000163 if (CurrentToken && CurrentToken->HasUnescapedNewline)
164 HasMultipleLines = true;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000165 }
166 return false;
167 }
168
169 bool parseSquare() {
170 if (!CurrentToken)
171 return false;
172
Alexander Kornienkod71b15b2013-06-17 13:19:53 +0000173 // A '[' could be an index subscript (after an identifier or after
Nico Weber051860e2013-02-10 02:08:05 +0000174 // ')' or ']'), it could be the start of an Objective-C method
175 // expression, or it could the the start of an Objective-C array literal.
Manuel Klimekb3987012013-05-29 14:47:47 +0000176 FormatToken *Left = CurrentToken->Previous;
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000177 FormatToken *Parent = Left->getPreviousNonComment();
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000178 bool StartsObjCMethodExpr =
Daniel Jasper6f21a982013-03-13 07:49:51 +0000179 Contexts.back().CanBeExpression &&
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000180 (!Parent || Parent->isOneOf(tok::colon, tok::l_square, tok::l_paren,
181 tok::kw_return, tok::kw_throw) ||
Daniel Jasperac3223e2013-04-10 09:49:49 +0000182 Parent->isUnaryOperator() || Parent->Type == TT_ObjCForIn ||
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000183 Parent->Type == TT_CastRParen ||
Manuel Klimekb3987012013-05-29 14:47:47 +0000184 getBinOpPrecedence(Parent->Tok.getKind(), true, true) > prec::Unknown);
Daniel Jasper923ebef2013-03-14 13:45:21 +0000185 ScopedContextCreator ContextCreator(*this, tok::l_square, 10);
Daniel Jasper6f21a982013-03-13 07:49:51 +0000186 Contexts.back().IsExpression = true;
Nico Weber051860e2013-02-10 02:08:05 +0000187 bool StartsObjCArrayLiteral = Parent && Parent->is(tok::at);
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000188
Daniel Jasper4e778092013-02-06 10:05:46 +0000189 if (StartsObjCMethodExpr) {
190 Contexts.back().ColonIsObjCMethodExpr = true;
191 Left->Type = TT_ObjCMethodExpr;
Nico Weber051860e2013-02-10 02:08:05 +0000192 } else if (StartsObjCArrayLiteral) {
193 Left->Type = TT_ObjCArrayLiteral;
Daniel Jasper4e778092013-02-06 10:05:46 +0000194 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000195
196 while (CurrentToken != NULL) {
197 if (CurrentToken->is(tok::r_square)) {
Manuel Klimekb3987012013-05-29 14:47:47 +0000198 if (CurrentToken->Next && CurrentToken->Next->is(tok::l_paren)) {
Nico Webere8a97982013-02-06 06:20:11 +0000199 // An ObjC method call is rarely followed by an open parenthesis.
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000200 // FIXME: Do we incorrectly label ":" with this?
201 StartsObjCMethodExpr = false;
202 Left->Type = TT_Unknown;
203 }
Daniel Jasper01786732013-02-04 07:21:18 +0000204 if (StartsObjCMethodExpr) {
Daniel Jasper4e778092013-02-06 10:05:46 +0000205 CurrentToken->Type = TT_ObjCMethodExpr;
Nico Webere8a97982013-02-06 06:20:11 +0000206 // determineStarAmpUsage() thinks that '*' '[' is allocating an
207 // array of pointers, but if '[' starts a selector then '*' is a
208 // binary operator.
Alexander Kornienko3fd9ccd2013-03-12 16:28:18 +0000209 if (Parent != NULL && Parent->Type == TT_PointerOrReference)
Nico Weber4ed7f3e2013-02-06 16:54:35 +0000210 Parent->Type = TT_BinaryOperator;
Nico Weber051860e2013-02-10 02:08:05 +0000211 } else if (StartsObjCArrayLiteral) {
212 CurrentToken->Type = TT_ObjCArrayLiteral;
Daniel Jasper01786732013-02-04 07:21:18 +0000213 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000214 Left->MatchingParen = CurrentToken;
215 CurrentToken->MatchingParen = Left;
Daniel Jasper4e778092013-02-06 10:05:46 +0000216 if (Contexts.back().FirstObjCSelectorName != NULL)
217 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
218 Contexts.back().LongestObjCSelectorName;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000219 next();
220 return true;
221 }
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000222 if (CurrentToken->isOneOf(tok::r_paren, tok::r_brace))
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000223 return false;
Daniel Jasper9fc56f22013-02-14 15:01:34 +0000224 updateParameterCount(Left, CurrentToken);
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000225 if (!consumeToken())
226 return false;
227 }
228 return false;
229 }
230
231 bool parseBrace() {
Daniel Jasper53e72cd2013-05-06 08:27:33 +0000232 if (CurrentToken != NULL) {
233 ScopedContextCreator ContextCreator(*this, tok::l_brace, 1);
Manuel Klimekb3987012013-05-29 14:47:47 +0000234 FormatToken *Left = CurrentToken->Previous;
Nico Weberf2ff8122013-05-26 05:39:26 +0000235
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000236 FormatToken *Parent = Left->getPreviousNonComment();
Nico Weberf2ff8122013-05-26 05:39:26 +0000237 bool StartsObjCDictLiteral = Parent && Parent->is(tok::at);
238 if (StartsObjCDictLiteral) {
239 Contexts.back().ColonIsObjCDictLiteral = true;
240 Left->Type = TT_ObjCDictLiteral;
241 }
242
Daniel Jasper53e72cd2013-05-06 08:27:33 +0000243 while (CurrentToken != NULL) {
244 if (CurrentToken->is(tok::r_brace)) {
Nico Weberf2ff8122013-05-26 05:39:26 +0000245 if (StartsObjCDictLiteral)
246 CurrentToken->Type = TT_ObjCDictLiteral;
Daniel Jasper53e72cd2013-05-06 08:27:33 +0000247 Left->MatchingParen = CurrentToken;
248 CurrentToken->MatchingParen = Left;
249 next();
250 return true;
251 }
252 if (CurrentToken->isOneOf(tok::r_paren, tok::r_square))
253 return false;
254 updateParameterCount(Left, CurrentToken);
255 if (!consumeToken())
256 return false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000257 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000258 }
Daniel Jasper53e72cd2013-05-06 08:27:33 +0000259 // No closing "}" found, this probably starts a definition.
260 Line.StartsDefinition = true;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000261 return true;
262 }
Daniel Jasperc4615b72013-02-20 12:56:39 +0000263
Manuel Klimekb3987012013-05-29 14:47:47 +0000264 void updateParameterCount(FormatToken *Left, FormatToken *Current) {
Daniel Jasperc7bd68f2013-07-10 14:02:49 +0000265 if (Current->is(tok::comma)) {
Daniel Jasper9fc56f22013-02-14 15:01:34 +0000266 ++Left->ParameterCount;
Daniel Jasperc7bd68f2013-07-10 14:02:49 +0000267 } else if (Left->ParameterCount == 0 && Current->isNot(tok::comment)) {
Daniel Jasper9fc56f22013-02-14 15:01:34 +0000268 Left->ParameterCount = 1;
Daniel Jasperc7bd68f2013-07-10 14:02:49 +0000269 }
Daniel Jasper9fc56f22013-02-14 15:01:34 +0000270 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000271
272 bool parseConditional() {
273 while (CurrentToken != NULL) {
274 if (CurrentToken->is(tok::colon)) {
275 CurrentToken->Type = TT_ConditionalExpr;
276 next();
277 return true;
278 }
279 if (!consumeToken())
280 return false;
281 }
282 return false;
283 }
284
285 bool parseTemplateDeclaration() {
286 if (CurrentToken != NULL && CurrentToken->is(tok::less)) {
287 CurrentToken->Type = TT_TemplateOpener;
288 next();
289 if (!parseAngle())
290 return false;
Daniel Jasper34511fb2013-02-19 17:14:38 +0000291 if (CurrentToken != NULL)
Manuel Klimekb3987012013-05-29 14:47:47 +0000292 CurrentToken->Previous->ClosesTemplateDeclaration = true;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000293 return true;
294 }
295 return false;
296 }
297
298 bool consumeToken() {
Manuel Klimekb3987012013-05-29 14:47:47 +0000299 FormatToken *Tok = CurrentToken;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000300 next();
Manuel Klimekb3987012013-05-29 14:47:47 +0000301 switch (Tok->Tok.getKind()) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000302 case tok::plus:
303 case tok::minus:
Manuel Klimekb3987012013-05-29 14:47:47 +0000304 if (Tok->Previous == NULL && Line.MustBeDeclaration)
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000305 Tok->Type = TT_ObjCMethodSpecifier;
306 break;
307 case tok::colon:
Manuel Klimekb3987012013-05-29 14:47:47 +0000308 if (Tok->Previous == NULL)
Daniel Jaspercf6d76a2013-03-18 12:50:26 +0000309 return false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000310 // Colons from ?: are handled in parseConditional().
Manuel Klimekb3987012013-05-29 14:47:47 +0000311 if (Tok->Previous->is(tok::r_paren) && Contexts.size() == 1) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000312 Tok->Type = TT_CtorInitializerColon;
Nico Weberf2ff8122013-05-26 05:39:26 +0000313 } else if (Contexts.back().ColonIsObjCDictLiteral) {
314 Tok->Type = TT_ObjCDictLiteral;
Daniel Jasper4e778092013-02-06 10:05:46 +0000315 } else if (Contexts.back().ColonIsObjCMethodExpr ||
Manuel Klimekb3987012013-05-29 14:47:47 +0000316 Line.First->Type == TT_ObjCMethodSpecifier) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000317 Tok->Type = TT_ObjCMethodExpr;
Manuel Klimekb3987012013-05-29 14:47:47 +0000318 Tok->Previous->Type = TT_ObjCSelectorName;
Alexander Kornienko00895102013-06-05 14:09:10 +0000319 if (Tok->Previous->CodePointCount >
320 Contexts.back().LongestObjCSelectorName) {
321 Contexts.back().LongestObjCSelectorName =
322 Tok->Previous->CodePointCount;
323 }
Daniel Jasper4e778092013-02-06 10:05:46 +0000324 if (Contexts.back().FirstObjCSelectorName == NULL)
Manuel Klimekb3987012013-05-29 14:47:47 +0000325 Contexts.back().FirstObjCSelectorName = Tok->Previous;
Daniel Jasper4e778092013-02-06 10:05:46 +0000326 } else if (Contexts.back().ColonIsForRangeExpr) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000327 Tok->Type = TT_RangeBasedForLoopColon;
Daniel Jasper6cabab42013-02-14 08:42:54 +0000328 } else if (Contexts.size() == 1) {
329 Tok->Type = TT_InheritanceColon;
Daniel Jasper923ebef2013-03-14 13:45:21 +0000330 } else if (Contexts.back().ContextKind == tok::l_paren) {
331 Tok->Type = TT_InlineASMColon;
Daniel Jasper63d7ced2013-02-05 10:07:47 +0000332 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000333 break;
334 case tok::kw_if:
335 case tok::kw_while:
336 if (CurrentToken != NULL && CurrentToken->is(tok::l_paren)) {
337 next();
Nico Weber27268772013-06-26 00:30:14 +0000338 if (!parseParens(/*LookForDecls=*/true))
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000339 return false;
340 }
341 break;
342 case tok::kw_for:
Daniel Jasper4e778092013-02-06 10:05:46 +0000343 Contexts.back().ColonIsForRangeExpr = true;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000344 next();
345 if (!parseParens())
346 return false;
347 break;
348 case tok::l_paren:
349 if (!parseParens())
350 return false;
Daniel Jasper1407bee2013-04-11 14:29:13 +0000351 if (Line.MustBeDeclaration && NameFound && !Contexts.back().IsExpression)
Daniel Jasper3c08a812013-02-24 18:54:32 +0000352 Line.MightBeFunctionDecl = true;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000353 break;
354 case tok::l_square:
355 if (!parseSquare())
356 return false;
357 break;
358 case tok::l_brace:
359 if (!parseBrace())
360 return false;
361 break;
362 case tok::less:
Daniel Jasper0236dd02013-07-30 22:37:19 +0000363 if (Tok->Previous && !Tok->Previous->Tok.isLiteral() && parseAngle())
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000364 Tok->Type = TT_TemplateOpener;
365 else {
366 Tok->Type = TT_BinaryOperator;
367 CurrentToken = Tok;
368 next();
369 }
370 break;
371 case tok::r_paren:
372 case tok::r_square:
373 return false;
374 case tok::r_brace:
375 // Lines can start with '}'.
Manuel Klimekb3987012013-05-29 14:47:47 +0000376 if (Tok->Previous != NULL)
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000377 return false;
378 break;
379 case tok::greater:
380 Tok->Type = TT_BinaryOperator;
381 break;
382 case tok::kw_operator:
Daniel Jasper2b4c9242013-02-11 08:01:18 +0000383 while (CurrentToken && CurrentToken->isNot(tok::l_paren)) {
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000384 if (CurrentToken->isOneOf(tok::star, tok::amp))
Daniel Jasper2b4c9242013-02-11 08:01:18 +0000385 CurrentToken->Type = TT_PointerOrReference;
386 consumeToken();
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000387 }
Daniel Jasper6ea933c2013-05-10 07:59:58 +0000388 if (CurrentToken) {
Daniel Jasper2b4c9242013-02-11 08:01:18 +0000389 CurrentToken->Type = TT_OverloadedOperatorLParen;
Manuel Klimekb3987012013-05-29 14:47:47 +0000390 if (CurrentToken->Previous->Type == TT_BinaryOperator)
391 CurrentToken->Previous->Type = TT_OverloadedOperator;
Daniel Jasper6ea933c2013-05-10 07:59:58 +0000392 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000393 break;
394 case tok::question:
395 parseConditional();
396 break;
397 case tok::kw_template:
398 parseTemplateDeclaration();
399 break;
Nico Weberc2e6d2a2013-02-11 15:32:15 +0000400 case tok::identifier:
Manuel Klimekb3987012013-05-29 14:47:47 +0000401 if (Line.First->is(tok::kw_for) &&
402 Tok->Tok.getIdentifierInfo() == &Ident_in)
Nico Weberc2e6d2a2013-02-11 15:32:15 +0000403 Tok->Type = TT_ObjCForIn;
404 break;
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000405 case tok::comma:
406 if (Contexts.back().FirstStartOfName)
407 Contexts.back().FirstStartOfName->PartOfMultiVariableDeclStmt = true;
Daniel Jaspere8b10d32013-07-26 16:56:36 +0000408 if (Contexts.back().InCtorInitializer)
409 Tok->Type = TT_CtorInitializerComma;
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000410 break;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000411 default:
412 break;
413 }
414 return true;
415 }
416
417 void parseIncludeDirective() {
418 next();
419 if (CurrentToken != NULL && CurrentToken->is(tok::less)) {
420 next();
421 while (CurrentToken != NULL) {
Manuel Klimekb3987012013-05-29 14:47:47 +0000422 if (CurrentToken->isNot(tok::comment) || CurrentToken->Next)
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000423 CurrentToken->Type = TT_ImplicitStringLiteral;
424 next();
425 }
426 } else {
427 while (CurrentToken != NULL) {
Daniel Jasper3a204412013-02-23 07:46:38 +0000428 if (CurrentToken->is(tok::string_literal))
429 // Mark these string literals as "implicit" literals, too, so that
430 // they are not split or line-wrapped.
431 CurrentToken->Type = TT_ImplicitStringLiteral;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000432 next();
433 }
434 }
435 }
436
437 void parseWarningOrError() {
438 next();
439 // We still want to format the whitespace left of the first token of the
440 // warning or error.
441 next();
442 while (CurrentToken != NULL) {
443 CurrentToken->Type = TT_ImplicitStringLiteral;
444 next();
445 }
446 }
447
448 void parsePreprocessorDirective() {
449 next();
450 if (CurrentToken == NULL)
451 return;
452 // Hashes in the middle of a line can lead to any strange token
453 // sequence.
Manuel Klimekb3987012013-05-29 14:47:47 +0000454 if (CurrentToken->Tok.getIdentifierInfo() == NULL)
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000455 return;
Manuel Klimekb3987012013-05-29 14:47:47 +0000456 switch (CurrentToken->Tok.getIdentifierInfo()->getPPKeywordID()) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000457 case tok::pp_include:
458 case tok::pp_import:
459 parseIncludeDirective();
460 break;
461 case tok::pp_error:
462 case tok::pp_warning:
463 parseWarningOrError();
464 break;
Daniel Jasperaae7bad2013-04-23 13:54:04 +0000465 case tok::pp_if:
466 case tok::pp_elif:
467 parseLine();
468 break;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000469 default:
470 break;
471 }
Daniel Jasper5b7e7b02013-02-05 09:34:14 +0000472 while (CurrentToken != NULL)
473 next();
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000474 }
475
Nico Weber95e8e462013-02-12 16:17:07 +0000476public:
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000477 LineType parseLine() {
478 int PeriodsAndArrows = 0;
Manuel Klimekb3987012013-05-29 14:47:47 +0000479 FormatToken *LastPeriodOrArrow = NULL;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000480 bool CanBeBuilderTypeStmt = true;
481 if (CurrentToken->is(tok::hash)) {
482 parsePreprocessorDirective();
483 return LT_PreprocessorDirective;
484 }
485 while (CurrentToken != NULL) {
486 if (CurrentToken->is(tok::kw_virtual))
487 KeywordVirtualFound = true;
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000488 if (CurrentToken->isOneOf(tok::period, tok::arrow)) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000489 ++PeriodsAndArrows;
Daniel Jasper24849712013-03-01 16:48:32 +0000490 LastPeriodOrArrow = CurrentToken;
491 }
Manuel Klimekb3987012013-05-29 14:47:47 +0000492 FormatToken *TheToken = CurrentToken;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000493 if (!consumeToken())
494 return LT_Invalid;
Manuel Klimekb3987012013-05-29 14:47:47 +0000495 if (TheToken->getPrecedence() > prec::Assignment &&
Daniel Jasper82282dc2013-02-18 13:52:06 +0000496 TheToken->Type == TT_BinaryOperator)
Daniel Jasper4a544e52013-02-15 20:33:06 +0000497 CanBeBuilderTypeStmt = false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000498 }
499 if (KeywordVirtualFound)
500 return LT_VirtualFunctionDecl;
501
502 // Assume a builder-type call if there are 2 or more "." and "->".
Daniel Jasper24849712013-03-01 16:48:32 +0000503 if (PeriodsAndArrows >= 2 && CanBeBuilderTypeStmt) {
504 LastPeriodOrArrow->LastInChainOfCalls = true;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000505 return LT_BuilderTypeCall;
Daniel Jasper24849712013-03-01 16:48:32 +0000506 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000507
Manuel Klimekb3987012013-05-29 14:47:47 +0000508 if (Line.First->Type == TT_ObjCMethodSpecifier) {
Daniel Jasper4e778092013-02-06 10:05:46 +0000509 if (Contexts.back().FirstObjCSelectorName != NULL)
510 Contexts.back().FirstObjCSelectorName->LongestObjCSelectorName =
511 Contexts.back().LongestObjCSelectorName;
Daniel Jasper63d7ced2013-02-05 10:07:47 +0000512 return LT_ObjCMethodDecl;
513 }
514
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000515 return LT_Other;
516 }
517
Nico Weber95e8e462013-02-12 16:17:07 +0000518private:
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000519 void next() {
Daniel Jasper01786732013-02-04 07:21:18 +0000520 if (CurrentToken != NULL) {
521 determineTokenType(*CurrentToken);
Daniel Jasper4e778092013-02-06 10:05:46 +0000522 CurrentToken->BindingStrength = Contexts.back().BindingStrength;
Daniel Jasper01786732013-02-04 07:21:18 +0000523 }
524
Manuel Klimekb3987012013-05-29 14:47:47 +0000525 if (CurrentToken != NULL)
526 CurrentToken = CurrentToken->Next;
Daniel Jasperd0f349b2013-02-18 12:44:35 +0000527
528 // Reset token type in case we have already looked at it and then recovered
529 // from an error (e.g. failure to find the matching >).
530 if (CurrentToken != NULL)
531 CurrentToken->Type = TT_Unknown;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000532 }
533
Daniel Jasper4e778092013-02-06 10:05:46 +0000534 /// \brief A struct to hold information valid in a specific context, e.g.
535 /// a pair of parenthesis.
536 struct Context {
Daniel Jasper923ebef2013-03-14 13:45:21 +0000537 Context(tok::TokenKind ContextKind, unsigned BindingStrength,
538 bool IsExpression)
539 : ContextKind(ContextKind), BindingStrength(BindingStrength),
540 LongestObjCSelectorName(0), ColonIsForRangeExpr(false),
Nico Weberf2ff8122013-05-26 05:39:26 +0000541 ColonIsObjCDictLiteral(false), ColonIsObjCMethodExpr(false),
542 FirstObjCSelectorName(NULL), FirstStartOfName(NULL),
Daniel Jaspere8b10d32013-07-26 16:56:36 +0000543 IsExpression(IsExpression), CanBeExpression(true),
544 InCtorInitializer(false) {}
Daniel Jasper01786732013-02-04 07:21:18 +0000545
Daniel Jasper923ebef2013-03-14 13:45:21 +0000546 tok::TokenKind ContextKind;
Daniel Jasper4e778092013-02-06 10:05:46 +0000547 unsigned BindingStrength;
548 unsigned LongestObjCSelectorName;
549 bool ColonIsForRangeExpr;
Nico Weberf2ff8122013-05-26 05:39:26 +0000550 bool ColonIsObjCDictLiteral;
Daniel Jasper4e778092013-02-06 10:05:46 +0000551 bool ColonIsObjCMethodExpr;
Manuel Klimekb3987012013-05-29 14:47:47 +0000552 FormatToken *FirstObjCSelectorName;
553 FormatToken *FirstStartOfName;
Daniel Jasper4e778092013-02-06 10:05:46 +0000554 bool IsExpression;
Daniel Jasper6f21a982013-03-13 07:49:51 +0000555 bool CanBeExpression;
Daniel Jaspere8b10d32013-07-26 16:56:36 +0000556 bool InCtorInitializer;
Daniel Jasper4e778092013-02-06 10:05:46 +0000557 };
558
559 /// \brief Puts a new \c Context onto the stack \c Contexts for the lifetime
560 /// of each instance.
561 struct ScopedContextCreator {
562 AnnotatingParser &P;
563
Daniel Jasper923ebef2013-03-14 13:45:21 +0000564 ScopedContextCreator(AnnotatingParser &P, tok::TokenKind ContextKind,
565 unsigned Increase)
566 : P(P) {
Daniel Jasper2a409b62013-07-08 14:34:09 +0000567 P.Contexts.push_back(Context(ContextKind,
568 P.Contexts.back().BindingStrength + Increase,
569 P.Contexts.back().IsExpression));
Daniel Jasper4e778092013-02-06 10:05:46 +0000570 }
571
572 ~ScopedContextCreator() { P.Contexts.pop_back(); }
573 };
Daniel Jasper01786732013-02-04 07:21:18 +0000574
Manuel Klimekb3987012013-05-29 14:47:47 +0000575 void determineTokenType(FormatToken &Current) {
576 if (Current.getPrecedence() == prec::Assignment &&
577 (!Current.Previous || Current.Previous->isNot(tok::kw_operator))) {
Daniel Jasper4e778092013-02-06 10:05:46 +0000578 Contexts.back().IsExpression = true;
Manuel Klimekb3987012013-05-29 14:47:47 +0000579 for (FormatToken *Previous = Current.Previous;
Nico Weber95e8e462013-02-12 16:17:07 +0000580 Previous && Previous->isNot(tok::comma);
Manuel Klimekb3987012013-05-29 14:47:47 +0000581 Previous = Previous->Previous) {
Daniel Jasper9c65b062013-02-27 11:43:50 +0000582 if (Previous->is(tok::r_square))
583 Previous = Previous->MatchingParen;
Daniel Jasper01786732013-02-04 07:21:18 +0000584 if (Previous->Type == TT_BinaryOperator &&
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000585 Previous->isOneOf(tok::star, tok::amp)) {
Daniel Jasper01786732013-02-04 07:21:18 +0000586 Previous->Type = TT_PointerOrReference;
587 }
Daniel Jasper01786732013-02-04 07:21:18 +0000588 }
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000589 } else if (Current.isOneOf(tok::kw_return, tok::kw_throw) ||
Nico Weber95e8e462013-02-12 16:17:07 +0000590 (Current.is(tok::l_paren) && !Line.MustBeDeclaration &&
Daniel Jasper378d93d2013-05-13 07:14:40 +0000591 !Line.InPPDirective &&
Manuel Klimekb3987012013-05-29 14:47:47 +0000592 (!Current.Previous || Current.Previous->isNot(tok::kw_for)))) {
Daniel Jasper4e778092013-02-06 10:05:46 +0000593 Contexts.back().IsExpression = true;
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000594 } else if (Current.isOneOf(tok::r_paren, tok::greater, tok::comma)) {
Manuel Klimekb3987012013-05-29 14:47:47 +0000595 for (FormatToken *Previous = Current.Previous;
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000596 Previous && Previous->isOneOf(tok::star, tok::amp);
Manuel Klimekb3987012013-05-29 14:47:47 +0000597 Previous = Previous->Previous)
Nico Weber95e8e462013-02-12 16:17:07 +0000598 Previous->Type = TT_PointerOrReference;
Manuel Klimekb3987012013-05-29 14:47:47 +0000599 } else if (Current.Previous &&
600 Current.Previous->Type == TT_CtorInitializerColon) {
Daniel Jasperd0f349b2013-02-18 12:44:35 +0000601 Contexts.back().IsExpression = true;
Daniel Jaspere8b10d32013-07-26 16:56:36 +0000602 Contexts.back().InCtorInitializer = true;
Daniel Jasper6f21a982013-03-13 07:49:51 +0000603 } else if (Current.is(tok::kw_new)) {
604 Contexts.back().CanBeExpression = false;
Daniel Jasper16a69ef2013-05-03 14:41:24 +0000605 } else if (Current.is(tok::semi)) {
606 // This should be the condition or increment in a for-loop.
607 Contexts.back().IsExpression = true;
Nico Weber95e8e462013-02-12 16:17:07 +0000608 }
Daniel Jasper01786732013-02-04 07:21:18 +0000609
610 if (Current.Type == TT_Unknown) {
Daniel Jasper6ac431c2013-07-02 09:47:29 +0000611 if (isStartOfName(Current)) {
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000612 Contexts.back().FirstStartOfName = &Current;
Daniel Jasper3c08a812013-02-24 18:54:32 +0000613 Current.Type = TT_StartOfName;
Daniel Jasper1407bee2013-04-11 14:29:13 +0000614 NameFound = true;
Daniel Jasper2ca37412013-07-09 14:36:48 +0000615 } else if (Current.is(tok::kw_auto)) {
616 AutoFound = true;
Daniel Jasper3262f4c2013-07-11 14:33:06 +0000617 } else if (Current.is(tok::arrow) && AutoFound &&
618 Line.MustBeDeclaration) {
Daniel Jasper2ca37412013-07-09 14:36:48 +0000619 Current.Type = TT_TrailingReturnArrow;
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000620 } else if (Current.isOneOf(tok::star, tok::amp, tok::ampamp)) {
Daniel Jasper4e778092013-02-06 10:05:46 +0000621 Current.Type =
Daniel Jasperd6104f62013-07-05 13:30:40 +0000622 determineStarAmpUsage(Current, Contexts.back().CanBeExpression &&
623 Contexts.back().IsExpression);
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000624 } else if (Current.isOneOf(tok::minus, tok::plus, tok::caret)) {
Daniel Jasper01786732013-02-04 07:21:18 +0000625 Current.Type = determinePlusMinusCaretUsage(Current);
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000626 } else if (Current.isOneOf(tok::minusminus, tok::plusplus)) {
Daniel Jasper01786732013-02-04 07:21:18 +0000627 Current.Type = determineIncrementUsage(Current);
628 } else if (Current.is(tok::exclaim)) {
629 Current.Type = TT_UnaryOperator;
Daniel Jasperac3223e2013-04-10 09:49:49 +0000630 } else if (Current.isBinaryOperator()) {
Daniel Jasper01786732013-02-04 07:21:18 +0000631 Current.Type = TT_BinaryOperator;
632 } else if (Current.is(tok::comment)) {
Alexander Kornienko00895102013-06-05 14:09:10 +0000633 if (Current.TokenText.startswith("//"))
Daniel Jasper01786732013-02-04 07:21:18 +0000634 Current.Type = TT_LineComment;
635 else
636 Current.Type = TT_BlockComment;
Nico Weber37d69312013-02-13 04:13:13 +0000637 } else if (Current.is(tok::r_paren)) {
Daniel Jasperb8b42952013-05-31 16:14:28 +0000638 FormatToken *LeftOfParens = NULL;
639 if (Current.MatchingParen)
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000640 LeftOfParens = Current.MatchingParen->getPreviousNonComment();
Daniel Jasperb8b42952013-05-31 16:14:28 +0000641 bool IsCast = false;
642 bool ParensAreEmpty = Current.Previous == Current.MatchingParen;
643 bool ParensAreType = !Current.Previous ||
Manuel Klimekb3987012013-05-29 14:47:47 +0000644 Current.Previous->Type == TT_PointerOrReference ||
Daniel Jasperb8b42952013-05-31 16:14:28 +0000645 Current.Previous->Type == TT_TemplateCloser ||
646 isSimpleTypeSpecifier(*Current.Previous);
Nico Weber37d69312013-02-13 04:13:13 +0000647 bool ParensCouldEndDecl =
Manuel Klimekb3987012013-05-29 14:47:47 +0000648 Current.Next &&
649 Current.Next->isOneOf(tok::equal, tok::semi, tok::l_brace);
Daniel Jasper6a365aa2013-03-13 17:13:53 +0000650 bool IsSizeOfOrAlignOf =
Daniel Jasperb8b42952013-05-31 16:14:28 +0000651 LeftOfParens &&
652 LeftOfParens->isOneOf(tok::kw_sizeof, tok::kw_alignof);
653 if (ParensAreType && !ParensCouldEndDecl && !IsSizeOfOrAlignOf &&
Daniel Jasper0c368782013-07-15 15:04:42 +0000654 (Contexts.back().IsExpression ||
655 (Current.Next && Current.Next->isBinaryOperator())))
Daniel Jasperb8b42952013-05-31 16:14:28 +0000656 IsCast = true;
Daniel Jasper2a409b62013-07-08 14:34:09 +0000657 if (Current.Next && Current.Next->isNot(tok::string_literal) &&
Daniel Jasperb8b42952013-05-31 16:14:28 +0000658 (Current.Next->Tok.isLiteral() ||
659 Current.Next->isOneOf(tok::kw_sizeof, tok::kw_alignof)))
660 IsCast = true;
661 // If there is an identifier after the (), it is likely a cast, unless
662 // there is also an identifier before the ().
Daniel Jasperff1a2e52013-06-06 08:20:20 +0000663 if (LeftOfParens && (LeftOfParens->Tok.getIdentifierInfo() == NULL ||
664 LeftOfParens->is(tok::kw_return)) &&
Daniel Jasper526df0f2013-07-08 14:58:01 +0000665 LeftOfParens->Type != TT_OverloadedOperator &&
Nico Weber465e8612013-06-25 00:55:57 +0000666 LeftOfParens->Type != TT_TemplateCloser && Current.Next &&
667 Current.Next->is(tok::identifier))
Daniel Jasperb8b42952013-05-31 16:14:28 +0000668 IsCast = true;
669 if (IsCast && !ParensAreEmpty)
Nico Weber37d69312013-02-13 04:13:13 +0000670 Current.Type = TT_CastRParen;
Manuel Klimekb3987012013-05-29 14:47:47 +0000671 } else if (Current.is(tok::at) && Current.Next) {
672 switch (Current.Next->Tok.getObjCKeywordID()) {
Daniel Jasper01786732013-02-04 07:21:18 +0000673 case tok::objc_interface:
674 case tok::objc_implementation:
675 case tok::objc_protocol:
676 Current.Type = TT_ObjCDecl;
677 break;
678 case tok::objc_property:
679 Current.Type = TT_ObjCProperty;
680 break;
681 default:
682 break;
683 }
Daniel Jasper5ad390d2013-05-28 11:30:49 +0000684 } else if (Current.is(tok::period)) {
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000685 FormatToken *PreviousNoComment = Current.getPreviousNonComment();
Daniel Jasper5ad390d2013-05-28 11:30:49 +0000686 if (PreviousNoComment &&
687 PreviousNoComment->isOneOf(tok::comma, tok::l_brace))
688 Current.Type = TT_DesignatedInitializerPeriod;
Daniel Jasper01786732013-02-04 07:21:18 +0000689 }
690 }
691 }
692
Daniel Jasper6ac431c2013-07-02 09:47:29 +0000693 /// \brief Take a guess at whether \p Tok starts a name of a function or
694 /// variable declaration.
695 ///
696 /// This is a heuristic based on whether \p Tok is an identifier following
697 /// something that is likely a type.
698 bool isStartOfName(const FormatToken &Tok) {
699 if (Tok.isNot(tok::identifier) || Tok.Previous == NULL)
700 return false;
701
702 // Skip "const" as it does not have an influence on whether this is a name.
703 FormatToken *PreviousNotConst = Tok.Previous;
704 while (PreviousNotConst != NULL && PreviousNotConst->is(tok::kw_const))
705 PreviousNotConst = PreviousNotConst->Previous;
706
707 if (PreviousNotConst == NULL)
708 return false;
709
Daniel Jasper2a409b62013-07-08 14:34:09 +0000710 bool IsPPKeyword = PreviousNotConst->is(tok::identifier) &&
711 PreviousNotConst->Previous &&
712 PreviousNotConst->Previous->is(tok::hash);
Daniel Jasper6ac431c2013-07-02 09:47:29 +0000713
714 return (!IsPPKeyword && PreviousNotConst->is(tok::identifier)) ||
715 PreviousNotConst->Type == TT_PointerOrReference ||
716 PreviousNotConst->Type == TT_TemplateCloser ||
717 isSimpleTypeSpecifier(*PreviousNotConst);
718 }
719
Daniel Jasper01786732013-02-04 07:21:18 +0000720 /// \brief Return the type of the given token assuming it is * or &.
Manuel Klimekb3987012013-05-29 14:47:47 +0000721 TokenType determineStarAmpUsage(const FormatToken &Tok, bool IsExpression) {
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000722 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Daniel Jasper01786732013-02-04 07:21:18 +0000723 if (PrevToken == NULL)
724 return TT_UnaryOperator;
725
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000726 const FormatToken *NextToken = Tok.getNextNonComment();
Daniel Jasper01786732013-02-04 07:21:18 +0000727 if (NextToken == NULL)
728 return TT_Unknown;
729
Daniel Jasper431f5912013-05-28 08:33:00 +0000730 if (PrevToken->is(tok::coloncolon) ||
731 (PrevToken->is(tok::l_paren) && !IsExpression))
Daniel Jasper8a5d7cd2013-03-01 17:13:29 +0000732 return TT_PointerOrReference;
733
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000734 if (PrevToken->isOneOf(tok::l_paren, tok::l_square, tok::l_brace,
Daniel Jasperd3cf17b2013-03-14 10:50:25 +0000735 tok::comma, tok::semi, tok::kw_return, tok::colon,
Daniel Jasperdbef71e2013-05-07 14:17:18 +0000736 tok::equal, tok::kw_delete) ||
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000737 PrevToken->Type == TT_BinaryOperator ||
Daniel Jasper01786732013-02-04 07:21:18 +0000738 PrevToken->Type == TT_UnaryOperator || PrevToken->Type == TT_CastRParen)
739 return TT_UnaryOperator;
740
Nico Webere8a97982013-02-06 06:20:11 +0000741 if (NextToken->is(tok::l_square))
742 return TT_PointerOrReference;
743
Manuel Klimekb3987012013-05-29 14:47:47 +0000744 if (PrevToken->Tok.isLiteral() ||
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000745 PrevToken->isOneOf(tok::r_paren, tok::r_square) ||
Manuel Klimekb3987012013-05-29 14:47:47 +0000746 NextToken->Tok.isLiteral() || NextToken->isUnaryOperator())
Daniel Jasper01786732013-02-04 07:21:18 +0000747 return TT_BinaryOperator;
748
Daniel Jasper01786732013-02-04 07:21:18 +0000749 // It is very unlikely that we are going to find a pointer or reference type
750 // definition on the RHS of an assignment.
751 if (IsExpression)
752 return TT_BinaryOperator;
753
754 return TT_PointerOrReference;
755 }
756
Manuel Klimekb3987012013-05-29 14:47:47 +0000757 TokenType determinePlusMinusCaretUsage(const FormatToken &Tok) {
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000758 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Daniel Jasperb8b42952013-05-31 16:14:28 +0000759 if (PrevToken == NULL || PrevToken->Type == TT_CastRParen)
Daniel Jasper01786732013-02-04 07:21:18 +0000760 return TT_UnaryOperator;
761
762 // Use heuristics to recognize unary operators.
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000763 if (PrevToken->isOneOf(tok::equal, tok::l_paren, tok::comma, tok::l_square,
764 tok::question, tok::colon, tok::kw_return,
765 tok::kw_case, tok::at, tok::l_brace))
Daniel Jasper01786732013-02-04 07:21:18 +0000766 return TT_UnaryOperator;
767
Nico Weberee0feec2013-02-05 16:21:00 +0000768 // There can't be two consecutive binary operators.
Daniel Jasper01786732013-02-04 07:21:18 +0000769 if (PrevToken->Type == TT_BinaryOperator)
770 return TT_UnaryOperator;
771
772 // Fall back to marking the token as binary operator.
773 return TT_BinaryOperator;
774 }
775
776 /// \brief Determine whether ++/-- are pre- or post-increments/-decrements.
Manuel Klimekb3987012013-05-29 14:47:47 +0000777 TokenType determineIncrementUsage(const FormatToken &Tok) {
Alexander Kornienko0bdc6432013-07-04 14:47:51 +0000778 const FormatToken *PrevToken = Tok.getPreviousNonComment();
Daniel Jasperb8b42952013-05-31 16:14:28 +0000779 if (PrevToken == NULL || PrevToken->Type == TT_CastRParen)
Daniel Jasper01786732013-02-04 07:21:18 +0000780 return TT_UnaryOperator;
Alexander Kornienkoe74de282013-03-13 14:41:29 +0000781 if (PrevToken->isOneOf(tok::r_paren, tok::r_square, tok::identifier))
Daniel Jasper01786732013-02-04 07:21:18 +0000782 return TT_TrailingUnaryOperator;
783
784 return TT_UnaryOperator;
785 }
Daniel Jasper4e778092013-02-06 10:05:46 +0000786
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000787 // FIXME: This is copy&pasted from Sema. Put it in a common place and remove
788 // duplication.
789 /// \brief Determine whether the token kind starts a simple-type-specifier.
Manuel Klimekb3987012013-05-29 14:47:47 +0000790 bool isSimpleTypeSpecifier(const FormatToken &Tok) const {
791 switch (Tok.Tok.getKind()) {
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000792 case tok::kw_short:
793 case tok::kw_long:
794 case tok::kw___int64:
795 case tok::kw___int128:
796 case tok::kw_signed:
797 case tok::kw_unsigned:
798 case tok::kw_void:
799 case tok::kw_char:
800 case tok::kw_int:
801 case tok::kw_half:
802 case tok::kw_float:
803 case tok::kw_double:
804 case tok::kw_wchar_t:
805 case tok::kw_bool:
806 case tok::kw___underlying_type:
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000807 case tok::annot_typename:
808 case tok::kw_char16_t:
809 case tok::kw_char32_t:
810 case tok::kw_typeof:
811 case tok::kw_decltype:
Alexander Kornienko00895102013-06-05 14:09:10 +0000812 return true;
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000813 default:
Alexander Kornienko00895102013-06-05 14:09:10 +0000814 return false;
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000815 }
Daniel Jasper8ed9f2b2013-04-03 13:36:17 +0000816 }
817
Daniel Jasper4e778092013-02-06 10:05:46 +0000818 SmallVector<Context, 8> Contexts;
819
Daniel Jasper4e778092013-02-06 10:05:46 +0000820 AnnotatedLine &Line;
Manuel Klimekb3987012013-05-29 14:47:47 +0000821 FormatToken *CurrentToken;
Daniel Jasper4e778092013-02-06 10:05:46 +0000822 bool KeywordVirtualFound;
Daniel Jasper1407bee2013-04-11 14:29:13 +0000823 bool NameFound;
Daniel Jasper2ca37412013-07-09 14:36:48 +0000824 bool AutoFound;
Nico Weberc2e6d2a2013-02-11 15:32:15 +0000825 IdentifierInfo &Ident_in;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000826};
827
Daniel Jasper29f123b2013-02-08 15:28:42 +0000828/// \brief Parses binary expressions by inserting fake parenthesis based on
829/// operator precedence.
830class ExpressionParser {
831public:
Daniel Jasper9acb8b42013-06-06 09:11:58 +0000832 ExpressionParser(AnnotatedLine &Line) : Current(Line.First) {
833 // Skip leading "}", e.g. in "} else if (...) {".
834 if (Current->is(tok::r_brace))
835 next();
836 }
Daniel Jasper29f123b2013-02-08 15:28:42 +0000837
838 /// \brief Parse expressions with the given operatore precedence.
Daniel Jasper237d4c12013-02-23 21:01:55 +0000839 void parse(int Precedence = 0) {
Daniel Jasperc01897c2013-05-31 14:56:12 +0000840 // Conditional expressions need to be parsed separately for proper nesting.
841 if (Precedence == prec::Conditional + 1) {
842 parseConditionalExpr();
843 return;
844 }
Daniel Jasper29f123b2013-02-08 15:28:42 +0000845 if (Precedence > prec::PointerToMember || Current == NULL)
846 return;
847
Manuel Klimekb3987012013-05-29 14:47:47 +0000848 FormatToken *Start = Current;
Daniel Jasper29f123b2013-02-08 15:28:42 +0000849 bool OperatorFound = false;
850
Daniel Jasper237d4c12013-02-23 21:01:55 +0000851 while (Current) {
Daniel Jasper29f123b2013-02-08 15:28:42 +0000852 // Consume operators with higher precedence.
Daniel Jasperbf71ba22013-04-08 20:33:42 +0000853 parse(Precedence + 1);
Daniel Jasper29f123b2013-02-08 15:28:42 +0000854
Daniel Jasper237d4c12013-02-23 21:01:55 +0000855 int CurrentPrecedence = 0;
856 if (Current) {
857 if (Current->Type == TT_ConditionalExpr)
Daniel Jasperb8b42952013-05-31 16:14:28 +0000858 CurrentPrecedence = 1 + (int)prec::Conditional;
Daniel Jasperbf71ba22013-04-08 20:33:42 +0000859 else if (Current->is(tok::semi) || Current->Type == TT_InlineASMColon)
Daniel Jasper237d4c12013-02-23 21:01:55 +0000860 CurrentPrecedence = 1;
861 else if (Current->Type == TT_BinaryOperator || Current->is(tok::comma))
Daniel Jasperb8b42952013-05-31 16:14:28 +0000862 CurrentPrecedence = 1 + (int)Current->getPrecedence();
Daniel Jasper237d4c12013-02-23 21:01:55 +0000863 }
864
Daniel Jasper29f123b2013-02-08 15:28:42 +0000865 // At the end of the line or when an operator with higher precedence is
866 // found, insert fake parenthesis and return.
Daniel Jasperac3223e2013-04-10 09:49:49 +0000867 if (Current == NULL || Current->closesScope() ||
Daniel Jasper237d4c12013-02-23 21:01:55 +0000868 (CurrentPrecedence != 0 && CurrentPrecedence < Precedence)) {
Daniel Jasperc01897c2013-05-31 14:56:12 +0000869 if (OperatorFound)
870 addFakeParenthesis(Start, prec::Level(Precedence - 1));
Daniel Jasper29f123b2013-02-08 15:28:42 +0000871 return;
872 }
873
874 // Consume scopes: (), [], <> and {}
Daniel Jasperac3223e2013-04-10 09:49:49 +0000875 if (Current->opensScope()) {
876 while (Current && !Current->closesScope()) {
Daniel Jasper29f123b2013-02-08 15:28:42 +0000877 next();
878 parse();
879 }
880 next();
881 } else {
882 // Operator found.
Daniel Jasper237d4c12013-02-23 21:01:55 +0000883 if (CurrentPrecedence == Precedence)
Daniel Jasper29f123b2013-02-08 15:28:42 +0000884 OperatorFound = true;
885
886 next();
887 }
888 }
889 }
890
891private:
Daniel Jasperc01897c2013-05-31 14:56:12 +0000892 void addFakeParenthesis(FormatToken *Start, prec::Level Precedence) {
893 Start->FakeLParens.push_back(Precedence);
894 if (Current)
895 ++Current->Previous->FakeRParens;
896 }
897
898 void parseConditionalExpr() {
899 FormatToken *Start = Current;
900 parse(prec::LogicalOr + 1);
901 if (!Current || !Current->is(tok::question))
902 return;
903 next();
904 parse(prec::LogicalOr + 1);
905 if (!Current || Current->Type != TT_ConditionalExpr)
906 return;
907 next();
908 parseConditionalExpr();
909 addFakeParenthesis(Start, prec::Conditional);
910 }
911
Daniel Jasper29f123b2013-02-08 15:28:42 +0000912 void next() {
Alexander Kornienkod71b15b2013-06-17 13:19:53 +0000913 if (Current)
914 Current = Current->Next;
915 while (Current && Current->isTrailingComment())
Manuel Klimekb3987012013-05-29 14:47:47 +0000916 Current = Current->Next;
Daniel Jasper29f123b2013-02-08 15:28:42 +0000917 }
918
Manuel Klimekb3987012013-05-29 14:47:47 +0000919 FormatToken *Current;
Daniel Jasper29f123b2013-02-08 15:28:42 +0000920};
921
Craig Topper14e66492013-07-01 04:03:19 +0000922} // end anonymous namespace
923
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000924void TokenAnnotator::annotate(AnnotatedLine &Line) {
Alexander Kornienko00895102013-06-05 14:09:10 +0000925 AnnotatingParser Parser(Line, Ident_in);
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000926 Line.Type = Parser.parseLine();
927 if (Line.Type == LT_Invalid)
928 return;
929
Daniel Jasper29f123b2013-02-08 15:28:42 +0000930 ExpressionParser ExprParser(Line);
931 ExprParser.parse();
932
Manuel Klimekb3987012013-05-29 14:47:47 +0000933 if (Line.First->Type == TT_ObjCMethodSpecifier)
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000934 Line.Type = LT_ObjCMethodDecl;
Manuel Klimekb3987012013-05-29 14:47:47 +0000935 else if (Line.First->Type == TT_ObjCDecl)
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000936 Line.Type = LT_ObjCDecl;
Manuel Klimekb3987012013-05-29 14:47:47 +0000937 else if (Line.First->Type == TT_ObjCProperty)
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000938 Line.Type = LT_ObjCProperty;
939
Manuel Klimekb3987012013-05-29 14:47:47 +0000940 Line.First->SpacesRequiredBefore = 1;
941 Line.First->CanBreakBefore = Line.First->MustBreakBefore;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000942}
943
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000944void TokenAnnotator::calculateFormattingInformation(AnnotatedLine &Line) {
Alexander Kornienko00895102013-06-05 14:09:10 +0000945 Line.First->TotalLength = Line.First->CodePointCount;
Manuel Klimekb3987012013-05-29 14:47:47 +0000946 if (!Line.First->Next)
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000947 return;
Manuel Klimekb3987012013-05-29 14:47:47 +0000948 FormatToken *Current = Line.First->Next;
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000949 while (Current != NULL) {
Daniel Jasper729a7432013-02-11 12:36:37 +0000950 if (Current->Type == TT_LineComment)
951 Current->SpacesRequiredBefore = Style.SpacesBeforeTrailingComments;
952 else
953 Current->SpacesRequiredBefore =
954 spaceRequiredBefore(Line, *Current) ? 1 : 0;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000955
Daniel Jasper561211d2013-07-16 20:28:33 +0000956 if (Current->is(tok::comment)) {
Manuel Klimekb3987012013-05-29 14:47:47 +0000957 Current->MustBreakBefore = Current->NewlinesBefore > 0;
958 } else if (Current->Previous->isTrailingComment() ||
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000959 (Current->is(tok::string_literal) &&
Manuel Klimekb3987012013-05-29 14:47:47 +0000960 Current->Previous->is(tok::string_literal))) {
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000961 Current->MustBreakBefore = true;
Daniel Jasper561211d2013-07-16 20:28:33 +0000962 } else if (Current->Previous->IsUnterminatedLiteral) {
963 Current->MustBreakBefore = true;
Manuel Klimekb3987012013-05-29 14:47:47 +0000964 } else if (Current->is(tok::lessless) && Current->Next &&
965 Current->Previous->is(tok::string_literal) &&
966 Current->Next->is(tok::string_literal)) {
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000967 Current->MustBreakBefore = true;
Manuel Klimekb3987012013-05-29 14:47:47 +0000968 } else if (Current->Previous->ClosesTemplateDeclaration &&
Daniel Jasperbbc87762013-05-29 12:07:31 +0000969 Style.AlwaysBreakTemplateDeclarations) {
970 Current->MustBreakBefore = true;
Daniel Jaspere8b10d32013-07-26 16:56:36 +0000971 } else if (Current->Type == TT_CtorInitializerComma &&
972 Style.BreakConstructorInitializersBeforeComma) {
973 Current->MustBreakBefore = true;
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000974 }
975 Current->CanBreakBefore =
976 Current->MustBreakBefore || canBreakBefore(Line, *Current);
Daniel Jasper215c57f2013-07-17 15:38:19 +0000977 if (Current->MustBreakBefore ||
978 (Current->is(tok::string_literal) &&
979 Current->TokenText.find("\\\n") != StringRef::npos))
Manuel Klimekb3987012013-05-29 14:47:47 +0000980 Current->TotalLength = Current->Previous->TotalLength + Style.ColumnLimit;
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000981 else
Daniel Jasper2a409b62013-07-08 14:34:09 +0000982 Current->TotalLength = Current->Previous->TotalLength +
983 Current->CodePointCount +
984 Current->SpacesRequiredBefore;
Daniel Jasper8ff690a2013-02-06 14:22:40 +0000985 // FIXME: Only calculate this if CanBreakBefore is true once static
986 // initializers etc. are sorted out.
987 // FIXME: Move magic numbers to a better place.
988 Current->SplitPenalty =
989 20 * Current->BindingStrength + splitPenalty(Line, *Current);
990
Manuel Klimekb3987012013-05-29 14:47:47 +0000991 Current = Current->Next;
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000992 }
Daniel Jasperbf71ba22013-04-08 20:33:42 +0000993
Manuel Klimeke573c3f2013-05-22 12:51:29 +0000994 calculateUnbreakableTailLengths(Line);
Daniel Jasperbf71ba22013-04-08 20:33:42 +0000995 DEBUG({
996 printDebugInfo(Line);
997 });
Daniel Jasper32d28ee2013-01-29 21:01:14 +0000998}
999
Manuel Klimeke573c3f2013-05-22 12:51:29 +00001000void TokenAnnotator::calculateUnbreakableTailLengths(AnnotatedLine &Line) {
1001 unsigned UnbreakableTailLength = 0;
Manuel Klimekb3987012013-05-29 14:47:47 +00001002 FormatToken *Current = Line.Last;
Manuel Klimeke573c3f2013-05-22 12:51:29 +00001003 while (Current != NULL) {
1004 Current->UnbreakableTailLength = UnbreakableTailLength;
1005 if (Current->CanBreakBefore ||
1006 Current->isOneOf(tok::comment, tok::string_literal)) {
1007 UnbreakableTailLength = 0;
1008 } else {
1009 UnbreakableTailLength +=
Alexander Kornienko00895102013-06-05 14:09:10 +00001010 Current->CodePointCount + Current->SpacesRequiredBefore;
Manuel Klimeke573c3f2013-05-22 12:51:29 +00001011 }
Manuel Klimekb3987012013-05-29 14:47:47 +00001012 Current = Current->Previous;
Manuel Klimeke573c3f2013-05-22 12:51:29 +00001013 }
1014}
1015
Daniel Jasper8ff690a2013-02-06 14:22:40 +00001016unsigned TokenAnnotator::splitPenalty(const AnnotatedLine &Line,
Manuel Klimekb3987012013-05-29 14:47:47 +00001017 const FormatToken &Tok) {
1018 const FormatToken &Left = *Tok.Previous;
1019 const FormatToken &Right = Tok;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001020
Daniel Jasper5ad390d2013-05-28 11:30:49 +00001021 if (Left.is(tok::semi))
1022 return 0;
1023 if (Left.is(tok::comma))
1024 return 1;
Daniel Jasper011c35d2013-07-12 11:19:37 +00001025 if (Right.is(tok::l_square))
1026 return 150;
Daniel Jasper5ad390d2013-05-28 11:30:49 +00001027
Daniel Jasper6561f6a2013-07-09 07:43:55 +00001028 if (Right.Type == TT_StartOfName || Right.is(tok::kw_operator)) {
Manuel Klimekb3987012013-05-29 14:47:47 +00001029 if (Line.First->is(tok::kw_for) && Right.PartOfMultiVariableDeclStmt)
Daniel Jasper3c08a812013-02-24 18:54:32 +00001030 return 3;
Daniel Jasperc18cff32013-07-11 12:34:23 +00001031 if (Left.Type == TT_StartOfName)
1032 return 20;
Daniel Jasper3c08a812013-02-24 18:54:32 +00001033 else if (Line.MightBeFunctionDecl && Right.BindingStrength == 1)
1034 // FIXME: Clean up hack of using BindingStrength to find top-level names.
1035 return Style.PenaltyReturnTypeOnItsOwnLine;
1036 else
Daniel Jasper1407bee2013-04-11 14:29:13 +00001037 return 200;
Daniel Jasper3c08a812013-02-24 18:54:32 +00001038 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001039 if (Left.is(tok::equal) && Right.is(tok::l_brace))
1040 return 150;
Daniel Jasper198c8bf2013-07-05 07:58:34 +00001041 if (Left.Type == TT_CastRParen)
1042 return 100;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001043 if (Left.is(tok::coloncolon))
1044 return 500;
Daniel Jasper6b119d62013-04-05 17:22:09 +00001045 if (Left.isOneOf(tok::kw_class, tok::kw_struct))
1046 return 5000;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001047
Daniel Jasper6cabab42013-02-14 08:42:54 +00001048 if (Left.Type == TT_RangeBasedForLoopColon ||
1049 Left.Type == TT_InheritanceColon)
Daniel Jasper84a1a632013-02-26 13:18:08 +00001050 return 2;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001051
Daniel Jasper5ad390d2013-05-28 11:30:49 +00001052 if (Right.isOneOf(tok::arrow, tok::period) &&
1053 Right.Type != TT_DesignatedInitializerPeriod) {
Daniel Jasper515f65d2013-02-18 13:24:21 +00001054 if (Line.Type == LT_BuilderTypeCall)
Daniel Jasper6a365aa2013-03-13 17:13:53 +00001055 return prec::PointerToMember;
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001056 if (Left.isOneOf(tok::r_paren, tok::r_square) && Left.MatchingParen &&
1057 Left.MatchingParen->ParameterCount > 0)
Daniel Jasper518ee342013-02-26 13:59:14 +00001058 return 20; // Should be smaller than breaking at a nested comma.
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001059 return 150;
1060 }
1061
Daniel Jasper20a0f8c2013-07-11 21:02:56 +00001062 // Breaking before a trailing 'const' or not-function-like annotation is bad.
1063 if (Left.is(tok::r_paren) &&
1064 (Right.is(tok::kw_const) || (Right.is(tok::identifier) && Right.Next &&
1065 Right.Next->isNot(tok::l_paren))))
Daniel Jasper5ad72bb2013-05-22 08:28:26 +00001066 return 150;
1067
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001068 // In for-loops, prefer breaking at ',' and ';'.
Manuel Klimekb3987012013-05-29 14:47:47 +00001069 if (Line.First->is(tok::kw_for) && Left.is(tok::equal))
Daniel Jasper7d812812013-02-21 15:00:29 +00001070 return 4;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001071
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001072 // In Objective-C method expressions, prefer breaking before "param:" over
1073 // breaking after it.
Daniel Jasper63d7ced2013-02-05 10:07:47 +00001074 if (Right.Type == TT_ObjCSelectorName)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001075 return 0;
Daniel Jasper63d7ced2013-02-05 10:07:47 +00001076 if (Left.is(tok::colon) && Left.Type == TT_ObjCMethodExpr)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001077 return 20;
1078
Daniel Jasper1407bee2013-04-11 14:29:13 +00001079 if (Left.is(tok::l_paren) && Line.MightBeFunctionDecl)
1080 return 100;
Daniel Jasperac3223e2013-04-10 09:49:49 +00001081 if (Left.opensScope())
Daniel Jasper64f09282013-03-20 13:53:11 +00001082 return Left.ParameterCount > 1 ? prec::Comma : 20;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001083
Daniel Jasper4e8a7b42013-02-06 21:04:05 +00001084 if (Right.is(tok::lessless)) {
1085 if (Left.is(tok::string_literal)) {
Alexander Kornienko00895102013-06-05 14:09:10 +00001086 StringRef Content = Left.TokenText;
Daniel Jasperbfa1edd2013-03-14 14:00:17 +00001087 Content = Content.drop_back(1).drop_front(1).trim();
1088 if (Content.size() > 1 &&
1089 (Content.back() == ':' || Content.back() == '='))
Daniel Jasper9637dda2013-07-15 14:33:14 +00001090 return 25;
Daniel Jasper4e8a7b42013-02-06 21:04:05 +00001091 }
Daniel Jasper0c368782013-07-15 15:04:42 +00001092 return 1; // Breaking at a << is really cheap.
Daniel Jasper4e8a7b42013-02-06 21:04:05 +00001093 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001094 if (Left.Type == TT_ConditionalExpr)
Daniel Jasper518ee342013-02-26 13:59:14 +00001095 return prec::Conditional;
Manuel Klimekb3987012013-05-29 14:47:47 +00001096 prec::Level Level = Left.getPrecedence();
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001097
1098 if (Level != prec::Unknown)
1099 return Level;
Daniel Jasper24849712013-03-01 16:48:32 +00001100
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001101 return 3;
1102}
1103
Daniel Jasper8ff690a2013-02-06 14:22:40 +00001104bool TokenAnnotator::spaceRequiredBetween(const AnnotatedLine &Line,
Manuel Klimekb3987012013-05-29 14:47:47 +00001105 const FormatToken &Left,
1106 const FormatToken &Right) {
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001107 if (Right.is(tok::hashhash))
1108 return Left.is(tok::hash);
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001109 if (Left.isOneOf(tok::hashhash, tok::hash))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001110 return Right.is(tok::hash);
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001111 if (Right.isOneOf(tok::r_paren, tok::semi, tok::comma))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001112 return false;
1113 if (Right.is(tok::less) &&
1114 (Left.is(tok::kw_template) ||
1115 (Line.Type == LT_ObjCDecl && Style.ObjCSpaceBeforeProtocolList)))
1116 return true;
1117 if (Left.is(tok::arrow) || Right.is(tok::arrow))
1118 return false;
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001119 if (Left.isOneOf(tok::exclaim, tok::tilde))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001120 return false;
1121 if (Left.is(tok::at) &&
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001122 Right.isOneOf(tok::identifier, tok::string_literal, tok::char_constant,
1123 tok::numeric_constant, tok::l_paren, tok::l_brace,
1124 tok::kw_true, tok::kw_false))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001125 return false;
1126 if (Left.is(tok::coloncolon))
1127 return false;
1128 if (Right.is(tok::coloncolon))
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001129 return !Left.isOneOf(tok::identifier, tok::greater, tok::l_paren);
1130 if (Left.is(tok::less) || Right.isOneOf(tok::greater, tok::less))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001131 return false;
Daniel Jasperc47d7f12013-07-01 09:47:25 +00001132 if (Right.is(tok::ellipsis))
1133 return false;
Alexander Kornienko3fd9ccd2013-03-12 16:28:18 +00001134 if (Right.Type == TT_PointerOrReference)
Manuel Klimekb3987012013-05-29 14:47:47 +00001135 return Left.Tok.isLiteral() ||
Alexander Kornienko3fd9ccd2013-03-12 16:28:18 +00001136 ((Left.Type != TT_PointerOrReference) && Left.isNot(tok::l_paren) &&
1137 !Style.PointerBindsToType);
Daniel Jasper3ff4a2f2013-05-28 15:27:10 +00001138 if (Right.Type == TT_FunctionTypeLParen && Left.isNot(tok::l_paren) &&
Daniel Jasper395228f2013-05-08 14:58:20 +00001139 (Left.Type != TT_PointerOrReference || Style.PointerBindsToType))
1140 return true;
Alexander Kornienko3fd9ccd2013-03-12 16:28:18 +00001141 if (Left.Type == TT_PointerOrReference)
Daniel Jasper3a1847e2013-07-01 09:34:09 +00001142 return Right.Tok.isLiteral() || Right.Type == TT_BlockComment ||
Daniel Jasper9322aae2013-03-20 09:53:18 +00001143 ((Right.Type != TT_PointerOrReference) &&
Daniel Jasper81d2d382013-04-01 17:13:26 +00001144 Right.isNot(tok::l_paren) && Style.PointerBindsToType &&
Manuel Klimekb3987012013-05-29 14:47:47 +00001145 Left.Previous &&
1146 !Left.Previous->isOneOf(tok::l_paren, tok::coloncolon));
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001147 if (Right.is(tok::star) && Left.is(tok::l_paren))
1148 return false;
Nico Weber051860e2013-02-10 02:08:05 +00001149 if (Left.is(tok::l_square))
1150 return Left.Type == TT_ObjCArrayLiteral && Right.isNot(tok::r_square);
1151 if (Right.is(tok::r_square))
1152 return Right.Type == TT_ObjCArrayLiteral;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001153 if (Right.is(tok::l_square) && Right.Type != TT_ObjCMethodExpr)
1154 return false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001155 if (Left.is(tok::colon))
1156 return Left.Type != TT_ObjCMethodExpr;
1157 if (Right.is(tok::colon))
1158 return Right.Type != TT_ObjCMethodExpr;
1159 if (Left.is(tok::l_paren))
1160 return false;
1161 if (Right.is(tok::l_paren)) {
Daniel Jaspere0fa4c52013-07-17 20:25:02 +00001162 if (Left.is(tok::r_paren) && Left.MatchingParen &&
1163 Left.MatchingParen->Previous &&
1164 Left.MatchingParen->Previous->is(tok::kw___attribute))
1165 return true;
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001166 return Line.Type == LT_ObjCDecl ||
1167 Left.isOneOf(tok::kw_if, tok::kw_for, tok::kw_while, tok::kw_switch,
1168 tok::kw_return, tok::kw_catch, tok::kw_new,
Daniel Jasper454cb702013-05-03 14:50:50 +00001169 tok::kw_delete, tok::semi);
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001170 }
Manuel Klimekb3987012013-05-29 14:47:47 +00001171 if (Left.is(tok::at) && Right.Tok.getObjCKeywordID() != tok::objc_not_keyword)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001172 return false;
1173 if (Left.is(tok::l_brace) && Right.is(tok::r_brace))
Daniel Jasper2424eef2013-05-23 10:15:45 +00001174 return false; // No spaces in "{}".
1175 if (Left.is(tok::l_brace) || Right.is(tok::r_brace))
Daniel Jasperb5dc3f42013-07-16 18:22:10 +00001176 return !Style.Cpp11BracedListStyle;
Daniel Jasper1bee0732013-05-23 18:05:18 +00001177 if (Right.Type == TT_UnaryOperator)
1178 return !Left.isOneOf(tok::l_paren, tok::l_square, tok::at) &&
1179 (Left.isNot(tok::colon) || Left.Type != TT_ObjCMethodExpr);
Daniel Jasperce933562013-05-23 21:35:49 +00001180 if (Left.isOneOf(tok::identifier, tok::greater, tok::r_square) &&
Alexander Kornienko0bdc6432013-07-04 14:47:51 +00001181 Right.is(tok::l_brace) && Right.getNextNonComment())
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001182 return false;
Daniel Jasper5ad390d2013-05-28 11:30:49 +00001183 if (Left.is(tok::period) || Right.is(tok::period))
1184 return false;
Nico Weber861576b2013-06-26 00:15:19 +00001185 if (Left.Type == TT_BlockComment && Left.TokenText.endswith("=*/"))
1186 return false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001187 return true;
1188}
1189
Daniel Jasper8ff690a2013-02-06 14:22:40 +00001190bool TokenAnnotator::spaceRequiredBefore(const AnnotatedLine &Line,
Manuel Klimekb3987012013-05-29 14:47:47 +00001191 const FormatToken &Tok) {
1192 if (Tok.Tok.getIdentifierInfo() && Tok.Previous->Tok.getIdentifierInfo())
Daniel Jasper2b4c9242013-02-11 08:01:18 +00001193 return true; // Never ever merge two identifiers.
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001194 if (Line.Type == LT_ObjCMethodDecl) {
Manuel Klimekb3987012013-05-29 14:47:47 +00001195 if (Tok.Previous->Type == TT_ObjCMethodSpecifier)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001196 return true;
Manuel Klimekb3987012013-05-29 14:47:47 +00001197 if (Tok.Previous->is(tok::r_paren) && Tok.is(tok::identifier))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001198 // Don't space between ')' and <id>
1199 return false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001200 }
1201 if (Line.Type == LT_ObjCProperty &&
Manuel Klimekb3987012013-05-29 14:47:47 +00001202 (Tok.is(tok::equal) || Tok.Previous->is(tok::equal)))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001203 return false;
1204
Daniel Jasper2ca37412013-07-09 14:36:48 +00001205 if (Tok.Type == TT_TrailingReturnArrow ||
1206 Tok.Previous->Type == TT_TrailingReturnArrow)
1207 return true;
Manuel Klimekb3987012013-05-29 14:47:47 +00001208 if (Tok.Previous->is(tok::comma))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001209 return true;
Daniel Jasper9c3c7b32013-02-28 13:40:17 +00001210 if (Tok.is(tok::comma))
1211 return false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001212 if (Tok.Type == TT_CtorInitializerColon || Tok.Type == TT_ObjCBlockLParen)
1213 return true;
Manuel Klimekb3987012013-05-29 14:47:47 +00001214 if (Tok.Previous->Tok.is(tok::kw_operator))
Daniel Jasper2b4c9242013-02-11 08:01:18 +00001215 return false;
1216 if (Tok.Type == TT_OverloadedOperatorLParen)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001217 return false;
1218 if (Tok.is(tok::colon))
Manuel Klimekb3987012013-05-29 14:47:47 +00001219 return !Line.First->isOneOf(tok::kw_case, tok::kw_default) &&
Alexander Kornienko0bdc6432013-07-04 14:47:51 +00001220 Tok.getNextNonComment() != NULL && Tok.Type != TT_ObjCMethodExpr;
Manuel Klimekb3987012013-05-29 14:47:47 +00001221 if (Tok.Previous->Type == TT_UnaryOperator ||
1222 Tok.Previous->Type == TT_CastRParen)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001223 return false;
Manuel Klimekb3987012013-05-29 14:47:47 +00001224 if (Tok.Previous->is(tok::greater) && Tok.is(tok::greater)) {
Daniel Jasper29f123b2013-02-08 15:28:42 +00001225 return Tok.Type == TT_TemplateCloser &&
Manuel Klimekb3987012013-05-29 14:47:47 +00001226 Tok.Previous->Type == TT_TemplateCloser &&
Daniel Jasper29f123b2013-02-08 15:28:42 +00001227 Style.Standard != FormatStyle::LS_Cpp11;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001228 }
Alexander Kornienko54a38bd2013-03-20 16:41:56 +00001229 if (Tok.isOneOf(tok::arrowstar, tok::periodstar) ||
Manuel Klimekb3987012013-05-29 14:47:47 +00001230 Tok.Previous->isOneOf(tok::arrowstar, tok::periodstar))
Daniel Jasper9c3c7b32013-02-28 13:40:17 +00001231 return false;
Manuel Klimekb3987012013-05-29 14:47:47 +00001232 if (Tok.Type == TT_BinaryOperator || Tok.Previous->Type == TT_BinaryOperator)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001233 return true;
Manuel Klimekb3987012013-05-29 14:47:47 +00001234 if (Tok.Previous->Type == TT_TemplateCloser && Tok.is(tok::l_paren))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001235 return false;
Manuel Klimekb3987012013-05-29 14:47:47 +00001236 if (Tok.is(tok::less) && Line.First->is(tok::hash))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001237 return true;
1238 if (Tok.Type == TT_TrailingUnaryOperator)
1239 return false;
Manuel Klimekb3987012013-05-29 14:47:47 +00001240 return spaceRequiredBetween(Line, *Tok.Previous, Tok);
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001241}
1242
Daniel Jasper8ff690a2013-02-06 14:22:40 +00001243bool TokenAnnotator::canBreakBefore(const AnnotatedLine &Line,
Manuel Klimekb3987012013-05-29 14:47:47 +00001244 const FormatToken &Right) {
1245 const FormatToken &Left = *Right.Previous;
Daniel Jasper6561f6a2013-07-09 07:43:55 +00001246 if (Right.Type == TT_StartOfName || Right.is(tok::kw_operator))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001247 return true;
Nico Weberf2ff8122013-05-26 05:39:26 +00001248 if (Right.is(tok::colon) &&
1249 (Right.Type == TT_ObjCDictLiteral || Right.Type == TT_ObjCMethodExpr))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001250 return false;
Nico Weberf2ff8122013-05-26 05:39:26 +00001251 if (Left.is(tok::colon) &&
1252 (Left.Type == TT_ObjCDictLiteral || Left.Type == TT_ObjCMethodExpr))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001253 return true;
Daniel Jasper63d7ced2013-02-05 10:07:47 +00001254 if (Right.Type == TT_ObjCSelectorName)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001255 return true;
1256 if (Left.ClosesTemplateDeclaration)
1257 return true;
1258 if (Right.Type == TT_ConditionalExpr || Right.is(tok::question))
1259 return true;
Daniel Jasper6cabab42013-02-14 08:42:54 +00001260 if (Right.Type == TT_RangeBasedForLoopColon ||
Daniel Jasper27b91cc2013-04-05 17:21:59 +00001261 Right.Type == TT_OverloadedOperatorLParen)
Daniel Jasper6cabab42013-02-14 08:42:54 +00001262 return false;
Daniel Jasperc194c952013-05-06 06:45:09 +00001263 if (Left.Type == TT_RangeBasedForLoopColon)
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001264 return true;
Daniel Jasper7d812812013-02-21 15:00:29 +00001265 if (Right.Type == TT_RangeBasedForLoopColon)
1266 return false;
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001267 if (Left.Type == TT_PointerOrReference || Left.Type == TT_TemplateCloser ||
1268 Left.Type == TT_UnaryOperator || Left.Type == TT_ConditionalExpr ||
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001269 Left.isOneOf(tok::question, tok::kw_operator))
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001270 return false;
1271 if (Left.is(tok::equal) && Line.Type == LT_VirtualFunctionDecl)
1272 return false;
Daniel Jasper198c8bf2013-07-05 07:58:34 +00001273 if (Left.Previous) {
1274 if (Left.is(tok::l_paren) && Right.is(tok::l_paren) &&
1275 Left.Previous->is(tok::kw___attribute))
1276 return false;
Daniel Jasper2ca37412013-07-09 14:36:48 +00001277 if (Left.is(tok::l_paren) && (Left.Previous->Type == TT_BinaryOperator ||
Daniel Jasper5e2169f2013-07-18 14:46:07 +00001278 Left.Previous->Type == TT_CastRParen))
Daniel Jasper198c8bf2013-07-05 07:58:34 +00001279 return false;
1280 }
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001281
Daniel Jasper65d2c382013-06-06 16:08:57 +00001282 if (Right.isTrailingComment())
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001283 // We rely on MustBreakBefore being set correctly here as we should not
1284 // change the "binding" behavior of a comment.
1285 return false;
1286
Daniel Jasper5ad72bb2013-05-22 08:28:26 +00001287 // We only break before r_brace if there was a corresponding break before
1288 // the l_brace, which is tracked by BreakBeforeClosingBrace.
Daniel Jaspere8b10d32013-07-26 16:56:36 +00001289 if (Right.isOneOf(tok::r_brace, tok::r_paren) ||
1290 Right.Type == TT_TemplateCloser)
Daniel Jasper5ad72bb2013-05-22 08:28:26 +00001291 return false;
1292
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001293 // Allow breaking after a trailing 'const', e.g. after a method declaration,
1294 // unless it is follow by ';', '{' or '='.
Manuel Klimekb3987012013-05-29 14:47:47 +00001295 if (Left.is(tok::kw_const) && Left.Previous != NULL &&
1296 Left.Previous->is(tok::r_paren))
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001297 return !Right.isOneOf(tok::l_brace, tok::semi, tok::equal);
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001298
Daniel Jasper8ef19a22013-03-14 09:50:46 +00001299 if (Right.is(tok::kw___attribute))
1300 return true;
1301
Daniel Jasper3a204412013-02-23 07:46:38 +00001302 if (Left.is(tok::identifier) && Right.is(tok::string_literal))
1303 return true;
Daniel Jaspere8b10d32013-07-26 16:56:36 +00001304
1305 if (Left.Type == TT_CtorInitializerComma &&
1306 Style.BreakConstructorInitializersBeforeComma)
1307 return false;
1308 if (Right.isBinaryOperator() && Style.BreakBeforeBinaryOperators)
1309 return true;
1310 return (Left.isBinaryOperator() && Left.isNot(tok::lessless) &&
1311 !Style.BreakBeforeBinaryOperators) ||
Daniel Jasper6b119d62013-04-05 17:22:09 +00001312 Left.isOneOf(tok::comma, tok::coloncolon, tok::semi, tok::l_brace,
1313 tok::kw_class, tok::kw_struct) ||
Alexander Kornienkoe74de282013-03-13 14:41:29 +00001314 Right.isOneOf(tok::lessless, tok::arrow, tok::period, tok::colon) ||
Daniel Jasper198c8bf2013-07-05 07:58:34 +00001315 (Left.is(tok::r_paren) &&
Daniel Jaspere033e872013-05-21 09:16:31 +00001316 Right.isOneOf(tok::identifier, tok::kw_const, tok::kw___attribute)) ||
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001317 (Left.is(tok::l_paren) && !Right.is(tok::r_paren)) ||
Daniel Jasper011c35d2013-07-12 11:19:37 +00001318 Right.is(tok::l_square);
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001319}
1320
Daniel Jasperbf71ba22013-04-08 20:33:42 +00001321void TokenAnnotator::printDebugInfo(const AnnotatedLine &Line) {
1322 llvm::errs() << "AnnotatedTokens:\n";
Manuel Klimekb3987012013-05-29 14:47:47 +00001323 const FormatToken *Tok = Line.First;
Daniel Jasperbf71ba22013-04-08 20:33:42 +00001324 while (Tok) {
Manuel Klimekb3987012013-05-29 14:47:47 +00001325 llvm::errs() << " M=" << Tok->MustBreakBefore
Daniel Jasperc7bd68f2013-07-10 14:02:49 +00001326 << " C=" << Tok->CanBreakBefore << " T=" << Tok->Type
1327 << " S=" << Tok->SpacesRequiredBefore
1328 << " P=" << Tok->SplitPenalty << " Name=" << Tok->Tok.getName()
1329 << " PPK=" << Tok->PackingKind << " FakeLParens=";
Daniel Jasperbf71ba22013-04-08 20:33:42 +00001330 for (unsigned i = 0, e = Tok->FakeLParens.size(); i != e; ++i)
1331 llvm::errs() << Tok->FakeLParens[i] << "/";
1332 llvm::errs() << " FakeRParens=" << Tok->FakeRParens << "\n";
Manuel Klimekb3987012013-05-29 14:47:47 +00001333 Tok = Tok->Next;
Daniel Jasperbf71ba22013-04-08 20:33:42 +00001334 }
1335 llvm::errs() << "----\n";
1336}
1337
Daniel Jasper32d28ee2013-01-29 21:01:14 +00001338} // namespace format
1339} // namespace clang