blob: 680bb1301317915f85789a3ccd5527e3e3a93314 [file] [log] [blame]
Daniel Jasperf7935112012-12-03 18:12:45 +00001//===--- Format.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 functions declared in Format.h. This will be
12/// split into separate files as we go.
13///
Daniel Jasperf7935112012-12-03 18:12:45 +000014//===----------------------------------------------------------------------===//
15
Manuel Klimek24998102013-01-16 14:55:28 +000016#define DEBUG_TYPE "format-formatter"
17
Alexander Kornienkocb45bc12013-04-15 14:28:00 +000018#include "BreakableToken.h"
Daniel Jasper7a6d09b2013-01-29 21:01:14 +000019#include "TokenAnnotator.h"
Chandler Carruth3a022472012-12-04 09:13:33 +000020#include "UnwrappedLineParser.h"
Alexander Kornienkocb45bc12013-04-15 14:28:00 +000021#include "WhitespaceManager.h"
Daniel Jasperec04c0d2013-05-16 10:40:07 +000022#include "clang/Basic/Diagnostic.h"
Daniel Jasperab7654e2012-12-21 10:20:02 +000023#include "clang/Basic/OperatorPrecedence.h"
Chandler Carruth44eb4f62013-01-02 10:28:36 +000024#include "clang/Basic/SourceManager.h"
Manuel Klimek24998102013-01-16 14:55:28 +000025#include "clang/Format/Format.h"
Daniel Jasperf7935112012-12-03 18:12:45 +000026#include "clang/Lex/Lexer.h"
Alexander Kornienkoffd6d042013-03-27 11:52:18 +000027#include "llvm/ADT/STLExtras.h"
Manuel Klimek2ef908e2013-02-13 10:46:36 +000028#include "llvm/Support/Allocator.h"
Manuel Klimek24998102013-01-16 14:55:28 +000029#include "llvm/Support/Debug.h"
Alexander Kornienkod6538332013-05-07 15:32:14 +000030#include "llvm/Support/YAMLTraits.h"
Manuel Klimek2ef908e2013-02-13 10:46:36 +000031#include <queue>
Daniel Jasper8b529712012-12-04 13:02:32 +000032#include <string>
33
Alexander Kornienkod6538332013-05-07 15:32:14 +000034namespace llvm {
35namespace yaml {
36template <>
37struct ScalarEnumerationTraits<clang::format::FormatStyle::LanguageStandard> {
Manuel Klimeka8eb9142013-05-13 12:51:40 +000038 static void enumeration(IO &IO,
39 clang::format::FormatStyle::LanguageStandard &Value) {
40 IO.enumCase(Value, "C++03", clang::format::FormatStyle::LS_Cpp03);
41 IO.enumCase(Value, "C++11", clang::format::FormatStyle::LS_Cpp11);
42 IO.enumCase(Value, "Auto", clang::format::FormatStyle::LS_Auto);
43 }
44};
45
Daniel Jasper12f9d8e2013-05-14 09:30:02 +000046template <>
Manuel Klimeka8eb9142013-05-13 12:51:40 +000047struct ScalarEnumerationTraits<clang::format::FormatStyle::BraceBreakingStyle> {
48 static void
49 enumeration(IO &IO, clang::format::FormatStyle::BraceBreakingStyle &Value) {
50 IO.enumCase(Value, "Attach", clang::format::FormatStyle::BS_Attach);
51 IO.enumCase(Value, "Linux", clang::format::FormatStyle::BS_Linux);
52 IO.enumCase(Value, "Stroustrup", clang::format::FormatStyle::BS_Stroustrup);
Alexander Kornienkod6538332013-05-07 15:32:14 +000053 }
54};
55
56template <> struct MappingTraits<clang::format::FormatStyle> {
57 static void mapping(llvm::yaml::IO &IO, clang::format::FormatStyle &Style) {
Alexander Kornienko49149672013-05-10 11:56:10 +000058 if (IO.outputting()) {
59 StringRef StylesArray[] = { "LLVM", "Google", "Chromium", "Mozilla" };
60 ArrayRef<StringRef> Styles(StylesArray);
61 for (size_t i = 0, e = Styles.size(); i < e; ++i) {
62 StringRef StyleName(Styles[i]);
Alexander Kornienko006b5c82013-05-19 00:53:30 +000063 clang::format::FormatStyle PredefinedStyle;
64 if (clang::format::getPredefinedStyle(StyleName, &PredefinedStyle) &&
65 Style == PredefinedStyle) {
Alexander Kornienko49149672013-05-10 11:56:10 +000066 IO.mapOptional("# BasedOnStyle", StyleName);
67 break;
68 }
69 }
70 } else {
Alexander Kornienkod6538332013-05-07 15:32:14 +000071 StringRef BasedOnStyle;
72 IO.mapOptional("BasedOnStyle", BasedOnStyle);
Alexander Kornienkod6538332013-05-07 15:32:14 +000073 if (!BasedOnStyle.empty())
Alexander Kornienko006b5c82013-05-19 00:53:30 +000074 if (!clang::format::getPredefinedStyle(BasedOnStyle, &Style)) {
75 IO.setError(Twine("Unknown value for BasedOnStyle: ", BasedOnStyle));
76 return;
77 }
Alexander Kornienkod6538332013-05-07 15:32:14 +000078 }
79
80 IO.mapOptional("AccessModifierOffset", Style.AccessModifierOffset);
81 IO.mapOptional("AlignEscapedNewlinesLeft", Style.AlignEscapedNewlinesLeft);
82 IO.mapOptional("AllowAllParametersOfDeclarationOnNextLine",
83 Style.AllowAllParametersOfDeclarationOnNextLine);
84 IO.mapOptional("AllowShortIfStatementsOnASingleLine",
85 Style.AllowShortIfStatementsOnASingleLine);
Daniel Jasper3a685df2013-05-16 12:12:21 +000086 IO.mapOptional("AllowShortLoopsOnASingleLine",
87 Style.AllowShortLoopsOnASingleLine);
Daniel Jasper61e6bbf2013-05-29 12:07:31 +000088 IO.mapOptional("AlwaysBreakTemplateDeclarations",
89 Style.AlwaysBreakTemplateDeclarations);
Alexander Kornienko58611712013-07-04 12:02:44 +000090 IO.mapOptional("AlwaysBreakBeforeMultilineStrings",
91 Style.AlwaysBreakBeforeMultilineStrings);
Alexander Kornienkod6538332013-05-07 15:32:14 +000092 IO.mapOptional("BinPackParameters", Style.BinPackParameters);
93 IO.mapOptional("ColumnLimit", Style.ColumnLimit);
94 IO.mapOptional("ConstructorInitializerAllOnOneLineOrOnePerLine",
95 Style.ConstructorInitializerAllOnOneLineOrOnePerLine);
96 IO.mapOptional("DerivePointerBinding", Style.DerivePointerBinding);
Daniel Jasperb10cbc42013-07-10 14:02:49 +000097 IO.mapOptional("ExperimentalAutoDetectBinPacking",
98 Style.ExperimentalAutoDetectBinPacking);
Alexander Kornienkod6538332013-05-07 15:32:14 +000099 IO.mapOptional("IndentCaseLabels", Style.IndentCaseLabels);
100 IO.mapOptional("MaxEmptyLinesToKeep", Style.MaxEmptyLinesToKeep);
101 IO.mapOptional("ObjCSpaceBeforeProtocolList",
102 Style.ObjCSpaceBeforeProtocolList);
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000103 IO.mapOptional("PenaltyBreakComment", Style.PenaltyBreakComment);
104 IO.mapOptional("PenaltyBreakString", Style.PenaltyBreakString);
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000105 IO.mapOptional("PenaltyBreakFirstLessLess",
106 Style.PenaltyBreakFirstLessLess);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000107 IO.mapOptional("PenaltyExcessCharacter", Style.PenaltyExcessCharacter);
108 IO.mapOptional("PenaltyReturnTypeOnItsOwnLine",
109 Style.PenaltyReturnTypeOnItsOwnLine);
110 IO.mapOptional("PointerBindsToType", Style.PointerBindsToType);
111 IO.mapOptional("SpacesBeforeTrailingComments",
112 Style.SpacesBeforeTrailingComments);
Daniel Jasper5bd0b9e2013-05-23 18:05:18 +0000113 IO.mapOptional("SpacesInBracedLists", Style.SpacesInBracedLists);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000114 IO.mapOptional("Standard", Style.Standard);
Manuel Klimek13b97d82013-05-13 08:42:42 +0000115 IO.mapOptional("IndentWidth", Style.IndentWidth);
Manuel Klimekb9eae4c2013-05-13 09:22:11 +0000116 IO.mapOptional("UseTab", Style.UseTab);
Manuel Klimeka8eb9142013-05-13 12:51:40 +0000117 IO.mapOptional("BreakBeforeBraces", Style.BreakBeforeBraces);
Manuel Klimek836c2862013-06-21 17:25:42 +0000118 IO.mapOptional("IndentFunctionDeclarationAfterType",
119 Style.IndentFunctionDeclarationAfterType);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000120 }
121};
122}
123}
124
Daniel Jasperf7935112012-12-03 18:12:45 +0000125namespace clang {
126namespace format {
127
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000128void setDefaultPenalties(FormatStyle &Style) {
129 Style.PenaltyBreakComment = 45;
130 Style.PenaltyBreakFirstLessLess = 100;
131 Style.PenaltyBreakString = 1000;
132 Style.PenaltyExcessCharacter = 1000000;
133}
134
Daniel Jasperf7935112012-12-03 18:12:45 +0000135FormatStyle getLLVMStyle() {
136 FormatStyle LLVMStyle;
Daniel Jasperf7935112012-12-03 18:12:45 +0000137 LLVMStyle.AccessModifierOffset = -2;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000138 LLVMStyle.AlignEscapedNewlinesLeft = false;
Daniel Jasperf7db4332013-01-29 16:03:49 +0000139 LLVMStyle.AllowAllParametersOfDeclarationOnNextLine = true;
Daniel Jasper1b750ed2013-01-14 16:24:39 +0000140 LLVMStyle.AllowShortIfStatementsOnASingleLine = false;
Daniel Jasper3a685df2013-05-16 12:12:21 +0000141 LLVMStyle.AllowShortLoopsOnASingleLine = false;
Daniel Jasper61e6bbf2013-05-29 12:07:31 +0000142 LLVMStyle.AlwaysBreakTemplateDeclarations = false;
Alexander Kornienko58611712013-07-04 12:02:44 +0000143 LLVMStyle.AlwaysBreakBeforeMultilineStrings = false;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000144 LLVMStyle.BinPackParameters = true;
145 LLVMStyle.ColumnLimit = 80;
146 LLVMStyle.ConstructorInitializerAllOnOneLineOrOnePerLine = false;
147 LLVMStyle.DerivePointerBinding = false;
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000148 LLVMStyle.ExperimentalAutoDetectBinPacking = false;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000149 LLVMStyle.IndentCaseLabels = false;
150 LLVMStyle.MaxEmptyLinesToKeep = 1;
Nico Webera6087752013-01-10 20:12:55 +0000151 LLVMStyle.ObjCSpaceBeforeProtocolList = true;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000152 LLVMStyle.PointerBindsToType = false;
153 LLVMStyle.SpacesBeforeTrailingComments = 1;
Daniel Jaspere5777d22013-05-23 10:15:45 +0000154 LLVMStyle.SpacesInBracedLists = true;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000155 LLVMStyle.Standard = FormatStyle::LS_Cpp03;
Manuel Klimek13b97d82013-05-13 08:42:42 +0000156 LLVMStyle.IndentWidth = 2;
Manuel Klimekb9eae4c2013-05-13 09:22:11 +0000157 LLVMStyle.UseTab = false;
Manuel Klimeka8eb9142013-05-13 12:51:40 +0000158 LLVMStyle.BreakBeforeBraces = FormatStyle::BS_Attach;
Manuel Klimek836c2862013-06-21 17:25:42 +0000159 LLVMStyle.IndentFunctionDeclarationAfterType = false;
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000160
161 setDefaultPenalties(LLVMStyle);
162 LLVMStyle.PenaltyReturnTypeOnItsOwnLine = 60;
163
Daniel Jasperf7935112012-12-03 18:12:45 +0000164 return LLVMStyle;
165}
166
167FormatStyle getGoogleStyle() {
168 FormatStyle GoogleStyle;
Daniel Jasperf7935112012-12-03 18:12:45 +0000169 GoogleStyle.AccessModifierOffset = -1;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000170 GoogleStyle.AlignEscapedNewlinesLeft = true;
Daniel Jasperf7db4332013-01-29 16:03:49 +0000171 GoogleStyle.AllowAllParametersOfDeclarationOnNextLine = true;
Daniel Jasper085a2ed2013-04-24 13:46:00 +0000172 GoogleStyle.AllowShortIfStatementsOnASingleLine = true;
Daniel Jasper5bd0b9e2013-05-23 18:05:18 +0000173 GoogleStyle.AllowShortLoopsOnASingleLine = true;
Daniel Jasper61e6bbf2013-05-29 12:07:31 +0000174 GoogleStyle.AlwaysBreakTemplateDeclarations = true;
Alexander Kornienko58611712013-07-04 12:02:44 +0000175 GoogleStyle.AlwaysBreakBeforeMultilineStrings = true;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000176 GoogleStyle.BinPackParameters = true;
177 GoogleStyle.ColumnLimit = 80;
178 GoogleStyle.ConstructorInitializerAllOnOneLineOrOnePerLine = true;
179 GoogleStyle.DerivePointerBinding = true;
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000180 GoogleStyle.ExperimentalAutoDetectBinPacking = false;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000181 GoogleStyle.IndentCaseLabels = true;
182 GoogleStyle.MaxEmptyLinesToKeep = 1;
Nico Webera6087752013-01-10 20:12:55 +0000183 GoogleStyle.ObjCSpaceBeforeProtocolList = false;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000184 GoogleStyle.PointerBindsToType = true;
185 GoogleStyle.SpacesBeforeTrailingComments = 2;
Daniel Jaspere5777d22013-05-23 10:15:45 +0000186 GoogleStyle.SpacesInBracedLists = false;
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000187 GoogleStyle.Standard = FormatStyle::LS_Auto;
Manuel Klimek13b97d82013-05-13 08:42:42 +0000188 GoogleStyle.IndentWidth = 2;
Manuel Klimekb9eae4c2013-05-13 09:22:11 +0000189 GoogleStyle.UseTab = false;
Manuel Klimeka8eb9142013-05-13 12:51:40 +0000190 GoogleStyle.BreakBeforeBraces = FormatStyle::BS_Attach;
Manuel Klimek836c2862013-06-21 17:25:42 +0000191 GoogleStyle.IndentFunctionDeclarationAfterType = true;
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000192
193 setDefaultPenalties(GoogleStyle);
194 GoogleStyle.PenaltyReturnTypeOnItsOwnLine = 200;
195
Daniel Jasperf7935112012-12-03 18:12:45 +0000196 return GoogleStyle;
197}
198
Daniel Jasper1b750ed2013-01-14 16:24:39 +0000199FormatStyle getChromiumStyle() {
200 FormatStyle ChromiumStyle = getGoogleStyle();
Daniel Jasperf7db4332013-01-29 16:03:49 +0000201 ChromiumStyle.AllowAllParametersOfDeclarationOnNextLine = false;
Daniel Jasper085a2ed2013-04-24 13:46:00 +0000202 ChromiumStyle.AllowShortIfStatementsOnASingleLine = false;
Daniel Jasper3a685df2013-05-16 12:12:21 +0000203 ChromiumStyle.AllowShortLoopsOnASingleLine = false;
Daniel Jasper2cf17bf2013-02-27 09:47:53 +0000204 ChromiumStyle.BinPackParameters = false;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +0000205 ChromiumStyle.Standard = FormatStyle::LS_Cpp03;
206 ChromiumStyle.DerivePointerBinding = false;
Daniel Jasper1b750ed2013-01-14 16:24:39 +0000207 return ChromiumStyle;
208}
209
Alexander Kornienkoc8602662013-05-06 14:11:27 +0000210FormatStyle getMozillaStyle() {
211 FormatStyle MozillaStyle = getLLVMStyle();
212 MozillaStyle.AllowAllParametersOfDeclarationOnNextLine = false;
213 MozillaStyle.ConstructorInitializerAllOnOneLineOrOnePerLine = true;
214 MozillaStyle.DerivePointerBinding = true;
215 MozillaStyle.IndentCaseLabels = true;
216 MozillaStyle.ObjCSpaceBeforeProtocolList = false;
217 MozillaStyle.PenaltyReturnTypeOnItsOwnLine = 200;
218 MozillaStyle.PointerBindsToType = true;
219 return MozillaStyle;
220}
221
Alexander Kornienko006b5c82013-05-19 00:53:30 +0000222bool getPredefinedStyle(StringRef Name, FormatStyle *Style) {
Alexander Kornienkod6538332013-05-07 15:32:14 +0000223 if (Name.equals_lower("llvm"))
Alexander Kornienko006b5c82013-05-19 00:53:30 +0000224 *Style = getLLVMStyle();
225 else if (Name.equals_lower("chromium"))
226 *Style = getChromiumStyle();
227 else if (Name.equals_lower("mozilla"))
228 *Style = getMozillaStyle();
229 else if (Name.equals_lower("google"))
230 *Style = getGoogleStyle();
231 else
232 return false;
Alexander Kornienkod6538332013-05-07 15:32:14 +0000233
Alexander Kornienko006b5c82013-05-19 00:53:30 +0000234 return true;
Alexander Kornienkod6538332013-05-07 15:32:14 +0000235}
236
237llvm::error_code parseConfiguration(StringRef Text, FormatStyle *Style) {
Alexander Kornienko06e00332013-05-20 15:18:01 +0000238 if (Text.trim().empty())
239 return llvm::make_error_code(llvm::errc::invalid_argument);
Alexander Kornienkod6538332013-05-07 15:32:14 +0000240 llvm::yaml::Input Input(Text);
241 Input >> *Style;
242 return Input.error();
243}
244
245std::string configurationAsText(const FormatStyle &Style) {
246 std::string Text;
247 llvm::raw_string_ostream Stream(Text);
248 llvm::yaml::Output Output(Stream);
249 // We use the same mapping method for input and output, so we need a non-const
250 // reference here.
251 FormatStyle NonConstStyle = Style;
252 Output << NonConstStyle;
Alexander Kornienko9a38ec22013-05-13 12:56:35 +0000253 return Stream.str();
Alexander Kornienkod6538332013-05-07 15:32:14 +0000254}
255
Daniel Jasperacc33662013-02-08 08:22:00 +0000256// Returns the length of everything up to the first possible line break after
257// the ), ], } or > matching \c Tok.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000258static unsigned getLengthToMatchingParen(const FormatToken &Tok) {
Daniel Jasperacc33662013-02-08 08:22:00 +0000259 if (Tok.MatchingParen == NULL)
260 return 0;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000261 FormatToken *End = Tok.MatchingParen;
262 while (End->Next && !End->Next->CanBreakBefore) {
263 End = End->Next;
Daniel Jasperacc33662013-02-08 08:22:00 +0000264 }
265 return End->TotalLength - Tok.TotalLength + 1;
266}
267
Craig Topperaf35e852013-06-30 22:29:28 +0000268namespace {
269
Daniel Jasperf7935112012-12-03 18:12:45 +0000270class UnwrappedLineFormatter {
271public:
Manuel Klimekb2c6dbe2013-01-10 19:17:33 +0000272 UnwrappedLineFormatter(const FormatStyle &Style, SourceManager &SourceMgr,
Daniel Jasperf1e4b7d2013-01-14 13:08:07 +0000273 const AnnotatedLine &Line, unsigned FirstIndent,
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000274 const FormatToken *RootToken,
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000275 WhitespaceManager &Whitespaces,
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000276 encoding::Encoding Encoding,
277 bool BinPackInconclusiveFunctions)
Daniel Jasper2af6bbe2012-12-18 21:05:13 +0000278 : Style(Style), SourceMgr(SourceMgr), Line(Line),
Daniel Jasperaa701fa2013-01-18 08:44:07 +0000279 FirstIndent(FirstIndent), RootToken(RootToken),
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000280 Whitespaces(Whitespaces), Count(0), Encoding(Encoding),
281 BinPackInconclusiveFunctions(BinPackInconclusiveFunctions) {}
Daniel Jasperf7935112012-12-03 18:12:45 +0000282
Manuel Klimek1abf7892013-01-04 23:34:14 +0000283 /// \brief Formats an \c UnwrappedLine.
Manuel Klimek4fe43002013-05-22 12:51:29 +0000284 void format(const AnnotatedLine *NextLine) {
Daniel Jaspere9de2602012-12-06 09:56:08 +0000285 // Initialize state dependent on indent.
Daniel Jasper337816e2013-01-11 10:22:12 +0000286 LineState State;
Manuel Klimek0b689fd2013-01-10 18:45:26 +0000287 State.Column = FirstIndent;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000288 State.NextToken = RootToken;
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +0000289 State.Stack.push_back(ParenState(FirstIndent, FirstIndent,
290 /*AvoidBinPacking=*/false,
291 /*NoLineBreak=*/false));
Daniel Jasperfbde69e2012-12-21 14:37:20 +0000292 State.LineContainsContinuedForLoopSection = false;
Daniel Jasper400adc62013-02-08 15:28:42 +0000293 State.ParenLevel = 0;
Manuel Klimek02f640a2013-02-20 15:25:48 +0000294 State.StartOfStringLiteral = 0;
Daniel Jasper40c36c52013-02-18 11:05:07 +0000295 State.StartOfLineLevel = State.ParenLevel;
Daniel Jasper0e90c3d2013-07-05 09:14:35 +0000296 State.LowestLevelOnLine = State.ParenLevel;
Daniel Jasperf8114cf2013-05-22 05:27:42 +0000297 State.IgnoreStackForComparison = false;
Daniel Jaspere9de2602012-12-06 09:56:08 +0000298
299 // The first token has already been indented and thus consumed.
Nico Weber9096fc02013-06-26 00:30:14 +0000300 moveStateToNextToken(State, /*DryRun=*/false);
Daniel Jasperf7935112012-12-03 18:12:45 +0000301
Daniel Jasper4b866272013-02-01 11:00:45 +0000302 // If everything fits on a single line, just put it there.
Daniel Jasperc22f5b42013-02-28 11:05:57 +0000303 unsigned ColumnLimit = Style.ColumnLimit;
304 if (NextLine && NextLine->InPPDirective &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000305 !NextLine->First->HasUnescapedNewline)
Daniel Jasperc22f5b42013-02-28 11:05:57 +0000306 ColumnLimit = getColumnLimit();
307 if (Line.Last->TotalLength <= ColumnLimit - FirstIndent) {
Daniel Jasper4b866272013-02-01 11:00:45 +0000308 while (State.NextToken != NULL) {
Daniel Jasper2af6bbe2012-12-18 21:05:13 +0000309 addTokenToState(false, false, State);
Daniel Jasper2af6bbe2012-12-18 21:05:13 +0000310 }
Daniel Jasperf7935112012-12-03 18:12:45 +0000311 }
Daniel Jasper4b866272013-02-01 11:00:45 +0000312
Daniel Jasperacc33662013-02-08 08:22:00 +0000313 // If the ObjC method declaration does not fit on a line, we should format
314 // it with one arg per line.
315 if (Line.Type == LT_ObjCMethodDecl)
316 State.Stack.back().BreakBeforeParameter = true;
317
Daniel Jasper4b866272013-02-01 11:00:45 +0000318 // Find best solution in solution space.
Manuel Klimek4fe43002013-05-22 12:51:29 +0000319 analyzeSolutionSpace(State);
Daniel Jasperf7935112012-12-03 18:12:45 +0000320 }
321
322private:
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000323 void DebugTokenState(const FormatToken &FormatTok) {
324 const Token &Tok = FormatTok.Tok;
Alexander Kornienko49149672013-05-10 11:56:10 +0000325 llvm::dbgs() << StringRef(SourceMgr.getCharacterData(Tok.getLocation()),
Daniel Jasperbbc84152013-01-29 11:27:30 +0000326 Tok.getLength());
Alexander Kornienko49149672013-05-10 11:56:10 +0000327 llvm::dbgs();
Manuel Klimek24998102013-01-16 14:55:28 +0000328 }
329
Daniel Jasper337816e2013-01-11 10:22:12 +0000330 struct ParenState {
Daniel Jasperb9ebd5d2013-02-05 09:41:21 +0000331 ParenState(unsigned Indent, unsigned LastSpace, bool AvoidBinPacking,
Daniel Jaspercc960fa2013-04-22 07:59:53 +0000332 bool NoLineBreak)
Daniel Jasper400adc62013-02-08 15:28:42 +0000333 : Indent(Indent), LastSpace(LastSpace), FirstLessLess(0),
334 BreakBeforeClosingBrace(false), QuestionColumn(0),
Daniel Jasperacc33662013-02-08 08:22:00 +0000335 AvoidBinPacking(AvoidBinPacking), BreakBeforeParameter(false),
Daniel Jaspercc960fa2013-04-22 07:59:53 +0000336 NoLineBreak(NoLineBreak), ColonPos(0), StartOfFunctionCall(0),
337 NestedNameSpecifierContinuation(0), CallContinuation(0),
Daniel Jasperee7539a2013-07-08 14:25:23 +0000338 VariablePos(0), ContainsLineBreak(false) {}
Daniel Jasper6d822722012-12-24 16:43:00 +0000339
Daniel Jasperf7935112012-12-03 18:12:45 +0000340 /// \brief The position to which a specific parenthesis level needs to be
341 /// indented.
Daniel Jasper337816e2013-01-11 10:22:12 +0000342 unsigned Indent;
Daniel Jasperf7935112012-12-03 18:12:45 +0000343
Daniel Jaspere9de2602012-12-06 09:56:08 +0000344 /// \brief The position of the last space on each level.
345 ///
346 /// Used e.g. to break like:
347 /// functionCall(Parameter, otherCall(
348 /// OtherParameter));
Daniel Jasper337816e2013-01-11 10:22:12 +0000349 unsigned LastSpace;
Daniel Jasperf7935112012-12-03 18:12:45 +0000350
Daniel Jaspere9de2602012-12-06 09:56:08 +0000351 /// \brief The position the first "<<" operator encountered on each level.
352 ///
353 /// Used to align "<<" operators. 0 if no such operator has been encountered
354 /// on a level.
Daniel Jasper337816e2013-01-11 10:22:12 +0000355 unsigned FirstLessLess;
Daniel Jaspere9de2602012-12-06 09:56:08 +0000356
Manuel Klimek0ddd57a2013-01-10 15:58:26 +0000357 /// \brief Whether a newline needs to be inserted before the block's closing
358 /// brace.
359 ///
360 /// We only want to insert a newline before the closing brace if there also
361 /// was a newline after the beginning left brace.
Daniel Jasper337816e2013-01-11 10:22:12 +0000362 bool BreakBeforeClosingBrace;
363
Daniel Jasperca6623b2013-01-28 12:45:14 +0000364 /// \brief The column of a \c ? in a conditional expression;
365 unsigned QuestionColumn;
366
Daniel Jasper8a8ce242013-01-31 14:59:26 +0000367 /// \brief Avoid bin packing, i.e. multiple parameters/elements on multiple
368 /// lines, in this context.
369 bool AvoidBinPacking;
370
371 /// \brief Break after the next comma (or all the commas in this context if
372 /// \c AvoidBinPacking is \c true).
Daniel Jasperacc33662013-02-08 08:22:00 +0000373 bool BreakBeforeParameter;
Daniel Jasper8a8ce242013-01-31 14:59:26 +0000374
Daniel Jaspercc960fa2013-04-22 07:59:53 +0000375 /// \brief Line breaking in this context would break a formatting rule.
376 bool NoLineBreak;
Daniel Jasper2408a8c2013-01-11 11:37:55 +0000377
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000378 /// \brief The position of the colon in an ObjC method declaration/call.
379 unsigned ColonPos;
Daniel Jasperdc7d5812013-02-20 12:56:39 +0000380
Daniel Jasperf9a84b52013-03-01 16:48:32 +0000381 /// \brief The start of the most recent function in a builder-type call.
382 unsigned StartOfFunctionCall;
383
Daniel Jasperc238c872013-04-02 14:33:13 +0000384 /// \brief If a nested name specifier was broken over multiple lines, this
385 /// contains the start column of the second line. Otherwise 0.
386 unsigned NestedNameSpecifierContinuation;
387
388 /// \brief If a call expression was broken over multiple lines, this
389 /// contains the start column of the second line. Otherwise 0.
390 unsigned CallContinuation;
391
Daniel Jaspera628c982013-04-03 13:36:17 +0000392 /// \brief The column of the first variable name in a variable declaration.
393 ///
394 /// Used to align further variables if necessary.
395 unsigned VariablePos;
396
Daniel Jasperee7539a2013-07-08 14:25:23 +0000397 /// \brief \c true if this \c ParenState already contains a line-break.
Daniel Jaspercc3044c2013-05-13 09:19:24 +0000398 ///
Daniel Jasperee7539a2013-07-08 14:25:23 +0000399 /// The first line break in a certain \c ParenState causes extra penalty so
400 /// that clang-format prefers similar breaks, i.e. breaks in the same
401 /// parenthesis.
402 bool ContainsLineBreak;
Daniel Jaspercc3044c2013-05-13 09:19:24 +0000403
Daniel Jasper337816e2013-01-11 10:22:12 +0000404 bool operator<(const ParenState &Other) const {
405 if (Indent != Other.Indent)
Daniel Jasperfd8c4b12013-01-11 14:23:32 +0000406 return Indent < Other.Indent;
Daniel Jasper337816e2013-01-11 10:22:12 +0000407 if (LastSpace != Other.LastSpace)
408 return LastSpace < Other.LastSpace;
409 if (FirstLessLess != Other.FirstLessLess)
410 return FirstLessLess < Other.FirstLessLess;
Daniel Jasper2408a8c2013-01-11 11:37:55 +0000411 if (BreakBeforeClosingBrace != Other.BreakBeforeClosingBrace)
412 return BreakBeforeClosingBrace;
Daniel Jasperca6623b2013-01-28 12:45:14 +0000413 if (QuestionColumn != Other.QuestionColumn)
414 return QuestionColumn < Other.QuestionColumn;
Daniel Jasper8a8ce242013-01-31 14:59:26 +0000415 if (AvoidBinPacking != Other.AvoidBinPacking)
416 return AvoidBinPacking;
Daniel Jasperacc33662013-02-08 08:22:00 +0000417 if (BreakBeforeParameter != Other.BreakBeforeParameter)
418 return BreakBeforeParameter;
Daniel Jaspercc960fa2013-04-22 07:59:53 +0000419 if (NoLineBreak != Other.NoLineBreak)
420 return NoLineBreak;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000421 if (ColonPos != Other.ColonPos)
422 return ColonPos < Other.ColonPos;
Daniel Jasperf9a84b52013-03-01 16:48:32 +0000423 if (StartOfFunctionCall != Other.StartOfFunctionCall)
424 return StartOfFunctionCall < Other.StartOfFunctionCall;
Daniel Jasperc238c872013-04-02 14:33:13 +0000425 if (CallContinuation != Other.CallContinuation)
426 return CallContinuation < Other.CallContinuation;
Daniel Jaspera628c982013-04-03 13:36:17 +0000427 if (VariablePos != Other.VariablePos)
428 return VariablePos < Other.VariablePos;
Daniel Jasperee7539a2013-07-08 14:25:23 +0000429 if (ContainsLineBreak != Other.ContainsLineBreak)
430 return ContainsLineBreak < Other.ContainsLineBreak;
Daniel Jasper7b7877a2013-01-12 07:36:22 +0000431 return false;
Daniel Jasper337816e2013-01-11 10:22:12 +0000432 }
433 };
434
435 /// \brief The current state when indenting a unwrapped line.
436 ///
437 /// As the indenting tries different combinations this is copied by value.
438 struct LineState {
439 /// \brief The number of used columns in the current line.
440 unsigned Column;
441
442 /// \brief The token that needs to be next formatted.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000443 const FormatToken *NextToken;
Daniel Jasper337816e2013-01-11 10:22:12 +0000444
Daniel Jasperfbde69e2012-12-21 14:37:20 +0000445 /// \brief \c true if this line contains a continued for-loop section.
446 bool LineContainsContinuedForLoopSection;
447
Daniel Jasper400adc62013-02-08 15:28:42 +0000448 /// \brief The level of nesting inside (), [], <> and {}.
449 unsigned ParenLevel;
450
Daniel Jasper40c36c52013-02-18 11:05:07 +0000451 /// \brief The \c ParenLevel at the start of this line.
452 unsigned StartOfLineLevel;
453
Daniel Jasper0e90c3d2013-07-05 09:14:35 +0000454 /// \brief The lowest \c ParenLevel on the current line.
455 unsigned LowestLevelOnLine;
Daniel Jasper32a796b2013-05-27 11:50:16 +0000456
Manuel Klimek02f640a2013-02-20 15:25:48 +0000457 /// \brief The start column of the string literal, if we're in a string
458 /// literal sequence, 0 otherwise.
459 unsigned StartOfStringLiteral;
460
Daniel Jasper337816e2013-01-11 10:22:12 +0000461 /// \brief A stack keeping track of properties applying to parenthesis
462 /// levels.
463 std::vector<ParenState> Stack;
464
Daniel Jasperf8114cf2013-05-22 05:27:42 +0000465 /// \brief Ignore the stack of \c ParenStates for state comparison.
466 ///
467 /// In long and deeply nested unwrapped lines, the current algorithm can
468 /// be insufficient for finding the best formatting with a reasonable amount
469 /// of time and memory. Setting this flag will effectively lead to the
470 /// algorithm not analyzing some combinations. However, these combinations
471 /// rarely contain the optimal solution: In short, accepting a higher
472 /// penalty early would need to lead to different values in the \c
473 /// ParenState stack (in an otherwise identical state) and these different
474 /// values would need to lead to a significant amount of avoided penalty
475 /// later.
476 ///
477 /// FIXME: Come up with a better algorithm instead.
478 bool IgnoreStackForComparison;
479
Daniel Jasper337816e2013-01-11 10:22:12 +0000480 /// \brief Comparison operator to be able to used \c LineState in \c map.
481 bool operator<(const LineState &Other) const {
Daniel Jasper58f427e2013-02-19 09:28:55 +0000482 if (NextToken != Other.NextToken)
483 return NextToken < Other.NextToken;
484 if (Column != Other.Column)
485 return Column < Other.Column;
Daniel Jasper58f427e2013-02-19 09:28:55 +0000486 if (LineContainsContinuedForLoopSection !=
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000487 Other.LineContainsContinuedForLoopSection)
Daniel Jasperfbde69e2012-12-21 14:37:20 +0000488 return LineContainsContinuedForLoopSection;
Daniel Jasper58f427e2013-02-19 09:28:55 +0000489 if (ParenLevel != Other.ParenLevel)
490 return ParenLevel < Other.ParenLevel;
491 if (StartOfLineLevel != Other.StartOfLineLevel)
492 return StartOfLineLevel < Other.StartOfLineLevel;
Daniel Jasper0e90c3d2013-07-05 09:14:35 +0000493 if (LowestLevelOnLine != Other.LowestLevelOnLine)
494 return LowestLevelOnLine < Other.LowestLevelOnLine;
Manuel Klimek02f640a2013-02-20 15:25:48 +0000495 if (StartOfStringLiteral != Other.StartOfStringLiteral)
496 return StartOfStringLiteral < Other.StartOfStringLiteral;
Daniel Jasperf8114cf2013-05-22 05:27:42 +0000497 if (IgnoreStackForComparison || Other.IgnoreStackForComparison)
498 return false;
Daniel Jasper58f427e2013-02-19 09:28:55 +0000499 return Stack < Other.Stack;
Daniel Jasperf7935112012-12-03 18:12:45 +0000500 }
501 };
502
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000503 /// \brief Appends the next token to \p State and updates information
504 /// necessary for indentation.
505 ///
Nico Weberf579ab32013-06-26 02:42:46 +0000506 /// Puts the token on the current line if \p Newline is \c false and adds a
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000507 /// line break and necessary indentation otherwise.
508 ///
509 /// If \p DryRun is \c false, also creates and stores the required
510 /// \c Replacement.
Manuel Klimek1998ea22013-02-20 10:15:13 +0000511 unsigned addTokenToState(bool Newline, bool DryRun, LineState &State) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000512 const FormatToken &Current = *State.NextToken;
513 const FormatToken &Previous = *State.NextToken->Previous;
Daniel Jasperf7935112012-12-03 18:12:45 +0000514
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000515 // Extra penalty that needs to be added because of the way certain line
516 // breaks are chosen.
517 unsigned ExtraPenalty = 0;
518
Daniel Jasper291f9362013-03-20 15:58:10 +0000519 if (State.Stack.size() == 0 || Current.Type == TT_ImplicitStringLiteral) {
Manuel Klimek5c24cca2013-05-23 10:56:37 +0000520 // FIXME: Is this correct?
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000521 int WhitespaceLength = SourceMgr.getSpellingColumnNumber(
522 State.NextToken->WhitespaceRange.getEnd()) -
523 SourceMgr.getSpellingColumnNumber(
524 State.NextToken->WhitespaceRange.getBegin());
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000525 State.Column += WhitespaceLength + State.NextToken->CodePointCount;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000526 State.NextToken = State.NextToken->Next;
Manuel Klimek1998ea22013-02-20 10:15:13 +0000527 return 0;
Daniel Jasper4b866272013-02-01 11:00:45 +0000528 }
529
Daniel Jasper5188e6b2013-04-03 07:21:51 +0000530 // If we are continuing an expression, we want to indent an extra 4 spaces.
531 unsigned ContinuationIndent =
Daniel Jasperc238c872013-04-02 14:33:13 +0000532 std::max(State.Stack.back().LastSpace, State.Stack.back().Indent) + 4;
Daniel Jasperf7935112012-12-03 18:12:45 +0000533 if (Newline) {
Daniel Jasperee7539a2013-07-08 14:25:23 +0000534 State.Stack.back().ContainsLineBreak = true;
Manuel Klimek8e07a1b2013-01-10 11:52:21 +0000535 if (Current.is(tok::r_brace)) {
Daniel Jasperb1f74a82013-07-09 09:06:29 +0000536 if (Current.BlockKind == BK_BracedInit)
537 State.Column = State.Stack[State.Stack.size() - 2].LastSpace;
538 else
539 State.Column = Line.Level * Style.IndentWidth;
Daniel Jasper399d24b2013-01-09 07:06:56 +0000540 } else if (Current.is(tok::string_literal) &&
Manuel Klimek02f640a2013-02-20 15:25:48 +0000541 State.StartOfStringLiteral != 0) {
542 State.Column = State.StartOfStringLiteral;
Daniel Jasper2ec3ffb82013-02-18 11:59:17 +0000543 State.Stack.back().BreakBeforeParameter = true;
Daniel Jasper399d24b2013-01-09 07:06:56 +0000544 } else if (Current.is(tok::lessless) &&
Daniel Jasper400adc62013-02-08 15:28:42 +0000545 State.Stack.back().FirstLessLess != 0) {
546 State.Column = State.Stack.back().FirstLessLess;
Daniel Jasperbca4bbe2013-05-28 11:30:49 +0000547 } else if (Current.isOneOf(tok::period, tok::arrow) &&
548 Current.Type != TT_DesignatedInitializerPeriod) {
Daniel Jasper5188e6b2013-04-03 07:21:51 +0000549 if (State.Stack.back().CallContinuation == 0) {
550 State.Column = ContinuationIndent;
Daniel Jasperc238c872013-04-02 14:33:13 +0000551 State.Stack.back().CallContinuation = State.Column;
Daniel Jasper5188e6b2013-04-03 07:21:51 +0000552 } else {
553 State.Column = State.Stack.back().CallContinuation;
554 }
Daniel Jasperca6623b2013-01-28 12:45:14 +0000555 } else if (Current.Type == TT_ConditionalExpr) {
556 State.Column = State.Stack.back().QuestionColumn;
Daniel Jaspera628c982013-04-03 13:36:17 +0000557 } else if (Previous.is(tok::comma) &&
558 State.Stack.back().VariablePos != 0) {
559 State.Column = State.Stack.back().VariablePos;
Daniel Jasper26d1b1d2013-02-24 18:54:32 +0000560 } else if (Previous.ClosesTemplateDeclaration ||
Daniel Jasper6331da02013-07-09 07:43:55 +0000561 ((Current.Type == TT_StartOfName ||
562 Current.is(tok::kw_operator)) &&
563 State.ParenLevel == 0 &&
Manuel Klimek836c2862013-06-21 17:25:42 +0000564 (!Style.IndentFunctionDeclarationAfterType ||
565 Line.StartsDefinition))) {
Daniel Jasperc238c872013-04-02 14:33:13 +0000566 State.Column = State.Stack.back().Indent;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000567 } else if (Current.Type == TT_ObjCSelectorName) {
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000568 if (State.Stack.back().ColonPos > Current.CodePointCount) {
569 State.Column = State.Stack.back().ColonPos - Current.CodePointCount;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000570 } else {
571 State.Column = State.Stack.back().Indent;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000572 State.Stack.back().ColonPos = State.Column + Current.CodePointCount;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000573 }
Daniel Jasper0f0234e2013-05-08 10:00:18 +0000574 } else if (Current.Type == TT_StartOfName ||
575 Previous.isOneOf(tok::coloncolon, tok::equal) ||
Daniel Jasperc238c872013-04-02 14:33:13 +0000576 Previous.Type == TT_ObjCMethodExpr) {
Daniel Jasper5188e6b2013-04-03 07:21:51 +0000577 State.Column = ContinuationIndent;
Daniel Jasperfbde69e2012-12-21 14:37:20 +0000578 } else {
Daniel Jasper400adc62013-02-08 15:28:42 +0000579 State.Column = State.Stack.back().Indent;
Daniel Jasper5188e6b2013-04-03 07:21:51 +0000580 // Ensure that we fall back to indenting 4 spaces instead of just
581 // flushing continuations left.
Daniel Jasperc238c872013-04-02 14:33:13 +0000582 if (State.Column == FirstIndent)
583 State.Column += 4;
Daniel Jasperfbde69e2012-12-21 14:37:20 +0000584 }
585
Daniel Jasper54a86022013-02-15 11:07:25 +0000586 if (Current.is(tok::question))
Daniel Jaspercd8599e2013-02-23 21:01:55 +0000587 State.Stack.back().BreakBeforeParameter = true;
Daniel Jasperd69fc772013-05-08 14:12:04 +0000588 if ((Previous.isOneOf(tok::comma, tok::semi) &&
589 !State.Stack.back().AvoidBinPacking) ||
590 Previous.Type == TT_BinaryOperator)
Daniel Jasperacc33662013-02-08 08:22:00 +0000591 State.Stack.back().BreakBeforeParameter = false;
Daniel Jasperc6fbc212013-05-15 09:35:08 +0000592 if (Previous.Type == TT_TemplateCloser && State.ParenLevel == 0)
593 State.Stack.back().BreakBeforeParameter = false;
Daniel Jasper8a8ce242013-01-31 14:59:26 +0000594
Manuel Klimekb69e3c62013-01-02 18:33:23 +0000595 if (!DryRun) {
Daniel Jasperfb5e2412013-02-26 13:10:34 +0000596 unsigned NewLines = 1;
Alexander Kornienkof370ad92013-06-12 19:04:12 +0000597 if (Current.is(tok::comment))
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000598 NewLines = std::max(
599 NewLines,
600 std::min(Current.NewlinesBefore, Style.MaxEmptyLinesToKeep + 1));
Manuel Klimek4fe43002013-05-22 12:51:29 +0000601 Whitespaces.replaceWhitespace(Current, NewLines, State.Column,
602 State.Column, Line.InPPDirective);
Manuel Klimekb69e3c62013-01-02 18:33:23 +0000603 }
Daniel Jasperf7935112012-12-03 18:12:45 +0000604
Daniel Jasper185de242013-07-11 13:48:16 +0000605 if (!Current.isTrailingComment())
606 State.Stack.back().LastSpace = State.Column;
Daniel Jasperbca4bbe2013-05-28 11:30:49 +0000607 if (Current.isOneOf(tok::arrow, tok::period) &&
608 Current.Type != TT_DesignatedInitializerPeriod)
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000609 State.Stack.back().LastSpace += Current.CodePointCount;
Daniel Jasper40c36c52013-02-18 11:05:07 +0000610 State.StartOfLineLevel = State.ParenLevel;
Daniel Jasper0e90c3d2013-07-05 09:14:35 +0000611 State.LowestLevelOnLine = State.ParenLevel;
Daniel Jaspercd8599e2013-02-23 21:01:55 +0000612
613 // Any break on this level means that the parent level has been broken
614 // and we need to avoid bin packing there.
615 for (unsigned i = 0, e = State.Stack.size() - 1; i != e; ++i) {
616 State.Stack[i].BreakBeforeParameter = true;
617 }
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000618 const FormatToken *TokenBefore = Current.getPreviousNonComment();
Daniel Jasper1b8e76f2013-04-15 22:36:37 +0000619 if (TokenBefore && !TokenBefore->isOneOf(tok::comma, tok::semi) &&
Daniel Jasperc6fbc212013-05-15 09:35:08 +0000620 TokenBefore->Type != TT_TemplateCloser &&
Daniel Jasperd69fc772013-05-08 14:12:04 +0000621 TokenBefore->Type != TT_BinaryOperator && !TokenBefore->opensScope())
Daniel Jasper2cf17bf2013-02-27 09:47:53 +0000622 State.Stack.back().BreakBeforeParameter = true;
623
Daniel Jaspercd8599e2013-02-23 21:01:55 +0000624 // If we break after {, we should also break before the corresponding }.
625 if (Previous.is(tok::l_brace))
626 State.Stack.back().BreakBeforeClosingBrace = true;
627
628 if (State.Stack.back().AvoidBinPacking) {
629 // If we are breaking after '(', '{', '<', this is not bin packing
630 // unless AllowAllParametersOfDeclarationOnNextLine is false.
Daniel Jasper571f1af2013-05-14 20:39:56 +0000631 if (!(Previous.isOneOf(tok::l_paren, tok::l_brace) ||
632 Previous.Type == TT_BinaryOperator) ||
Daniel Jaspercd8599e2013-02-23 21:01:55 +0000633 (!Style.AllowAllParametersOfDeclarationOnNextLine &&
634 Line.MustBeDeclaration))
635 State.Stack.back().BreakBeforeParameter = true;
636 }
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000637
638 // Breaking before the first "<<" is generally not desirable.
639 if (Current.is(tok::lessless) && State.Stack.back().FirstLessLess == 0)
640 ExtraPenalty += Style.PenaltyBreakFirstLessLess;
641
Daniel Jasperf7935112012-12-03 18:12:45 +0000642 } else {
Daniel Jasper62e68172013-02-25 15:59:54 +0000643 if (Current.is(tok::equal) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000644 (RootToken->is(tok::kw_for) || State.ParenLevel == 0) &&
Daniel Jasper31c96b92013-04-05 09:38:50 +0000645 State.Stack.back().VariablePos == 0) {
646 State.Stack.back().VariablePos = State.Column;
647 // Move over * and & if they are bound to the variable name.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000648 const FormatToken *Tok = &Previous;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000649 while (Tok && State.Stack.back().VariablePos >= Tok->CodePointCount) {
650 State.Stack.back().VariablePos -= Tok->CodePointCount;
Daniel Jasper31c96b92013-04-05 09:38:50 +0000651 if (Tok->SpacesRequiredBefore != 0)
652 break;
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000653 Tok = Tok->Previous;
Daniel Jasper31c96b92013-04-05 09:38:50 +0000654 }
Daniel Jaspera628c982013-04-03 13:36:17 +0000655 if (Previous.PartOfMultiVariableDeclStmt)
656 State.Stack.back().LastSpace = State.Stack.back().VariablePos;
657 }
Daniel Jasperfbde69e2012-12-21 14:37:20 +0000658
Daniel Jaspereef30492013-02-11 12:36:37 +0000659 unsigned Spaces = State.NextToken->SpacesRequiredBefore;
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000660
Daniel Jasperf7935112012-12-03 18:12:45 +0000661 if (!DryRun)
Manuel Klimek4fe43002013-05-22 12:51:29 +0000662 Whitespaces.replaceWhitespace(Current, 0, Spaces,
663 State.Column + Spaces);
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000664
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000665 if (Current.Type == TT_ObjCSelectorName &&
666 State.Stack.back().ColonPos == 0) {
667 if (State.Stack.back().Indent + Current.LongestObjCSelectorName >
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000668 State.Column + Spaces + Current.CodePointCount)
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000669 State.Stack.back().ColonPos =
670 State.Stack.back().Indent + Current.LongestObjCSelectorName;
671 else
672 State.Stack.back().ColonPos =
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000673 State.Column + Spaces + Current.CodePointCount;
Daniel Jasper1ac3e052013-02-05 10:07:47 +0000674 }
675
Daniel Jasperc04baae2013-04-10 09:49:49 +0000676 if (Previous.opensScope() && Previous.Type != TT_ObjCMethodExpr &&
Daniel Jasper6bee6822013-04-08 20:33:42 +0000677 Current.Type != TT_LineComment)
Daniel Jasper400adc62013-02-08 15:28:42 +0000678 State.Stack.back().Indent = State.Column + Spaces;
Daniel Jaspercc960fa2013-04-22 07:59:53 +0000679 if (Previous.is(tok::comma) && !Current.isTrailingComment() &&
680 State.Stack.back().AvoidBinPacking)
681 State.Stack.back().NoLineBreak = true;
Daniel Jasper9278eb92013-01-16 14:59:02 +0000682
Daniel Jaspere9de2602012-12-06 09:56:08 +0000683 State.Column += Spaces;
Daniel Jaspera628c982013-04-03 13:36:17 +0000684 if (Current.is(tok::l_paren) && Previous.isOneOf(tok::kw_if, tok::kw_for))
Daniel Jasper39e27382013-01-23 20:41:06 +0000685 // Treat the condition inside an if as if it was a second function
686 // parameter, i.e. let nested calls have an indent of 4.
687 State.Stack.back().LastSpace = State.Column + 1; // 1 is length of "(".
Daniel Jasperd1ae3582013-03-20 12:37:50 +0000688 else if (Previous.is(tok::comma))
Daniel Jasper39e27382013-01-23 20:41:06 +0000689 State.Stack.back().LastSpace = State.Column;
Daniel Jasperca6623b2013-01-28 12:45:14 +0000690 else if ((Previous.Type == TT_BinaryOperator ||
Daniel Jasper65585ed2013-01-28 13:31:35 +0000691 Previous.Type == TT_ConditionalExpr ||
692 Previous.Type == TT_CtorInitializerColon) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000693 !(Previous.getPrecedence() == prec::Assignment &&
Daniel Jasper7b27a102013-05-27 12:45:09 +0000694 Current.FakeLParens.empty()))
695 // Always indent relative to the RHS of the expression unless this is a
696 // simple assignment without binary expression on the RHS.
Daniel Jasper20b09ef2013-01-28 09:35:24 +0000697 State.Stack.back().LastSpace = State.Column;
Daniel Jaspereead02b2013-02-14 08:42:54 +0000698 else if (Previous.Type == TT_InheritanceColon)
699 State.Stack.back().Indent = State.Column;
Daniel Jasperbd058882013-07-09 11:57:27 +0000700 else if (Previous.opensScope()) {
701 // If a function has multiple parameters (including a single parameter
Daniel Jasper6cdec7c2013-07-09 14:36:48 +0000702 // that is a binary expression) or a trailing call, indent all
Daniel Jasperbd058882013-07-09 11:57:27 +0000703 // parameters from the opening parenthesis. This avoids confusing
704 // indents like:
705 // OuterFunction(InnerFunctionCall(
706 // ParameterToInnerFunction),
707 // SecondParameterToOuterFunction);
708 bool HasMultipleParameters = !Current.FakeLParens.empty();
709 bool HasTrailingCall = false;
710 if (Previous.MatchingParen) {
711 const FormatToken *Next = Previous.MatchingParen->getNextNonComment();
712 if (Next && Next->isOneOf(tok::period, tok::arrow))
713 HasTrailingCall = true;
714 }
715 if (HasMultipleParameters || HasTrailingCall)
716 State.Stack.back().LastSpace = State.Column;
717 }
Daniel Jasperf7935112012-12-03 18:12:45 +0000718 }
Daniel Jasper9278eb92013-01-16 14:59:02 +0000719
Daniel Jasper4e9678f2013-07-11 20:41:21 +0000720 return moveStateToNextToken(State, DryRun) + ExtraPenalty;
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000721 }
Daniel Jasperf7935112012-12-03 18:12:45 +0000722
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000723 /// \brief Mark the next token as consumed in \p State and modify its stacks
724 /// accordingly.
Manuel Klimek1998ea22013-02-20 10:15:13 +0000725 unsigned moveStateToNextToken(LineState &State, bool DryRun) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000726 const FormatToken &Current = *State.NextToken;
Daniel Jasper337816e2013-01-11 10:22:12 +0000727 assert(State.Stack.size());
Daniel Jaspere9de2602012-12-06 09:56:08 +0000728
Daniel Jaspereead02b2013-02-14 08:42:54 +0000729 if (Current.Type == TT_InheritanceColon)
730 State.Stack.back().AvoidBinPacking = true;
Daniel Jasper337816e2013-01-11 10:22:12 +0000731 if (Current.is(tok::lessless) && State.Stack.back().FirstLessLess == 0)
732 State.Stack.back().FirstLessLess = State.Column;
Daniel Jasperca6623b2013-01-28 12:45:14 +0000733 if (Current.is(tok::question))
734 State.Stack.back().QuestionColumn = State.Column;
Daniel Jasper0e90c3d2013-07-05 09:14:35 +0000735 if (!Current.opensScope() && !Current.closesScope())
736 State.LowestLevelOnLine =
737 std::min(State.LowestLevelOnLine, State.ParenLevel);
738 if (Current.isOneOf(tok::period, tok::arrow) &&
739 Line.Type == LT_BuilderTypeCall && State.ParenLevel == 0)
740 State.Stack.back().StartOfFunctionCall =
741 Current.LastInChainOfCalls ? 0
742 : State.Column + Current.CodePointCount;
Daniel Jasper37905f72013-02-21 15:00:29 +0000743 if (Current.Type == TT_CtorInitializerColon) {
Manuel Klimek13b97d82013-05-13 08:42:42 +0000744 // Indent 2 from the column, so:
745 // SomeClass::SomeClass()
746 // : First(...), ...
747 // Next(...)
748 // ^ line up here.
Daniel Jasper6bee6822013-04-08 20:33:42 +0000749 State.Stack.back().Indent = State.Column + 2;
Daniel Jasper37905f72013-02-21 15:00:29 +0000750 if (Style.ConstructorInitializerAllOnOneLineOrOnePerLine)
751 State.Stack.back().AvoidBinPacking = true;
752 State.Stack.back().BreakBeforeParameter = false;
Daniel Jasper8a8ce242013-01-31 14:59:26 +0000753 }
Daniel Jasper5188e6b2013-04-03 07:21:51 +0000754
Daniel Jasper6bee6822013-04-08 20:33:42 +0000755 // If return returns a binary expression, align after it.
756 if (Current.is(tok::kw_return) && !Current.FakeLParens.empty())
757 State.Stack.back().LastSpace = State.Column + 7;
758
Daniel Jasper5188e6b2013-04-03 07:21:51 +0000759 // In ObjC method declaration we align on the ":" of parameters, but we need
760 // to ensure that we indent parameters on subsequent lines by at least 4.
Daniel Jasperc238c872013-04-02 14:33:13 +0000761 if (Current.Type == TT_ObjCMethodSpecifier)
762 State.Stack.back().Indent += 4;
Daniel Jaspere9de2602012-12-06 09:56:08 +0000763
Daniel Jasper400adc62013-02-08 15:28:42 +0000764 // Insert scopes created by fake parenthesis.
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000765 const FormatToken *Previous = Current.getPreviousNonComment();
Daniel Jasper6bee6822013-04-08 20:33:42 +0000766 // Don't add extra indentation for the first fake parenthesis after
767 // 'return', assignements or opening <({[. The indentation for these cases
768 // is special cased.
769 bool SkipFirstExtraIndent =
770 Current.is(tok::kw_return) ||
Daniel Jasperc04baae2013-04-10 09:49:49 +0000771 (Previous && (Previous->opensScope() ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000772 Previous->getPrecedence() == prec::Assignment));
Craig Topper61ac9062013-07-08 03:55:09 +0000773 for (SmallVectorImpl<prec::Level>::const_reverse_iterator
Daniel Jasper6bee6822013-04-08 20:33:42 +0000774 I = Current.FakeLParens.rbegin(),
775 E = Current.FakeLParens.rend();
776 I != E; ++I) {
Daniel Jasper400adc62013-02-08 15:28:42 +0000777 ParenState NewParenState = State.Stack.back();
Daniel Jasperee7539a2013-07-08 14:25:23 +0000778 NewParenState.ContainsLineBreak = false;
Daniel Jasper6bee6822013-04-08 20:33:42 +0000779 NewParenState.Indent =
780 std::max(std::max(State.Column, NewParenState.Indent),
781 State.Stack.back().LastSpace);
782
783 // Always indent conditional expressions. Never indent expression where
784 // the 'operator' is ',', ';' or an assignment (i.e. *I <=
785 // prec::Assignment) as those have different indentation rules. Indent
786 // other expression, unless the indentation needs to be skipped.
787 if (*I == prec::Conditional ||
788 (!SkipFirstExtraIndent && *I > prec::Assignment))
789 NewParenState.Indent += 4;
Daniel Jasperc04baae2013-04-10 09:49:49 +0000790 if (Previous && !Previous->opensScope())
Daniel Jasper6bee6822013-04-08 20:33:42 +0000791 NewParenState.BreakBeforeParameter = false;
Daniel Jasper400adc62013-02-08 15:28:42 +0000792 State.Stack.push_back(NewParenState);
Daniel Jasper6bee6822013-04-08 20:33:42 +0000793 SkipFirstExtraIndent = false;
Daniel Jasper400adc62013-02-08 15:28:42 +0000794 }
795
Daniel Jasper2eda23e2012-12-24 13:43:52 +0000796 // If we encounter an opening (, [, { or <, we add a level to our stacks to
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000797 // prepare for the following tokens.
Daniel Jasperc04baae2013-04-10 09:49:49 +0000798 if (Current.opensScope()) {
Daniel Jasper337816e2013-01-11 10:22:12 +0000799 unsigned NewIndent;
Daniel Jaspercc3044c2013-05-13 09:19:24 +0000800 unsigned LastSpace = State.Stack.back().LastSpace;
Daniel Jasper8a8ce242013-01-31 14:59:26 +0000801 bool AvoidBinPacking;
Manuel Klimek73a2fdf2013-01-10 14:36:46 +0000802 if (Current.is(tok::l_brace)) {
Daniel Jaspercc3044c2013-05-13 09:19:24 +0000803 NewIndent = Style.IndentWidth + LastSpace;
Alexander Kornienko1efe0a02013-07-04 14:47:51 +0000804 const FormatToken *NextNoComment = Current.getNextNonComment();
Daniel Jasperbca4bbe2013-05-28 11:30:49 +0000805 AvoidBinPacking = NextNoComment &&
806 NextNoComment->Type == TT_DesignatedInitializerPeriod;
Manuel Klimek73a2fdf2013-01-10 14:36:46 +0000807 } else {
Daniel Jaspercc3044c2013-05-13 09:19:24 +0000808 NewIndent =
809 4 + std::max(LastSpace, State.Stack.back().StartOfFunctionCall);
Daniel Jasperb10cbc42013-07-10 14:02:49 +0000810 AvoidBinPacking = !Style.BinPackParameters ||
811 (Style.ExperimentalAutoDetectBinPacking &&
812 (Current.PackingKind == PPK_OnePerLine ||
813 (!BinPackInconclusiveFunctions &&
814 Current.PackingKind == PPK_Inconclusive)));
Manuel Klimek73a2fdf2013-01-10 14:36:46 +0000815 }
Daniel Jaspere3c0e012013-04-25 13:31:51 +0000816
Daniel Jaspercc3044c2013-05-13 09:19:24 +0000817 State.Stack.push_back(ParenState(NewIndent, LastSpace, AvoidBinPacking,
818 State.Stack.back().NoLineBreak));
Daniel Jasper400adc62013-02-08 15:28:42 +0000819 ++State.ParenLevel;
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000820 }
821
Daniel Jasperacc33662013-02-08 08:22:00 +0000822 // If this '[' opens an ObjC call, determine whether all parameters fit into
823 // one line and put one per line if they don't.
824 if (Current.is(tok::l_square) && Current.Type == TT_ObjCMethodExpr &&
825 Current.MatchingParen != NULL) {
826 if (getLengthToMatchingParen(Current) + State.Column > getColumnLimit())
827 State.Stack.back().BreakBeforeParameter = true;
828 }
829
Daniel Jasper2eda23e2012-12-24 13:43:52 +0000830 // If we encounter a closing ), ], } or >, we can remove a level from our
Daniel Jasper6021c4a2012-12-04 14:54:30 +0000831 // stacks.
Alexander Kornienko62b85b92013-03-13 14:41:29 +0000832 if (Current.isOneOf(tok::r_paren, tok::r_square) ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000833 (Current.is(tok::r_brace) && State.NextToken != RootToken) ||
Daniel Jasper7c85fde2013-01-08 14:56:18 +0000834 State.NextToken->Type == TT_TemplateCloser) {
Daniel Jasper337816e2013-01-11 10:22:12 +0000835 State.Stack.pop_back();
Daniel Jasper400adc62013-02-08 15:28:42 +0000836 --State.ParenLevel;
837 }
838
839 // Remove scopes created by fake parenthesis.
840 for (unsigned i = 0, e = Current.FakeRParens; i != e; ++i) {
Daniel Jasper6daabe32013-04-04 19:31:00 +0000841 unsigned VariablePos = State.Stack.back().VariablePos;
Daniel Jasper400adc62013-02-08 15:28:42 +0000842 State.Stack.pop_back();
Daniel Jasper6daabe32013-04-04 19:31:00 +0000843 State.Stack.back().VariablePos = VariablePos;
Daniel Jasperf7935112012-12-03 18:12:45 +0000844 }
Manuel Klimek73a2fdf2013-01-10 14:36:46 +0000845
Daniel Jasper47a04442013-05-13 20:50:15 +0000846 if (Current.is(tok::string_literal) && State.StartOfStringLiteral == 0) {
Manuel Klimek02f640a2013-02-20 15:25:48 +0000847 State.StartOfStringLiteral = State.Column;
Daniel Jasper47a04442013-05-13 20:50:15 +0000848 } else if (!Current.isOneOf(tok::comment, tok::identifier, tok::hash,
849 tok::string_literal)) {
Daniel Jasper7dd22c51b2013-05-16 04:26:02 +0000850 State.StartOfStringLiteral = 0;
Manuel Klimek02f640a2013-02-20 15:25:48 +0000851 }
852
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000853 State.Column += Current.CodePointCount;
Manuel Klimek1998ea22013-02-20 10:15:13 +0000854
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000855 State.NextToken = State.NextToken->Next;
Manuel Klimek73a2fdf2013-01-10 14:36:46 +0000856
Manuel Klimek1998ea22013-02-20 10:15:13 +0000857 return breakProtrudingToken(Current, State, DryRun);
858 }
859
860 /// \brief If the current token sticks out over the end of the line, break
861 /// it if possible.
Manuel Klimek5ecb5fd2013-05-14 09:04:24 +0000862 ///
863 /// \returns An extra penalty if a token was broken, otherwise 0.
864 ///
Alexander Kornienkoaa620e12013-07-01 13:42:42 +0000865 /// The returned penalty will cover the cost of the additional line breaks and
866 /// column limit violation in all lines except for the last one. The penalty
867 /// for the column limit violation in the last line (and in single line
868 /// tokens) is handled in \c addNextStateToQueue.
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000869 unsigned breakProtrudingToken(const FormatToken &Current, LineState &State,
Manuel Klimek4fe43002013-05-22 12:51:29 +0000870 bool DryRun) {
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000871 llvm::OwningPtr<BreakableToken> Token;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000872 unsigned StartColumn = State.Column - Current.CodePointCount;
Manuel Klimek591ab5a2013-05-28 13:42:28 +0000873 unsigned OriginalStartColumn =
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000874 SourceMgr.getSpellingColumnNumber(Current.getStartOfNonWhitespace()) -
Manuel Klimek591ab5a2013-05-28 13:42:28 +0000875 1;
Manuel Klimek9043c742013-05-27 15:23:34 +0000876
Daniel Jasper8bb99e82013-05-16 12:59:13 +0000877 if (Current.is(tok::string_literal) &&
878 Current.Type != TT_ImplicitStringLiteral) {
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000879 // Only break up default narrow strings.
Alexander Kornienkobe633902013-06-14 11:46:10 +0000880 if (!Current.TokenText.startswith("\""))
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000881 return 0;
882
Alexander Kornienkobe633902013-06-14 11:46:10 +0000883 Token.reset(new BreakableStringLiteral(Current, StartColumn,
884 Line.InPPDirective, Encoding));
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000885 } else if (Current.Type == TT_BlockComment) {
Alexander Kornienkobe633902013-06-14 11:46:10 +0000886 Token.reset(new BreakableBlockComment(
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000887 Style, Current, StartColumn, OriginalStartColumn, !Current.Previous,
Alexander Kornienkobe633902013-06-14 11:46:10 +0000888 Line.InPPDirective, Encoding));
Daniel Jasper4a4be012013-05-06 10:24:51 +0000889 } else if (Current.Type == TT_LineComment &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +0000890 (Current.Previous == NULL ||
891 Current.Previous->Type != TT_ImplicitStringLiteral)) {
Alexander Kornienkobe633902013-06-14 11:46:10 +0000892 Token.reset(new BreakableLineComment(Current, StartColumn,
893 Line.InPPDirective, Encoding));
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000894 } else {
Manuel Klimek4fe43002013-05-22 12:51:29 +0000895 return 0;
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000896 }
Alexander Kornienkobe633902013-06-14 11:46:10 +0000897 if (Current.UnbreakableTailLength >= getColumnLimit())
Manuel Klimek5ecb5fd2013-05-14 09:04:24 +0000898 return 0;
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000899
Alexander Kornienkoa3555e22013-06-19 19:50:11 +0000900 unsigned RemainingSpace = getColumnLimit() - Current.UnbreakableTailLength;
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000901 bool BreakInserted = false;
902 unsigned Penalty = 0;
Alexander Kornienkoa3555e22013-06-19 19:50:11 +0000903 unsigned RemainingTokenColumns = 0;
Manuel Klimek9043c742013-05-27 15:23:34 +0000904 for (unsigned LineIndex = 0, EndIndex = Token->getLineCount();
905 LineIndex != EndIndex; ++LineIndex) {
Alexander Kornienkobe633902013-06-14 11:46:10 +0000906 if (!DryRun)
907 Token->replaceWhitespaceBefore(LineIndex, Whitespaces);
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000908 unsigned TailOffset = 0;
Alexander Kornienkoa3555e22013-06-19 19:50:11 +0000909 RemainingTokenColumns = Token->getLineLengthAfterSplit(
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000910 LineIndex, TailOffset, StringRef::npos);
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000911 while (RemainingTokenColumns > RemainingSpace) {
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000912 BreakableToken::Split Split =
Manuel Klimek4fe43002013-05-22 12:51:29 +0000913 Token->getSplit(LineIndex, TailOffset, getColumnLimit());
Alexander Kornienkoaa620e12013-07-01 13:42:42 +0000914 if (Split.first == StringRef::npos) {
915 // The last line's penalty is handled in addNextStateToQueue().
916 if (LineIndex < EndIndex - 1)
917 Penalty += Style.PenaltyExcessCharacter *
918 (RemainingTokenColumns - RemainingSpace);
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000919 break;
Alexander Kornienkoaa620e12013-07-01 13:42:42 +0000920 }
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000921 assert(Split.first != 0);
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000922 unsigned NewRemainingTokenColumns = Token->getLineLengthAfterSplit(
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000923 LineIndex, TailOffset + Split.first + Split.second,
924 StringRef::npos);
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000925 assert(NewRemainingTokenColumns < RemainingTokenColumns);
Alexander Kornienkobe633902013-06-14 11:46:10 +0000926 if (!DryRun)
927 Token->insertBreak(LineIndex, TailOffset, Split, Whitespaces);
Alexander Kornienkodd7ece52013-06-07 16:02:52 +0000928 Penalty += Current.is(tok::string_literal) ? Style.PenaltyBreakString
929 : Style.PenaltyBreakComment;
930 unsigned ColumnsUsed =
931 Token->getLineLengthAfterSplit(LineIndex, TailOffset, Split.first);
932 if (ColumnsUsed > getColumnLimit()) {
933 Penalty +=
934 Style.PenaltyExcessCharacter * (ColumnsUsed - getColumnLimit());
935 }
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000936 TailOffset += Split.first + Split.second;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +0000937 RemainingTokenColumns = NewRemainingTokenColumns;
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000938 BreakInserted = true;
Manuel Klimek1998ea22013-02-20 10:15:13 +0000939 }
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000940 }
941
Alexander Kornienkoa3555e22013-06-19 19:50:11 +0000942 State.Column = RemainingTokenColumns;
943
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000944 if (BreakInserted) {
Alexander Kornienko4d26b6e2013-06-17 12:59:44 +0000945 // If we break the token inside a parameter list, we need to break before
946 // the next parameter on all levels, so that the next parameter is clearly
947 // visible. Line comments already introduce a break.
948 if (Current.Type != TT_LineComment) {
949 for (unsigned i = 0, e = State.Stack.size(); i != e; ++i)
950 State.Stack[i].BreakBeforeParameter = true;
951 }
952
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000953 State.Stack.back().LastSpace = StartColumn;
Manuel Klimek1998ea22013-02-20 10:15:13 +0000954 }
Manuel Klimek1998ea22013-02-20 10:15:13 +0000955 return Penalty;
956 }
957
Daniel Jasper2df93312013-01-09 10:16:05 +0000958 unsigned getColumnLimit() {
Alexander Kornienkocb45bc12013-04-15 14:28:00 +0000959 // In preprocessor directives reserve two chars for trailing " \"
960 return Style.ColumnLimit - (Line.InPPDirective ? 2 : 0);
Daniel Jasper2df93312013-01-09 10:16:05 +0000961 }
962
Manuel Klimek2ef908e2013-02-13 10:46:36 +0000963 /// \brief An edge in the solution space from \c Previous->State to \c State,
964 /// inserting a newline dependent on the \c NewLine.
965 struct StateNode {
966 StateNode(const LineState &State, bool NewLine, StateNode *Previous)
Daniel Jasper12ef4e52013-02-21 21:33:55 +0000967 : State(State), NewLine(NewLine), Previous(Previous) {}
Manuel Klimek2ef908e2013-02-13 10:46:36 +0000968 LineState State;
969 bool NewLine;
970 StateNode *Previous;
971 };
Daniel Jasper4b866272013-02-01 11:00:45 +0000972
Manuel Klimek2ef908e2013-02-13 10:46:36 +0000973 /// \brief A pair of <penalty, count> that is used to prioritize the BFS on.
974 ///
975 /// In case of equal penalties, we want to prefer states that were inserted
976 /// first. During state generation we make sure that we insert states first
977 /// that break the line as late as possible.
978 typedef std::pair<unsigned, unsigned> OrderedPenalty;
979
980 /// \brief An item in the prioritized BFS search queue. The \c StateNode's
981 /// \c State has the given \c OrderedPenalty.
982 typedef std::pair<OrderedPenalty, StateNode *> QueueItem;
983
984 /// \brief The BFS queue type.
985 typedef std::priority_queue<QueueItem, std::vector<QueueItem>,
986 std::greater<QueueItem> > QueueType;
Daniel Jasper4b866272013-02-01 11:00:45 +0000987
988 /// \brief Analyze the entire solution space starting from \p InitialState.
Daniel Jasperf7935112012-12-03 18:12:45 +0000989 ///
Daniel Jasper4b866272013-02-01 11:00:45 +0000990 /// This implements a variant of Dijkstra's algorithm on the graph that spans
991 /// the solution space (\c LineStates are the nodes). The algorithm tries to
992 /// find the shortest path (the one with lowest penalty) from \p InitialState
993 /// to a state where all tokens are placed.
Manuel Klimek4fe43002013-05-22 12:51:29 +0000994 void analyzeSolutionSpace(LineState &InitialState) {
Manuel Klimek2ef908e2013-02-13 10:46:36 +0000995 std::set<LineState> Seen;
996
Daniel Jasper4b866272013-02-01 11:00:45 +0000997 // Insert start element into queue.
Daniel Jasper687af3b2013-02-14 14:26:07 +0000998 StateNode *Node =
Manuel Klimek2ef908e2013-02-13 10:46:36 +0000999 new (Allocator.Allocate()) StateNode(InitialState, false, NULL);
1000 Queue.push(QueueItem(OrderedPenalty(0, Count), Node));
1001 ++Count;
Daniel Jasper4b866272013-02-01 11:00:45 +00001002
1003 // While not empty, take first element and follow edges.
1004 while (!Queue.empty()) {
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001005 unsigned Penalty = Queue.top().first.first;
Daniel Jasper687af3b2013-02-14 14:26:07 +00001006 StateNode *Node = Queue.top().second;
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001007 if (Node->State.NextToken == NULL) {
Alexander Kornienko49149672013-05-10 11:56:10 +00001008 DEBUG(llvm::dbgs() << "\n---\nPenalty for line: " << Penalty << "\n");
Daniel Jasper4b866272013-02-01 11:00:45 +00001009 break;
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001010 }
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001011 Queue.pop();
Daniel Jasper4b866272013-02-01 11:00:45 +00001012
Daniel Jasperf8114cf2013-05-22 05:27:42 +00001013 // Cut off the analysis of certain solutions if the analysis gets too
1014 // complex. See description of IgnoreStackForComparison.
1015 if (Count > 10000)
1016 Node->State.IgnoreStackForComparison = true;
1017
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001018 if (!Seen.insert(Node->State).second)
1019 // State already examined with lower penalty.
1020 continue;
Daniel Jasper4b866272013-02-01 11:00:45 +00001021
Nico Weber9096fc02013-06-26 00:30:14 +00001022 addNextStateToQueue(Penalty, Node, /*NewLine=*/false);
1023 addNextStateToQueue(Penalty, Node, /*NewLine=*/true);
Daniel Jasper4b866272013-02-01 11:00:45 +00001024 }
1025
1026 if (Queue.empty())
1027 // We were unable to find a solution, do nothing.
1028 // FIXME: Add diagnostic?
Manuel Klimek4fe43002013-05-22 12:51:29 +00001029 return;
Daniel Jasperf7935112012-12-03 18:12:45 +00001030
Daniel Jasper4b866272013-02-01 11:00:45 +00001031 // Reconstruct the solution.
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001032 reconstructPath(InitialState, Queue.top().second);
Alexander Kornienko49149672013-05-10 11:56:10 +00001033 DEBUG(llvm::dbgs() << "Total number of analyzed states: " << Count << "\n");
1034 DEBUG(llvm::dbgs() << "---\n");
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001035 }
1036
1037 void reconstructPath(LineState &State, StateNode *Current) {
Manuel Klimek4c5c28b2013-05-29 15:10:11 +00001038 std::deque<StateNode *> Path;
1039 // We do not need a break before the initial token.
1040 while (Current->Previous) {
1041 Path.push_front(Current);
1042 Current = Current->Previous;
1043 }
1044 for (std::deque<StateNode *>::iterator I = Path.begin(), E = Path.end();
1045 I != E; ++I) {
1046 DEBUG({
1047 if ((*I)->NewLine) {
1048 llvm::dbgs() << "Penalty for splitting before "
1049 << (*I)->Previous->State.NextToken->Tok.getName() << ": "
1050 << (*I)->Previous->State.NextToken->SplitPenalty << "\n";
1051 }
1052 });
1053 addTokenToState((*I)->NewLine, false, State);
1054 }
Daniel Jasper4b866272013-02-01 11:00:45 +00001055 }
1056
Manuel Klimekaf491072013-02-13 10:54:19 +00001057 /// \brief Add the following state to the analysis queue \c Queue.
Daniel Jasper4b866272013-02-01 11:00:45 +00001058 ///
Manuel Klimekaf491072013-02-13 10:54:19 +00001059 /// Assume the current state is \p PreviousNode and has been reached with a
Daniel Jasper4b866272013-02-01 11:00:45 +00001060 /// penalty of \p Penalty. Insert a line break if \p NewLine is \c true.
Manuel Klimekaf491072013-02-13 10:54:19 +00001061 void addNextStateToQueue(unsigned Penalty, StateNode *PreviousNode,
1062 bool NewLine) {
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001063 if (NewLine && !canBreak(PreviousNode->State))
Daniel Jasper4b866272013-02-01 11:00:45 +00001064 return;
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001065 if (!NewLine && mustBreak(PreviousNode->State))
Daniel Jasper4b866272013-02-01 11:00:45 +00001066 return;
Daniel Jasperee7539a2013-07-08 14:25:23 +00001067 if (NewLine) {
1068 if (!PreviousNode->State.Stack.back().ContainsLineBreak)
1069 Penalty += 15;
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001070 Penalty += PreviousNode->State.NextToken->SplitPenalty;
Daniel Jasperee7539a2013-07-08 14:25:23 +00001071 }
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001072
1073 StateNode *Node = new (Allocator.Allocate())
1074 StateNode(PreviousNode->State, NewLine, PreviousNode);
Manuel Klimek1998ea22013-02-20 10:15:13 +00001075 Penalty += addTokenToState(NewLine, true, Node->State);
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001076 if (Node->State.Column > getColumnLimit()) {
1077 unsigned ExcessCharacters = Node->State.Column - getColumnLimit();
Daniel Jasper3a9370c2013-02-04 07:21:18 +00001078 Penalty += Style.PenaltyExcessCharacter * ExcessCharacters;
Daniel Jasper2df93312013-01-09 10:16:05 +00001079 }
Manuel Klimek2ef908e2013-02-13 10:46:36 +00001080
1081 Queue.push(QueueItem(OrderedPenalty(Penalty, Count), Node));
1082 ++Count;
Daniel Jasper4b866272013-02-01 11:00:45 +00001083 }
Daniel Jasperf7935112012-12-03 18:12:45 +00001084
Daniel Jasper4b866272013-02-01 11:00:45 +00001085 /// \brief Returns \c true, if a line break after \p State is allowed.
1086 bool canBreak(const LineState &State) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001087 const FormatToken &Current = *State.NextToken;
1088 const FormatToken &Previous = *Current.Previous;
1089 assert(&Previous == Current.Previous);
Daniel Jasper473c62c2013-05-17 09:35:01 +00001090 if (!Current.CanBreakBefore &&
1091 !(Current.is(tok::r_brace) &&
Daniel Jasper4b866272013-02-01 11:00:45 +00001092 State.Stack.back().BreakBeforeClosingBrace))
1093 return false;
Daniel Jasper473c62c2013-05-17 09:35:01 +00001094 // The opening "{" of a braced list has to be on the same line as the first
1095 // element if it is nested in another braced init list or function call.
1096 if (!Current.MustBreakBefore && Previous.is(tok::l_brace) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001097 Previous.Previous &&
1098 Previous.Previous->isOneOf(tok::l_brace, tok::l_paren, tok::comma))
Daniel Jasper473c62c2013-05-17 09:35:01 +00001099 return false;
Daniel Jasper32a796b2013-05-27 11:50:16 +00001100 // This prevents breaks like:
1101 // ...
1102 // SomeParameter, OtherParameter).DoSomething(
1103 // ...
1104 // As they hide "DoSomething" and are generally bad for readability.
Daniel Jasper0e90c3d2013-07-05 09:14:35 +00001105 if (Previous.opensScope() &&
1106 State.LowestLevelOnLine < State.StartOfLineLevel)
Daniel Jasper32a796b2013-05-27 11:50:16 +00001107 return false;
Daniel Jaspercc960fa2013-04-22 07:59:53 +00001108 return !State.Stack.back().NoLineBreak;
Daniel Jasper4b866272013-02-01 11:00:45 +00001109 }
Daniel Jasperf7935112012-12-03 18:12:45 +00001110
Daniel Jasper4b866272013-02-01 11:00:45 +00001111 /// \brief Returns \c true, if a line break after \p State is mandatory.
1112 bool mustBreak(const LineState &State) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001113 const FormatToken &Current = *State.NextToken;
1114 const FormatToken &Previous = *Current.Previous;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001115 if (Current.MustBreakBefore || Current.Type == TT_InlineASMColon)
Daniel Jasper4b866272013-02-01 11:00:45 +00001116 return true;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001117 if (Current.is(tok::r_brace) && State.Stack.back().BreakBeforeClosingBrace)
Daniel Jasper4b866272013-02-01 11:00:45 +00001118 return true;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001119 if (Previous.is(tok::semi) && State.LineContainsContinuedForLoopSection)
Daniel Jasper4b866272013-02-01 11:00:45 +00001120 return true;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001121 if ((Previous.isOneOf(tok::comma, tok::semi) || Current.is(tok::question) ||
1122 Current.Type == TT_ConditionalExpr) &&
Daniel Jasperacc33662013-02-08 08:22:00 +00001123 State.Stack.back().BreakBeforeParameter &&
Daniel Jasperd69fc772013-05-08 14:12:04 +00001124 !Current.isTrailingComment() &&
1125 !Current.isOneOf(tok::r_paren, tok::r_brace))
Daniel Jasper4b866272013-02-01 11:00:45 +00001126 return true;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001127
1128 // If we need to break somewhere inside the LHS of a binary expression, we
Daniel Jasper7ae41cd2013-07-03 10:34:47 +00001129 // should also break after the operator. Otherwise, the formatting would
1130 // hide the operator precedence, e.g. in:
1131 // if (aaaaaaaaaaaaaa ==
1132 // bbbbbbbbbbbbbb && c) {..
1133 // For comparisons, we only apply this rule, if the LHS is a binary
1134 // expression itself as otherwise, the line breaks seem superfluous.
1135 // We need special cases for ">>" which we have split into two ">" while
1136 // lexing in order to make template parsing easier.
1137 bool IsComparison = (Previous.getPrecedence() == prec::Relational ||
1138 Previous.getPrecedence() == prec::Equality) &&
1139 Previous.Previous &&
1140 Previous.Previous->Type != TT_BinaryOperator; // For >>.
1141 bool LHSIsBinaryExpr =
1142 Previous.Previous && Previous.Previous->FakeRParens > 0;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001143 if (Previous.Type == TT_BinaryOperator &&
Daniel Jasper7ae41cd2013-07-03 10:34:47 +00001144 (!IsComparison || LHSIsBinaryExpr) &&
1145 Current.Type != TT_BinaryOperator && // For >>.
Daniel Jasper68d888c2013-06-03 08:42:05 +00001146 !Current.isTrailingComment() &&
Daniel Jasperd69fc772013-05-08 14:12:04 +00001147 !Previous.isOneOf(tok::lessless, tok::question) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001148 Previous.getPrecedence() != prec::Assignment &&
Daniel Jasperacc33662013-02-08 08:22:00 +00001149 State.Stack.back().BreakBeforeParameter)
Daniel Jasper1ac3e052013-02-05 10:07:47 +00001150 return true;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001151
1152 // FIXME: Comparing LongestObjCSelectorName to 0 is a hacky way of finding
1153 // out whether it is the first parameter. Clean this up.
1154 if (Current.Type == TT_ObjCSelectorName &&
1155 Current.LongestObjCSelectorName == 0 &&
1156 State.Stack.back().BreakBeforeParameter)
Daniel Jasper4b866272013-02-01 11:00:45 +00001157 return true;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001158 if ((Current.Type == TT_CtorInitializerColon ||
1159 (Previous.ClosesTemplateDeclaration && State.ParenLevel == 0)))
Daniel Jasper40aacf42013-03-14 13:45:21 +00001160 return true;
Daniel Jasperd69fc772013-05-08 14:12:04 +00001161
Daniel Jasper6331da02013-07-09 07:43:55 +00001162 if ((Current.Type == TT_StartOfName || Current.is(tok::kw_operator)) &&
1163 Line.MightBeFunctionDecl && State.Stack.back().BreakBeforeParameter &&
1164 State.ParenLevel == 0)
Daniel Jasperc6fbc212013-05-15 09:35:08 +00001165 return true;
Daniel Jasper4b866272013-02-01 11:00:45 +00001166 return false;
Daniel Jasperf7935112012-12-03 18:12:45 +00001167 }
1168
Daniel Jasper9b334242013-03-15 14:57:30 +00001169 // Returns the total number of columns required for the remaining tokens.
1170 unsigned getRemainingLength(const LineState &State) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001171 if (State.NextToken && State.NextToken->Previous)
1172 return Line.Last->TotalLength - State.NextToken->Previous->TotalLength;
Daniel Jasper9b334242013-03-15 14:57:30 +00001173 return 0;
1174 }
1175
Daniel Jasperf7935112012-12-03 18:12:45 +00001176 FormatStyle Style;
1177 SourceManager &SourceMgr;
Daniel Jasperf1e4b7d2013-01-14 13:08:07 +00001178 const AnnotatedLine &Line;
Manuel Klimek0b689fd2013-01-10 18:45:26 +00001179 const unsigned FirstIndent;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001180 const FormatToken *RootToken;
Daniel Jasperaa701fa2013-01-18 08:44:07 +00001181 WhitespaceManager &Whitespaces;
Manuel Klimekaf491072013-02-13 10:54:19 +00001182
1183 llvm::SpecificBumpPtrAllocator<StateNode> Allocator;
1184 QueueType Queue;
1185 // Increasing count of \c StateNode items we have created. This is used
1186 // to create a deterministic order independent of the container.
1187 unsigned Count;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001188 encoding::Encoding Encoding;
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001189 bool BinPackInconclusiveFunctions;
Daniel Jasperf7935112012-12-03 18:12:45 +00001190};
1191
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001192class FormatTokenLexer {
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001193public:
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001194 FormatTokenLexer(Lexer &Lex, SourceManager &SourceMgr,
1195 encoding::Encoding Encoding)
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001196 : FormatTok(NULL), GreaterStashed(false), TrailingWhitespace(0), Lex(Lex),
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001197 SourceMgr(SourceMgr), IdentTable(Lex.getLangOpts()),
1198 Encoding(Encoding) {
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001199 Lex.SetKeepWhitespaceMode(true);
1200 }
1201
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001202 ArrayRef<FormatToken *> lex() {
1203 assert(Tokens.empty());
1204 do {
1205 Tokens.push_back(getNextToken());
1206 } while (Tokens.back()->Tok.isNot(tok::eof));
1207 return Tokens;
1208 }
1209
1210 IdentifierTable &getIdentTable() { return IdentTable; }
1211
1212private:
1213 FormatToken *getNextToken() {
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001214 if (GreaterStashed) {
Manuel Klimek591ab5a2013-05-28 13:42:28 +00001215 // Create a synthesized second '>' token.
1216 Token Greater = FormatTok->Tok;
1217 FormatTok = new (Allocator.Allocate()) FormatToken;
1218 FormatTok->Tok = Greater;
Manuel Klimek5c24cca2013-05-23 10:56:37 +00001219 SourceLocation GreaterLocation =
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001220 FormatTok->Tok.getLocation().getLocWithOffset(1);
1221 FormatTok->WhitespaceRange =
1222 SourceRange(GreaterLocation, GreaterLocation);
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001223 FormatTok->TokenText = ">";
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001224 FormatTok->CodePointCount = 1;
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001225 GreaterStashed = false;
1226 return FormatTok;
1227 }
1228
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001229 FormatTok = new (Allocator.Allocate()) FormatToken;
1230 Lex.LexFromRawLexer(FormatTok->Tok);
1231 StringRef Text = rawTokenText(FormatTok->Tok);
Manuel Klimek9043c742013-05-27 15:23:34 +00001232 SourceLocation WhitespaceStart =
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001233 FormatTok->Tok.getLocation().getLocWithOffset(-TrailingWhitespace);
Manuel Klimek5c24cca2013-05-23 10:56:37 +00001234 if (SourceMgr.getFileOffset(WhitespaceStart) == 0)
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001235 FormatTok->IsFirst = true;
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001236
1237 // Consume and record whitespace until we find a significant token.
Manuel Klimek9043c742013-05-27 15:23:34 +00001238 unsigned WhitespaceLength = TrailingWhitespace;
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001239 while (FormatTok->Tok.is(tok::unknown)) {
Manuel Klimek0c137952013-02-11 12:33:24 +00001240 unsigned Newlines = Text.count('\n');
Daniel Jasper973c9422013-03-04 13:43:19 +00001241 if (Newlines > 0)
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001242 FormatTok->LastNewlineOffset = WhitespaceLength + Text.rfind('\n') + 1;
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001243 FormatTok->NewlinesBefore += Newlines;
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001244 unsigned EscapedNewlines = Text.count("\\\n");
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001245 FormatTok->HasUnescapedNewline |= EscapedNewlines != Newlines;
1246 WhitespaceLength += FormatTok->Tok.getLength();
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001247
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001248 Lex.LexFromRawLexer(FormatTok->Tok);
1249 Text = rawTokenText(FormatTok->Tok);
Manuel Klimek1abf7892013-01-04 23:34:14 +00001250 }
Manuel Klimekef920692013-01-07 07:56:50 +00001251
Manuel Klimek1abf7892013-01-04 23:34:14 +00001252 // In case the token starts with escaped newlines, we want to
1253 // take them into account as whitespace - this pattern is quite frequent
1254 // in macro definitions.
1255 // FIXME: What do we want to do with other escaped spaces, and escaped
1256 // spaces or newlines in the middle of tokens?
1257 // FIXME: Add a more explicit test.
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001258 while (Text.size() > 1 && Text[0] == '\\' && Text[1] == '\n') {
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001259 // FIXME: ++FormatTok->NewlinesBefore is missing...
Manuel Klimek5c24cca2013-05-23 10:56:37 +00001260 WhitespaceLength += 2;
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001261 Text = Text.substr(2);
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001262 }
1263
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001264 TrailingWhitespace = 0;
1265 if (FormatTok->Tok.is(tok::comment)) {
1266 StringRef UntrimmedText = Text;
1267 Text = Text.rtrim();
1268 TrailingWhitespace = UntrimmedText.size() - Text.size();
1269 } else if (FormatTok->Tok.is(tok::raw_identifier)) {
Manuel Klimek1abf7892013-01-04 23:34:14 +00001270 IdentifierInfo &Info = IdentTable.get(Text);
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001271 FormatTok->Tok.setIdentifierInfo(&Info);
1272 FormatTok->Tok.setKind(Info.getTokenID());
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001273 } else if (FormatTok->Tok.is(tok::greatergreater)) {
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001274 FormatTok->Tok.setKind(tok::greater);
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001275 Text = Text.substr(0, 1);
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001276 GreaterStashed = true;
1277 }
1278
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001279 // Now FormatTok is the next non-whitespace token.
1280 FormatTok->TokenText = Text;
1281 FormatTok->CodePointCount = encoding::getCodePointCount(Text, Encoding);
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001282
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001283 FormatTok->WhitespaceRange = SourceRange(
Manuel Klimek5c24cca2013-05-23 10:56:37 +00001284 WhitespaceStart, WhitespaceStart.getLocWithOffset(WhitespaceLength));
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001285 return FormatTok;
1286 }
1287
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001288 FormatToken *FormatTok;
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001289 bool GreaterStashed;
Manuel Klimek9043c742013-05-27 15:23:34 +00001290 unsigned TrailingWhitespace;
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001291 Lexer &Lex;
1292 SourceManager &SourceMgr;
1293 IdentifierTable IdentTable;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001294 encoding::Encoding Encoding;
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001295 llvm::SpecificBumpPtrAllocator<FormatToken> Allocator;
1296 SmallVector<FormatToken *, 16> Tokens;
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001297
1298 /// Returns the text of \c FormatTok.
Manuel Klimekef920692013-01-07 07:56:50 +00001299 StringRef rawTokenText(Token &Tok) {
Alexander Kornienkoe3276842012-12-07 16:15:44 +00001300 return StringRef(SourceMgr.getCharacterData(Tok.getLocation()),
1301 Tok.getLength());
1302 }
1303};
1304
Daniel Jasperf7935112012-12-03 18:12:45 +00001305class Formatter : public UnwrappedLineConsumer {
1306public:
Daniel Jasperd2ae41a2013-05-15 08:14:19 +00001307 Formatter(const FormatStyle &Style, Lexer &Lex, SourceManager &SourceMgr,
Daniel Jasperf7935112012-12-03 18:12:45 +00001308 const std::vector<CharSourceRange> &Ranges)
Daniel Jasperd2ae41a2013-05-15 08:14:19 +00001309 : Style(Style), Lex(Lex), SourceMgr(SourceMgr),
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001310 Whitespaces(SourceMgr, Style), Ranges(Ranges),
1311 Encoding(encoding::detectEncoding(Lex.getBuffer())) {
1312 DEBUG(llvm::dbgs()
1313 << "File encoding: "
1314 << (Encoding == encoding::Encoding_UTF8 ? "UTF8" : "unknown")
1315 << "\n");
1316 }
Daniel Jasperf7935112012-12-03 18:12:45 +00001317
Daniel Jasperfd8c4b12013-01-11 14:23:32 +00001318 virtual ~Formatter() {}
Daniel Jasper61bd3a12012-12-04 21:05:31 +00001319
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001320 tooling::Replacements format() {
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001321 FormatTokenLexer Tokens(Lex, SourceMgr, Encoding);
Manuel Klimek15dfe7a2013-05-28 11:55:06 +00001322
1323 UnwrappedLineParser Parser(Style, Tokens.lex(), *this);
Manuel Klimek1a18c402013-04-12 14:13:36 +00001324 bool StructuralError = Parser.parse();
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001325 TokenAnnotator Annotator(Style, Tokens.getIdentTable().get("in"));
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001326 for (unsigned i = 0, e = AnnotatedLines.size(); i != e; ++i) {
1327 Annotator.annotate(AnnotatedLines[i]);
1328 }
1329 deriveLocalStyle();
1330 for (unsigned i = 0, e = AnnotatedLines.size(); i != e; ++i) {
1331 Annotator.calculateFormattingInformation(AnnotatedLines[i]);
1332 }
Daniel Jasperb67cc422013-04-09 17:46:55 +00001333
1334 // Adapt level to the next line if this is a comment.
1335 // FIXME: Can/should this be done in the UnwrappedLineParser?
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001336 const AnnotatedLine *NextNonCommentLine = NULL;
Daniel Jasperb67cc422013-04-09 17:46:55 +00001337 for (unsigned i = AnnotatedLines.size() - 1; i > 0; --i) {
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001338 if (NextNonCommentLine && AnnotatedLines[i].First->is(tok::comment) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001339 !AnnotatedLines[i].First->Next)
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001340 AnnotatedLines[i].Level = NextNonCommentLine->Level;
Daniel Jasperb67cc422013-04-09 17:46:55 +00001341 else
Daniel Jasper3ac9b9e2013-07-08 14:34:09 +00001342 NextNonCommentLine = AnnotatedLines[i].First->isNot(tok::r_brace)
1343 ? &AnnotatedLines[i]
1344 : NULL;
Daniel Jasperb67cc422013-04-09 17:46:55 +00001345 }
1346
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001347 std::vector<int> IndentForLevel;
1348 bool PreviousLineWasTouched = false;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001349 const FormatToken *PreviousLineLastToken = 0;
Daniel Jasper1cb530f2013-05-10 13:00:49 +00001350 bool FormatPPDirective = false;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001351 for (std::vector<AnnotatedLine>::iterator I = AnnotatedLines.begin(),
1352 E = AnnotatedLines.end();
1353 I != E; ++I) {
1354 const AnnotatedLine &TheLine = *I;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001355 const FormatToken *FirstTok = TheLine.First;
1356 int Offset = getIndentOffset(*TheLine.First);
Daniel Jasper1cb530f2013-05-10 13:00:49 +00001357
1358 // Check whether this line is part of a formatted preprocessor directive.
Manuel Klimek591ab5a2013-05-28 13:42:28 +00001359 if (FirstTok->HasUnescapedNewline)
Daniel Jasper1cb530f2013-05-10 13:00:49 +00001360 FormatPPDirective = false;
1361 if (!FormatPPDirective && TheLine.InPPDirective &&
1362 (touchesLine(TheLine) || touchesPPDirective(I + 1, E)))
1363 FormatPPDirective = true;
1364
Daniel Jasper12f9d8e2013-05-14 09:30:02 +00001365 // Determine indent and try to merge multiple unwrapped lines.
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001366 while (IndentForLevel.size() <= TheLine.Level)
1367 IndentForLevel.push_back(-1);
1368 IndentForLevel.resize(TheLine.Level + 1);
Daniel Jasper12f9d8e2013-05-14 09:30:02 +00001369 unsigned Indent = getIndent(IndentForLevel, TheLine.Level);
1370 if (static_cast<int>(Indent) + Offset >= 0)
1371 Indent += Offset;
1372 tryFitMultipleLinesInOne(Indent, I, E);
1373
Manuel Klimek591ab5a2013-05-28 13:42:28 +00001374 bool WasMoved = PreviousLineWasTouched && FirstTok->NewlinesBefore == 0;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001375 if (TheLine.First->is(tok::eof)) {
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001376 if (PreviousLineWasTouched) {
Manuel Klimek591ab5a2013-05-28 13:42:28 +00001377 unsigned NewLines = std::min(FirstTok->NewlinesBefore, 1u);
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001378 Whitespaces.replaceWhitespace(*TheLine.First, NewLines, /*Indent*/ 0,
Manuel Klimek4fe43002013-05-22 12:51:29 +00001379 /*TargetColumn*/ 0);
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001380 }
1381 } else if (TheLine.Type != LT_Invalid &&
Daniel Jasper1cb530f2013-05-10 13:00:49 +00001382 (WasMoved || FormatPPDirective || touchesLine(TheLine))) {
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001383 unsigned LevelIndent = getIndent(IndentForLevel, TheLine.Level);
Manuel Klimek591ab5a2013-05-28 13:42:28 +00001384 if (FirstTok->WhitespaceRange.isValid() &&
Manuel Klimek1a18c402013-04-12 14:13:36 +00001385 // Insert a break even if there is a structural error in case where
1386 // we break apart a line consisting of multiple unwrapped lines.
Manuel Klimek591ab5a2013-05-28 13:42:28 +00001387 (FirstTok->NewlinesBefore == 0 || !StructuralError)) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001388 formatFirstToken(*TheLine.First, PreviousLineLastToken, Indent,
Manuel Klimek4fe43002013-05-22 12:51:29 +00001389 TheLine.InPPDirective);
Manuel Klimek1a18c402013-04-12 14:13:36 +00001390 } else {
1391 Indent = LevelIndent =
Manuel Klimek591ab5a2013-05-28 13:42:28 +00001392 SourceMgr.getSpellingColumnNumber(FirstTok->Tok.getLocation()) -
1393 1;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001394 }
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001395 UnwrappedLineFormatter Formatter(Style, SourceMgr, TheLine, Indent,
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001396 TheLine.First, Whitespaces, Encoding,
1397 BinPackInconclusiveFunctions);
Manuel Klimek4fe43002013-05-22 12:51:29 +00001398 Formatter.format(I + 1 != E ? &*(I + 1) : NULL);
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001399 IndentForLevel[TheLine.Level] = LevelIndent;
1400 PreviousLineWasTouched = true;
1401 } else {
Manuel Klimek4fe43002013-05-22 12:51:29 +00001402 // Format the first token if necessary, and notify the WhitespaceManager
1403 // about the unchanged whitespace.
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001404 for (const FormatToken *Tok = TheLine.First; Tok != NULL;
1405 Tok = Tok->Next) {
1406 if (Tok == TheLine.First &&
1407 (Tok->NewlinesBefore > 0 || Tok->IsFirst)) {
1408 unsigned LevelIndent =
1409 SourceMgr.getSpellingColumnNumber(Tok->Tok.getLocation()) - 1;
Manuel Klimek4fe43002013-05-22 12:51:29 +00001410 // Remove trailing whitespace of the previous line if it was
1411 // touched.
1412 if (PreviousLineWasTouched || touchesEmptyLineBefore(TheLine)) {
1413 formatFirstToken(*Tok, PreviousLineLastToken, LevelIndent,
1414 TheLine.InPPDirective);
1415 } else {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001416 Whitespaces.addUntouchableToken(*Tok, TheLine.InPPDirective);
Manuel Klimek4fe43002013-05-22 12:51:29 +00001417 }
Daniel Jasper12f9d8e2013-05-14 09:30:02 +00001418
Manuel Klimek4fe43002013-05-22 12:51:29 +00001419 if (static_cast<int>(LevelIndent) - Offset >= 0)
1420 LevelIndent -= Offset;
1421 if (Tok->isNot(tok::comment))
1422 IndentForLevel[TheLine.Level] = LevelIndent;
1423 } else {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001424 Whitespaces.addUntouchableToken(*Tok, TheLine.InPPDirective);
Manuel Klimek4fe43002013-05-22 12:51:29 +00001425 }
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001426 }
1427 // If we did not reformat this unwrapped line, the column at the end of
1428 // the last token is unchanged - thus, we can calculate the end of the
1429 // last token.
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001430 PreviousLineWasTouched = false;
1431 }
Alexander Kornienkofd433362013-03-27 17:08:02 +00001432 PreviousLineLastToken = I->Last;
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001433 }
1434 return Whitespaces.generateReplacements();
1435 }
1436
1437private:
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001438 void deriveLocalStyle() {
1439 unsigned CountBoundToVariable = 0;
1440 unsigned CountBoundToType = 0;
1441 bool HasCpp03IncompatibleFormat = false;
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001442 bool HasBinPackedFunction = false;
1443 bool HasOnePerLineFunction = false;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001444 for (unsigned i = 0, e = AnnotatedLines.size(); i != e; ++i) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001445 if (!AnnotatedLines[i].First->Next)
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001446 continue;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001447 FormatToken *Tok = AnnotatedLines[i].First->Next;
1448 while (Tok->Next) {
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001449 if (Tok->Type == TT_PointerOrReference) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001450 bool SpacesBefore =
1451 Tok->WhitespaceRange.getBegin() != Tok->WhitespaceRange.getEnd();
1452 bool SpacesAfter = Tok->Next->WhitespaceRange.getBegin() !=
1453 Tok->Next->WhitespaceRange.getEnd();
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001454 if (SpacesBefore && !SpacesAfter)
1455 ++CountBoundToVariable;
1456 else if (!SpacesBefore && SpacesAfter)
1457 ++CountBoundToType;
1458 }
1459
Daniel Jasper400adc62013-02-08 15:28:42 +00001460 if (Tok->Type == TT_TemplateCloser &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001461 Tok->Previous->Type == TT_TemplateCloser &&
1462 Tok->WhitespaceRange.getBegin() == Tok->WhitespaceRange.getEnd())
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001463 HasCpp03IncompatibleFormat = true;
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001464
1465 if (Tok->PackingKind == PPK_BinPacked)
1466 HasBinPackedFunction = true;
1467 if (Tok->PackingKind == PPK_OnePerLine)
1468 HasOnePerLineFunction = true;
1469
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001470 Tok = Tok->Next;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001471 }
1472 }
1473 if (Style.DerivePointerBinding) {
1474 if (CountBoundToType > CountBoundToVariable)
1475 Style.PointerBindsToType = true;
1476 else if (CountBoundToType < CountBoundToVariable)
1477 Style.PointerBindsToType = false;
1478 }
1479 if (Style.Standard == FormatStyle::LS_Auto) {
1480 Style.Standard = HasCpp03IncompatibleFormat ? FormatStyle::LS_Cpp11
1481 : FormatStyle::LS_Cpp03;
1482 }
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001483 BinPackInconclusiveFunctions =
1484 HasBinPackedFunction || !HasOnePerLineFunction;
Daniel Jasper7fce3ab2013-02-06 14:22:40 +00001485 }
1486
Manuel Klimekb95f5452013-02-08 17:38:27 +00001487 /// \brief Get the indent of \p Level from \p IndentForLevel.
1488 ///
1489 /// \p IndentForLevel must contain the indent for the level \c l
1490 /// at \p IndentForLevel[l], or a value < 0 if the indent for
1491 /// that level is unknown.
Daniel Jasper687af3b2013-02-14 14:26:07 +00001492 unsigned getIndent(const std::vector<int> IndentForLevel, unsigned Level) {
Manuel Klimekb95f5452013-02-08 17:38:27 +00001493 if (IndentForLevel[Level] != -1)
1494 return IndentForLevel[Level];
Manuel Klimekd076dcd2013-02-08 19:53:32 +00001495 if (Level == 0)
1496 return 0;
Manuel Klimek13b97d82013-05-13 08:42:42 +00001497 return getIndent(IndentForLevel, Level - 1) + Style.IndentWidth;
Manuel Klimekb95f5452013-02-08 17:38:27 +00001498 }
1499
1500 /// \brief Get the offset of the line relatively to the level.
1501 ///
1502 /// For example, 'public:' labels in classes are offset by 1 or 2
1503 /// characters to the left from their level.
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001504 int getIndentOffset(const FormatToken &RootToken) {
Alexander Kornienkofd433362013-03-27 17:08:02 +00001505 if (RootToken.isAccessSpecifier(false) || RootToken.isObjCAccessSpecifier())
Manuel Klimekb95f5452013-02-08 17:38:27 +00001506 return Style.AccessModifierOffset;
1507 return 0;
1508 }
1509
Manuel Klimekf4ab9ef2013-01-11 17:54:10 +00001510 /// \brief Tries to merge lines into one.
1511 ///
1512 /// This will change \c Line and \c AnnotatedLine to contain the merged line,
1513 /// if possible; note that \c I will be incremented when lines are merged.
Daniel Jaspera67a8f02013-01-16 10:41:46 +00001514 void tryFitMultipleLinesInOne(unsigned Indent,
Daniel Jasperf1e4b7d2013-01-14 13:08:07 +00001515 std::vector<AnnotatedLine>::iterator &I,
1516 std::vector<AnnotatedLine>::iterator E) {
Daniel Jaspera67a8f02013-01-16 10:41:46 +00001517 // We can never merge stuff if there are trailing line comments.
1518 if (I->Last->Type == TT_LineComment)
1519 return;
1520
Daniel Jasperc22f5b42013-02-28 11:05:57 +00001521 unsigned Limit = Style.ColumnLimit - Indent;
Daniel Jasper12ef4e52013-02-21 21:33:55 +00001522 // If we already exceed the column limit, we set 'Limit' to 0. The different
1523 // tryMerge..() functions can then decide whether to still do merging.
1524 Limit = I->Last->TotalLength > Limit ? 0 : Limit - I->Last->TotalLength;
Daniel Jasperc36492b2013-01-16 07:02:34 +00001525
Daniel Jasperd41ee2d2013-01-21 14:18:28 +00001526 if (I + 1 == E || (I + 1)->Type == LT_Invalid)
Daniel Jaspera67a8f02013-01-16 10:41:46 +00001527 return;
Manuel Klimekf4ab9ef2013-01-11 17:54:10 +00001528
Daniel Jasperabca58c2013-05-15 14:09:55 +00001529 if (I->Last->is(tok::l_brace)) {
Daniel Jasper25837aa2013-01-14 14:14:23 +00001530 tryMergeSimpleBlock(I, E, Limit);
Daniel Jasper3a685df2013-05-16 12:12:21 +00001531 } else if (Style.AllowShortIfStatementsOnASingleLine &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001532 I->First->is(tok::kw_if)) {
Daniel Jasper3a685df2013-05-16 12:12:21 +00001533 tryMergeSimpleControlStatement(I, E, Limit);
1534 } else if (Style.AllowShortLoopsOnASingleLine &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001535 I->First->isOneOf(tok::kw_for, tok::kw_while)) {
Daniel Jasper3a685df2013-05-16 12:12:21 +00001536 tryMergeSimpleControlStatement(I, E, Limit);
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001537 } else if (I->InPPDirective &&
1538 (I->First->HasUnescapedNewline || I->First->IsFirst)) {
Daniel Jasper39825ea2013-01-14 15:40:57 +00001539 tryMergeSimplePPDirective(I, E, Limit);
Daniel Jasper25837aa2013-01-14 14:14:23 +00001540 }
Daniel Jasper25837aa2013-01-14 14:14:23 +00001541 }
1542
Daniel Jasper39825ea2013-01-14 15:40:57 +00001543 void tryMergeSimplePPDirective(std::vector<AnnotatedLine>::iterator &I,
1544 std::vector<AnnotatedLine>::iterator E,
1545 unsigned Limit) {
Daniel Jasper12ef4e52013-02-21 21:33:55 +00001546 if (Limit == 0)
1547 return;
Daniel Jasper39825ea2013-01-14 15:40:57 +00001548 AnnotatedLine &Line = *I;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001549 if (!(I + 1)->InPPDirective || (I + 1)->First->HasUnescapedNewline)
Daniel Jasper2ab0d012013-01-14 15:52:06 +00001550 return;
Daniel Jasper39825ea2013-01-14 15:40:57 +00001551 if (I + 2 != E && (I + 2)->InPPDirective &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001552 !(I + 2)->First->HasUnescapedNewline)
Daniel Jasper39825ea2013-01-14 15:40:57 +00001553 return;
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001554 if (1 + (I + 1)->Last->TotalLength > Limit)
Daniel Jaspera67a8f02013-01-16 10:41:46 +00001555 return;
Daniel Jasper39825ea2013-01-14 15:40:57 +00001556 join(Line, *(++I));
1557 }
1558
Daniel Jasper3a685df2013-05-16 12:12:21 +00001559 void tryMergeSimpleControlStatement(std::vector<AnnotatedLine>::iterator &I,
1560 std::vector<AnnotatedLine>::iterator E,
1561 unsigned Limit) {
Daniel Jasper12ef4e52013-02-21 21:33:55 +00001562 if (Limit == 0)
1563 return;
Manuel Klimekda087612013-01-18 14:46:43 +00001564 if ((I + 1)->InPPDirective != I->InPPDirective ||
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001565 ((I + 1)->InPPDirective && (I + 1)->First->HasUnescapedNewline))
Manuel Klimekda087612013-01-18 14:46:43 +00001566 return;
Daniel Jasper25837aa2013-01-14 14:14:23 +00001567 AnnotatedLine &Line = *I;
Daniel Jasperc36492b2013-01-16 07:02:34 +00001568 if (Line.Last->isNot(tok::r_paren))
1569 return;
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001570 if (1 + (I + 1)->Last->TotalLength > Limit)
Daniel Jasper25837aa2013-01-14 14:14:23 +00001571 return;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001572 if ((I + 1)->First->isOneOf(tok::semi, tok::kw_if, tok::kw_for,
1573 tok::kw_while) ||
1574 (I + 1)->First->Type == TT_LineComment)
Daniel Jasper25837aa2013-01-14 14:14:23 +00001575 return;
1576 // Only inline simple if's (no nested if or else).
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001577 if (I + 2 != E && Line.First->is(tok::kw_if) &&
1578 (I + 2)->First->is(tok::kw_else))
Daniel Jasper25837aa2013-01-14 14:14:23 +00001579 return;
1580 join(Line, *(++I));
1581 }
1582
1583 void tryMergeSimpleBlock(std::vector<AnnotatedLine>::iterator &I,
Daniel Jasperbbc84152013-01-29 11:27:30 +00001584 std::vector<AnnotatedLine>::iterator E,
1585 unsigned Limit) {
Daniel Jasperabca58c2013-05-15 14:09:55 +00001586 // No merging if the brace already is on the next line.
1587 if (Style.BreakBeforeBraces != FormatStyle::BS_Attach)
1588 return;
1589
Manuel Klimekf4ab9ef2013-01-11 17:54:10 +00001590 // First, check that the current line allows merging. This is the case if
1591 // we're not in a control flow statement and the last token is an opening
1592 // brace.
Daniel Jasper25837aa2013-01-14 14:14:23 +00001593 AnnotatedLine &Line = *I;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001594 if (Line.First->isOneOf(tok::kw_if, tok::kw_while, tok::kw_do, tok::r_brace,
1595 tok::kw_else, tok::kw_try, tok::kw_catch,
Daniel Jaspera9eb2aa2013-05-31 14:56:20 +00001596 tok::kw_for,
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001597 // This gets rid of all ObjC @ keywords and methods.
1598 tok::at, tok::minus, tok::plus))
Daniel Jasper25837aa2013-01-14 14:14:23 +00001599 return;
Manuel Klimekf4ab9ef2013-01-11 17:54:10 +00001600
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001601 FormatToken *Tok = (I + 1)->First;
Daniel Jaspera9eb2aa2013-05-31 14:56:20 +00001602 if (Tok->is(tok::r_brace) && !Tok->MustBreakBefore &&
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001603 (Tok->getNextNonComment() == NULL ||
1604 Tok->getNextNonComment()->is(tok::semi))) {
Daniel Jasper12ef4e52013-02-21 21:33:55 +00001605 // We merge empty blocks even if the line exceeds the column limit.
Daniel Jaspereef30492013-02-11 12:36:37 +00001606 Tok->SpacesRequiredBefore = 0;
Daniel Jasper12ef4e52013-02-21 21:33:55 +00001607 Tok->CanBreakBefore = true;
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001608 join(Line, *(I + 1));
1609 I += 1;
Daniel Jaspera9eb2aa2013-05-31 14:56:20 +00001610 } else if (Limit != 0 && Line.First->isNot(tok::kw_namespace)) {
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001611 // Check that we still have three lines and they fit into the limit.
1612 if (I + 2 == E || (I + 2)->Type == LT_Invalid ||
1613 !nextTwoLinesFitInto(I, Limit))
Daniel Jasper25837aa2013-01-14 14:14:23 +00001614 return;
Manuel Klimekf4ab9ef2013-01-11 17:54:10 +00001615
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001616 // Second, check that the next line does not contain any braces - if it
1617 // does, readability declines when putting it into a single line.
1618 if ((I + 1)->Last->Type == TT_LineComment || Tok->MustBreakBefore)
1619 return;
1620 do {
Alexander Kornienko62b85b92013-03-13 14:41:29 +00001621 if (Tok->isOneOf(tok::l_brace, tok::r_brace))
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001622 return;
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001623 Tok = Tok->Next;
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001624 } while (Tok != NULL);
Manuel Klimekf4ab9ef2013-01-11 17:54:10 +00001625
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001626 // Last, check that the third line contains a single closing brace.
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001627 Tok = (I + 2)->First;
Alexander Kornienko1efe0a02013-07-04 14:47:51 +00001628 if (Tok->getNextNonComment() != NULL || Tok->isNot(tok::r_brace) ||
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001629 Tok->MustBreakBefore)
1630 return;
1631
1632 join(Line, *(I + 1));
1633 join(Line, *(I + 2));
1634 I += 2;
Manuel Klimekf4ab9ef2013-01-11 17:54:10 +00001635 }
Daniel Jasper25837aa2013-01-14 14:14:23 +00001636 }
1637
1638 bool nextTwoLinesFitInto(std::vector<AnnotatedLine>::iterator I,
1639 unsigned Limit) {
Manuel Klimeka4fe1c12013-01-21 16:42:44 +00001640 return 1 + (I + 1)->Last->TotalLength + 1 + (I + 2)->Last->TotalLength <=
1641 Limit;
Manuel Klimekf4ab9ef2013-01-11 17:54:10 +00001642 }
1643
Daniel Jasperf1e4b7d2013-01-14 13:08:07 +00001644 void join(AnnotatedLine &A, const AnnotatedLine &B) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001645 assert(!A.Last->Next);
1646 assert(!B.First->Previous);
1647 A.Last->Next = B.First;
1648 B.First->Previous = A.Last;
1649 unsigned LengthA = A.Last->TotalLength + B.First->SpacesRequiredBefore;
1650 for (FormatToken *Tok = B.First; Tok; Tok = Tok->Next) {
1651 Tok->TotalLength += LengthA;
1652 A.Last = Tok;
Daniel Jasperf1e4b7d2013-01-14 13:08:07 +00001653 }
Manuel Klimek51bd6ec2013-01-10 19:49:59 +00001654 }
1655
Daniel Jasper97b89482013-03-13 07:49:51 +00001656 bool touchesRanges(const CharSourceRange &Range) {
Daniel Jasperf71cf3b2013-03-07 20:50:00 +00001657 for (unsigned i = 0, e = Ranges.size(); i != e; ++i) {
1658 if (!SourceMgr.isBeforeInTranslationUnit(Range.getEnd(),
1659 Ranges[i].getBegin()) &&
1660 !SourceMgr.isBeforeInTranslationUnit(Ranges[i].getEnd(),
1661 Range.getBegin()))
1662 return true;
1663 }
1664 return false;
1665 }
1666
1667 bool touchesLine(const AnnotatedLine &TheLine) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001668 const FormatToken *First = TheLine.First;
1669 const FormatToken *Last = TheLine.Last;
Daniel Jaspercdd06622013-05-14 10:31:09 +00001670 CharSourceRange LineRange = CharSourceRange::getCharRange(
Manuel Klimek5c24cca2013-05-23 10:56:37 +00001671 First->WhitespaceRange.getBegin().getLocWithOffset(
1672 First->LastNewlineOffset),
Alexander Kornienkoee4ca9b2013-06-07 17:45:07 +00001673 Last->Tok.getLocation().getLocWithOffset(Last->TokenText.size() - 1));
Daniel Jasperf71cf3b2013-03-07 20:50:00 +00001674 return touchesRanges(LineRange);
1675 }
1676
Daniel Jasper1cb530f2013-05-10 13:00:49 +00001677 bool touchesPPDirective(std::vector<AnnotatedLine>::iterator I,
1678 std::vector<AnnotatedLine>::iterator E) {
1679 for (; I != E; ++I) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001680 if (I->First->HasUnescapedNewline)
Daniel Jasper1cb530f2013-05-10 13:00:49 +00001681 return false;
1682 if (touchesLine(*I))
1683 return true;
1684 }
1685 return false;
1686 }
1687
Daniel Jasperf71cf3b2013-03-07 20:50:00 +00001688 bool touchesEmptyLineBefore(const AnnotatedLine &TheLine) {
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001689 const FormatToken *First = TheLine.First;
Daniel Jasperf71cf3b2013-03-07 20:50:00 +00001690 CharSourceRange LineRange = CharSourceRange::getCharRange(
Manuel Klimek5c24cca2013-05-23 10:56:37 +00001691 First->WhitespaceRange.getBegin(),
1692 First->WhitespaceRange.getBegin().getLocWithOffset(
1693 First->LastNewlineOffset));
Daniel Jasperf71cf3b2013-03-07 20:50:00 +00001694 return touchesRanges(LineRange);
Manuel Klimek51bd6ec2013-01-10 19:49:59 +00001695 }
1696
1697 virtual void consumeUnwrappedLine(const UnwrappedLine &TheLine) {
Daniel Jasperdaffc0d2013-01-16 09:10:19 +00001698 AnnotatedLines.push_back(AnnotatedLine(TheLine));
Daniel Jasperf7935112012-12-03 18:12:45 +00001699 }
1700
Manuel Klimek0b689fd2013-01-10 18:45:26 +00001701 /// \brief Add a new line and the required indent before the first Token
1702 /// of the \c UnwrappedLine if there was no structural parsing error.
1703 /// Returns the indent level of the \c UnwrappedLine.
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001704 void formatFirstToken(const FormatToken &RootToken,
1705 const FormatToken *PreviousToken, unsigned Indent,
Manuel Klimek4fe43002013-05-22 12:51:29 +00001706 bool InPPDirective) {
Daniel Jasperbbc84152013-01-29 11:27:30 +00001707 unsigned Newlines =
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001708 std::min(RootToken.NewlinesBefore, Style.MaxEmptyLinesToKeep + 1);
Daniel Jasper1027c6e2013-06-03 16:16:41 +00001709 // Remove empty lines before "}" where applicable.
1710 if (RootToken.is(tok::r_brace) &&
1711 (!RootToken.Next ||
1712 (RootToken.Next->is(tok::semi) && !RootToken.Next->Next)))
1713 Newlines = std::min(Newlines, 1u);
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001714 if (Newlines == 0 && !RootToken.IsFirst)
Manuel Klimek0b689fd2013-01-10 18:45:26 +00001715 Newlines = 1;
Manuel Klimek0b689fd2013-01-10 18:45:26 +00001716
Manuel Klimek4fe43002013-05-22 12:51:29 +00001717 // Insert extra new line before access specifiers.
1718 if (PreviousToken && PreviousToken->isOneOf(tok::semi, tok::r_brace) &&
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001719 RootToken.isAccessSpecifier() && RootToken.NewlinesBefore == 1)
Manuel Klimek4fe43002013-05-22 12:51:29 +00001720 ++Newlines;
Alexander Kornienkofd433362013-03-27 17:08:02 +00001721
Manuel Klimek6e6310e2013-05-29 14:47:47 +00001722 Whitespaces.replaceWhitespace(
1723 RootToken, Newlines, Indent, Indent,
1724 InPPDirective && !RootToken.HasUnescapedNewline);
Manuel Klimek0b689fd2013-01-10 18:45:26 +00001725 }
1726
Daniel Jasperf7935112012-12-03 18:12:45 +00001727 FormatStyle Style;
1728 Lexer &Lex;
1729 SourceManager &SourceMgr;
Daniel Jasperaa701fa2013-01-18 08:44:07 +00001730 WhitespaceManager Whitespaces;
Daniel Jasperf7935112012-12-03 18:12:45 +00001731 std::vector<CharSourceRange> Ranges;
Daniel Jasperf1e4b7d2013-01-14 13:08:07 +00001732 std::vector<AnnotatedLine> AnnotatedLines;
Alexander Kornienkoffcc0102013-06-05 14:09:10 +00001733
1734 encoding::Encoding Encoding;
Daniel Jasperb10cbc42013-07-10 14:02:49 +00001735 bool BinPackInconclusiveFunctions;
Daniel Jasperf7935112012-12-03 18:12:45 +00001736};
1737
Craig Topperaf35e852013-06-30 22:29:28 +00001738} // end anonymous namespace
1739
Alexander Kornienkocb45bc12013-04-15 14:28:00 +00001740tooling::Replacements reformat(const FormatStyle &Style, Lexer &Lex,
1741 SourceManager &SourceMgr,
Daniel Jasperd2ae41a2013-05-15 08:14:19 +00001742 std::vector<CharSourceRange> Ranges) {
1743 Formatter formatter(Style, Lex, SourceMgr, Ranges);
Daniel Jasperf7935112012-12-03 18:12:45 +00001744 return formatter.format();
1745}
1746
Daniel Jasperec04c0d2013-05-16 10:40:07 +00001747tooling::Replacements reformat(const FormatStyle &Style, StringRef Code,
1748 std::vector<tooling::Range> Ranges,
1749 StringRef FileName) {
1750 FileManager Files((FileSystemOptions()));
1751 DiagnosticsEngine Diagnostics(
1752 IntrusiveRefCntPtr<DiagnosticIDs>(new DiagnosticIDs),
1753 new DiagnosticOptions);
1754 SourceManager SourceMgr(Diagnostics, Files);
1755 llvm::MemoryBuffer *Buf = llvm::MemoryBuffer::getMemBuffer(Code, FileName);
1756 const clang::FileEntry *Entry =
1757 Files.getVirtualFile(FileName, Buf->getBufferSize(), 0);
1758 SourceMgr.overrideFileContents(Entry, Buf);
1759 FileID ID =
1760 SourceMgr.createFileID(Entry, SourceLocation(), clang::SrcMgr::C_User);
Alexander Kornienko1e808872013-06-28 12:51:24 +00001761 Lexer Lex(ID, SourceMgr.getBuffer(ID), SourceMgr,
1762 getFormattingLangOpts(Style.Standard));
Daniel Jasperec04c0d2013-05-16 10:40:07 +00001763 SourceLocation StartOfFile = SourceMgr.getLocForStartOfFile(ID);
1764 std::vector<CharSourceRange> CharRanges;
1765 for (unsigned i = 0, e = Ranges.size(); i != e; ++i) {
1766 SourceLocation Start = StartOfFile.getLocWithOffset(Ranges[i].getOffset());
1767 SourceLocation End = Start.getLocWithOffset(Ranges[i].getLength());
1768 CharRanges.push_back(CharSourceRange::getCharRange(Start, End));
1769 }
1770 return reformat(Style, Lex, SourceMgr, CharRanges);
1771}
1772
Alexander Kornienko1e808872013-06-28 12:51:24 +00001773LangOptions getFormattingLangOpts(FormatStyle::LanguageStandard Standard) {
Daniel Jasperc1fa2812013-01-10 13:08:12 +00001774 LangOptions LangOpts;
1775 LangOpts.CPlusPlus = 1;
Alexander Kornienko1e808872013-06-28 12:51:24 +00001776 LangOpts.CPlusPlus11 = Standard == FormatStyle::LS_Cpp03 ? 0 : 1;
Daniel Jasper55213652013-03-22 10:01:29 +00001777 LangOpts.LineComment = 1;
Daniel Jasperc1fa2812013-01-10 13:08:12 +00001778 LangOpts.Bool = 1;
1779 LangOpts.ObjC1 = 1;
1780 LangOpts.ObjC2 = 1;
1781 return LangOpts;
1782}
1783
Daniel Jasper8d1832e2013-01-07 13:26:07 +00001784} // namespace format
1785} // namespace clang