FormatTestComments.cpp 97 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825
  1. //===- unittest/Format/FormatTestComments.cpp - Formatting unit tests -----===//
  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. #include "clang/Format/Format.h"
  10. #include "../Tooling/ReplacementTest.h"
  11. #include "FormatTestUtils.h"
  12. #include "clang/Frontend/TextDiagnosticPrinter.h"
  13. #include "llvm/Support/Debug.h"
  14. #include "llvm/Support/MemoryBuffer.h"
  15. #include "gtest/gtest.h"
  16. #define DEBUG_TYPE "format-test"
  17. using clang::tooling::ReplacementTest;
  18. namespace clang {
  19. namespace format {
  20. namespace {
  21. FormatStyle getGoogleStyle() { return getGoogleStyle(FormatStyle::LK_Cpp); }
  22. class FormatTestComments : public ::testing::Test {
  23. protected:
  24. enum StatusCheck {
  25. SC_ExpectComplete,
  26. SC_ExpectIncomplete,
  27. SC_DoNotCheck
  28. };
  29. std::string format(llvm::StringRef Code,
  30. const FormatStyle &Style = getLLVMStyle(),
  31. StatusCheck CheckComplete = SC_ExpectComplete) {
  32. DEBUG(llvm::errs() << "---\n");
  33. DEBUG(llvm::errs() << Code << "\n\n");
  34. std::vector<tooling::Range> Ranges(1, tooling::Range(0, Code.size()));
  35. FormattingAttemptStatus Status;
  36. tooling::Replacements Replaces =
  37. reformat(Style, Code, Ranges, "<stdin>", &Status);
  38. if (CheckComplete != SC_DoNotCheck) {
  39. bool ExpectedCompleteFormat = CheckComplete == SC_ExpectComplete;
  40. EXPECT_EQ(ExpectedCompleteFormat, Status.FormatComplete)
  41. << Code << "\n\n";
  42. }
  43. ReplacementCount = Replaces.size();
  44. auto Result = applyAllReplacements(Code, Replaces);
  45. EXPECT_TRUE(static_cast<bool>(Result));
  46. DEBUG(llvm::errs() << "\n" << *Result << "\n\n");
  47. return *Result;
  48. }
  49. FormatStyle getLLVMStyleWithColumns(unsigned ColumnLimit) {
  50. FormatStyle Style = getLLVMStyle();
  51. Style.ColumnLimit = ColumnLimit;
  52. return Style;
  53. }
  54. void verifyFormat(llvm::StringRef Code,
  55. const FormatStyle &Style = getLLVMStyle()) {
  56. EXPECT_EQ(Code.str(), format(test::messUp(Code), Style));
  57. }
  58. void verifyGoogleFormat(llvm::StringRef Code) {
  59. verifyFormat(Code, getGoogleStyle());
  60. }
  61. /// \brief Verify that clang-format does not crash on the given input.
  62. void verifyNoCrash(llvm::StringRef Code,
  63. const FormatStyle &Style = getLLVMStyle()) {
  64. format(Code, Style, SC_DoNotCheck);
  65. }
  66. int ReplacementCount;
  67. };
  68. //===----------------------------------------------------------------------===//
  69. // Tests for comments.
  70. //===----------------------------------------------------------------------===//
  71. TEST_F(FormatTestComments, UnderstandsSingleLineComments) {
  72. verifyFormat("//* */");
  73. verifyFormat("// line 1\n"
  74. "// line 2\n"
  75. "void f() {}\n");
  76. verifyFormat("void f() {\n"
  77. " // Doesn't do anything\n"
  78. "}");
  79. verifyFormat("SomeObject\n"
  80. " // Calling someFunction on SomeObject\n"
  81. " .someFunction();");
  82. verifyFormat("auto result = SomeObject\n"
  83. " // Calling someFunction on SomeObject\n"
  84. " .someFunction();");
  85. verifyFormat("void f(int i, // some comment (probably for i)\n"
  86. " int j, // some comment (probably for j)\n"
  87. " int k); // some comment (probably for k)");
  88. verifyFormat("void f(int i,\n"
  89. " // some comment (probably for j)\n"
  90. " int j,\n"
  91. " // some comment (probably for k)\n"
  92. " int k);");
  93. verifyFormat("int i // This is a fancy variable\n"
  94. " = 5; // with nicely aligned comment.");
  95. verifyFormat("// Leading comment.\n"
  96. "int a; // Trailing comment.");
  97. verifyFormat("int a; // Trailing comment\n"
  98. " // on 2\n"
  99. " // or 3 lines.\n"
  100. "int b;");
  101. verifyFormat("int a; // Trailing comment\n"
  102. "\n"
  103. "// Leading comment.\n"
  104. "int b;");
  105. verifyFormat("int a; // Comment.\n"
  106. " // More details.\n"
  107. "int bbbb; // Another comment.");
  108. verifyFormat(
  109. "int aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa; // comment\n"
  110. "int bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb; // comment\n"
  111. "int cccccccccccccccccccccccccccccc; // comment\n"
  112. "int ddd; // looooooooooooooooooooooooong comment\n"
  113. "int aaaaaaaaaaaaaaaaaaaaaaa; // comment\n"
  114. "int bbbbbbbbbbbbbbbbbbbbb; // comment\n"
  115. "int ccccccccccccccccccc; // comment");
  116. verifyFormat("#include \"a\" // comment\n"
  117. "#include \"a/b/c\" // comment");
  118. verifyFormat("#include <a> // comment\n"
  119. "#include <a/b/c> // comment");
  120. EXPECT_EQ("#include \"a\" // comment\n"
  121. "#include \"a/b/c\" // comment",
  122. format("#include \\\n"
  123. " \"a\" // comment\n"
  124. "#include \"a/b/c\" // comment"));
  125. verifyFormat("enum E {\n"
  126. " // comment\n"
  127. " VAL_A, // comment\n"
  128. " VAL_B\n"
  129. "};");
  130. EXPECT_EQ("enum A {\n"
  131. " // line a\n"
  132. " a,\n"
  133. " b, // line b\n"
  134. "\n"
  135. " // line c\n"
  136. " c\n"
  137. "};",
  138. format("enum A {\n"
  139. " // line a\n"
  140. " a,\n"
  141. " b, // line b\n"
  142. "\n"
  143. " // line c\n"
  144. " c\n"
  145. "};",
  146. getLLVMStyleWithColumns(20)));
  147. EXPECT_EQ("enum A {\n"
  148. " a, // line 1\n"
  149. " // line 2\n"
  150. "};",
  151. format("enum A {\n"
  152. " a, // line 1\n"
  153. " // line 2\n"
  154. "};",
  155. getLLVMStyleWithColumns(20)));
  156. EXPECT_EQ("enum A {\n"
  157. " a, // line 1\n"
  158. " // line 2\n"
  159. "};",
  160. format("enum A {\n"
  161. " a, // line 1\n"
  162. " // line 2\n"
  163. "};",
  164. getLLVMStyleWithColumns(20)));
  165. EXPECT_EQ("enum A {\n"
  166. " a, // line 1\n"
  167. " // line 2\n"
  168. " b\n"
  169. "};",
  170. format("enum A {\n"
  171. " a, // line 1\n"
  172. " // line 2\n"
  173. " b\n"
  174. "};",
  175. getLLVMStyleWithColumns(20)));
  176. EXPECT_EQ("enum A {\n"
  177. " a, // line 1\n"
  178. " // line 2\n"
  179. " b\n"
  180. "};",
  181. format("enum A {\n"
  182. " a, // line 1\n"
  183. " // line 2\n"
  184. " b\n"
  185. "};",
  186. getLLVMStyleWithColumns(20)));
  187. verifyFormat(
  188. "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa =\n"
  189. " bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb; // Trailing comment");
  190. verifyFormat("aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa =\n"
  191. " // Comment inside a statement.\n"
  192. " bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb;");
  193. verifyFormat("SomeFunction(a,\n"
  194. " // comment\n"
  195. " b + x);");
  196. verifyFormat("SomeFunction(a, a,\n"
  197. " // comment\n"
  198. " b + x);");
  199. verifyFormat(
  200. "bool aaaaaaaaaaaaa = // comment\n"
  201. " aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa || aaaaaaaaaaaaaaaaaaaaaaaaaaaa ||\n"
  202. " aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa || aaaaaaaaaaaaaaaaaaaaaaaaaaaaa;");
  203. verifyFormat("int aaaa; // aaaaa\n"
  204. "int aa; // aaaaaaa",
  205. getLLVMStyleWithColumns(20));
  206. EXPECT_EQ("void f() { // This does something ..\n"
  207. "}\n"
  208. "int a; // This is unrelated",
  209. format("void f() { // This does something ..\n"
  210. " }\n"
  211. "int a; // This is unrelated"));
  212. EXPECT_EQ("class C {\n"
  213. " void f() { // This does something ..\n"
  214. " } // awesome..\n"
  215. "\n"
  216. " int a; // This is unrelated\n"
  217. "};",
  218. format("class C{void f() { // This does something ..\n"
  219. " } // awesome..\n"
  220. " \n"
  221. "int a; // This is unrelated\n"
  222. "};"));
  223. EXPECT_EQ("int i; // single line trailing comment",
  224. format("int i;\\\n// single line trailing comment"));
  225. verifyGoogleFormat("int a; // Trailing comment.");
  226. verifyFormat("someFunction(anotherFunction( // Force break.\n"
  227. " parameter));");
  228. verifyGoogleFormat("#endif // HEADER_GUARD");
  229. verifyFormat("const char *test[] = {\n"
  230. " // A\n"
  231. " \"aaaa\",\n"
  232. " // B\n"
  233. " \"aaaaa\"};");
  234. verifyGoogleFormat(
  235. "aaaaaaaaaaaaaaaaaaaaaaaaaa(\n"
  236. " aaaaaaaaaaaaaaaaaaaaaa); // 81_cols_with_this_comment");
  237. EXPECT_EQ("D(a, {\n"
  238. " // test\n"
  239. " int a;\n"
  240. "});",
  241. format("D(a, {\n"
  242. "// test\n"
  243. "int a;\n"
  244. "});"));
  245. EXPECT_EQ("lineWith(); // comment\n"
  246. "// at start\n"
  247. "otherLine();",
  248. format("lineWith(); // comment\n"
  249. "// at start\n"
  250. "otherLine();"));
  251. EXPECT_EQ("lineWith(); // comment\n"
  252. "/*\n"
  253. " * at start */\n"
  254. "otherLine();",
  255. format("lineWith(); // comment\n"
  256. "/*\n"
  257. " * at start */\n"
  258. "otherLine();"));
  259. EXPECT_EQ("lineWith(); // comment\n"
  260. " // at start\n"
  261. "otherLine();",
  262. format("lineWith(); // comment\n"
  263. " // at start\n"
  264. "otherLine();"));
  265. EXPECT_EQ("lineWith(); // comment\n"
  266. "// at start\n"
  267. "otherLine(); // comment",
  268. format("lineWith(); // comment\n"
  269. "// at start\n"
  270. "otherLine(); // comment"));
  271. EXPECT_EQ("lineWith();\n"
  272. "// at start\n"
  273. "otherLine(); // comment",
  274. format("lineWith();\n"
  275. " // at start\n"
  276. "otherLine(); // comment"));
  277. EXPECT_EQ("// first\n"
  278. "// at start\n"
  279. "otherLine(); // comment",
  280. format("// first\n"
  281. " // at start\n"
  282. "otherLine(); // comment"));
  283. EXPECT_EQ("f();\n"
  284. "// first\n"
  285. "// at start\n"
  286. "otherLine(); // comment",
  287. format("f();\n"
  288. "// first\n"
  289. " // at start\n"
  290. "otherLine(); // comment"));
  291. verifyFormat("f(); // comment\n"
  292. "// first\n"
  293. "// at start\n"
  294. "otherLine();");
  295. EXPECT_EQ("f(); // comment\n"
  296. "// first\n"
  297. "// at start\n"
  298. "otherLine();",
  299. format("f(); // comment\n"
  300. "// first\n"
  301. " // at start\n"
  302. "otherLine();"));
  303. EXPECT_EQ("f(); // comment\n"
  304. " // first\n"
  305. "// at start\n"
  306. "otherLine();",
  307. format("f(); // comment\n"
  308. " // first\n"
  309. "// at start\n"
  310. "otherLine();"));
  311. EXPECT_EQ("void f() {\n"
  312. " lineWith(); // comment\n"
  313. " // at start\n"
  314. "}",
  315. format("void f() {\n"
  316. " lineWith(); // comment\n"
  317. " // at start\n"
  318. "}"));
  319. EXPECT_EQ("int xy; // a\n"
  320. "int z; // b",
  321. format("int xy; // a\n"
  322. "int z; //b"));
  323. EXPECT_EQ("int xy; // a\n"
  324. "int z; // bb",
  325. format("int xy; // a\n"
  326. "int z; //bb",
  327. getLLVMStyleWithColumns(12)));
  328. verifyFormat("#define A \\\n"
  329. " int i; /* iiiiiiiiiiiiiiiiiiiii */ \\\n"
  330. " int jjjjjjjjjjjjjjjjjjjjjjjj; /* */",
  331. getLLVMStyleWithColumns(60));
  332. verifyFormat(
  333. "#define A \\\n"
  334. " int i; /* iiiiiiiiiiiiiiiiiiiii */ \\\n"
  335. " int jjjjjjjjjjjjjjjjjjjjjjjj; /* */",
  336. getLLVMStyleWithColumns(61));
  337. verifyFormat("if ( // This is some comment\n"
  338. " x + 3) {\n"
  339. "}");
  340. EXPECT_EQ("if ( // This is some comment\n"
  341. " // spanning two lines\n"
  342. " x + 3) {\n"
  343. "}",
  344. format("if( // This is some comment\n"
  345. " // spanning two lines\n"
  346. " x + 3) {\n"
  347. "}"));
  348. verifyNoCrash("/\\\n/");
  349. verifyNoCrash("/\\\n* */");
  350. // The 0-character somehow makes the lexer return a proper comment.
  351. verifyNoCrash(StringRef("/*\\\0\n/", 6));
  352. }
  353. TEST_F(FormatTestComments, KeepsParameterWithTrailingCommentsOnTheirOwnLine) {
  354. EXPECT_EQ("SomeFunction(a,\n"
  355. " b, // comment\n"
  356. " c);",
  357. format("SomeFunction(a,\n"
  358. " b, // comment\n"
  359. " c);"));
  360. EXPECT_EQ("SomeFunction(a, b,\n"
  361. " // comment\n"
  362. " c);",
  363. format("SomeFunction(a,\n"
  364. " b,\n"
  365. " // comment\n"
  366. " c);"));
  367. EXPECT_EQ("SomeFunction(a, b, // comment (unclear relation)\n"
  368. " c);",
  369. format("SomeFunction(a, b, // comment (unclear relation)\n"
  370. " c);"));
  371. EXPECT_EQ("SomeFunction(a, // comment\n"
  372. " b,\n"
  373. " c); // comment",
  374. format("SomeFunction(a, // comment\n"
  375. " b,\n"
  376. " c); // comment"));
  377. EXPECT_EQ("aaaaaaaaaa(aaaa(aaaa,\n"
  378. " aaaa), //\n"
  379. " aaaa, bbbbb);",
  380. format("aaaaaaaaaa(aaaa(aaaa,\n"
  381. "aaaa), //\n"
  382. "aaaa, bbbbb);"));
  383. }
  384. TEST_F(FormatTestComments, RemovesTrailingWhitespaceOfComments) {
  385. EXPECT_EQ("// comment", format("// comment "));
  386. EXPECT_EQ("int aaaaaaa, bbbbbbb; // comment",
  387. format("int aaaaaaa, bbbbbbb; // comment ",
  388. getLLVMStyleWithColumns(33)));
  389. EXPECT_EQ("// comment\\\n", format("// comment\\\n \t \v \f "));
  390. EXPECT_EQ("// comment \\\n", format("// comment \\\n \t \v \f "));
  391. }
  392. TEST_F(FormatTestComments, UnderstandsBlockComments) {
  393. verifyFormat("f(/*noSpaceAfterParameterNamingComment=*/true);");
  394. verifyFormat("void f() { g(/*aaa=*/x, /*bbb=*/!y, /*c=*/::c); }");
  395. EXPECT_EQ("f(aaaaaaaaaaaaaaaaaaaaaaaaa, /* Trailing comment for aa... */\n"
  396. " bbbbbbbbbbbbbbbbbbbbbbbbb);",
  397. format("f(aaaaaaaaaaaaaaaaaaaaaaaaa , \\\n"
  398. "/* Trailing comment for aa... */\n"
  399. " bbbbbbbbbbbbbbbbbbbbbbbbb);"));
  400. EXPECT_EQ(
  401. "f(aaaaaaaaaaaaaaaaaaaaaaaaa,\n"
  402. " /* Leading comment for bb... */ bbbbbbbbbbbbbbbbbbbbbbbbb);",
  403. format("f(aaaaaaaaaaaaaaaaaaaaaaaaa , \n"
  404. "/* Leading comment for bb... */ bbbbbbbbbbbbbbbbbbbbbbbbb);"));
  405. EXPECT_EQ(
  406. "void aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa(\n"
  407. " aaaaaaaaaaaaaaaaaa,\n"
  408. " aaaaaaaaaaaaaaaaaa) { /*aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa*/\n"
  409. "}",
  410. format("void aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa(\n"
  411. " aaaaaaaaaaaaaaaaaa ,\n"
  412. " aaaaaaaaaaaaaaaaaa) { /*aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa*/\n"
  413. "}"));
  414. verifyFormat("f(/* aaaaaaaaaaaaaaaaaa = */\n"
  415. " aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa);");
  416. FormatStyle NoBinPacking = getLLVMStyle();
  417. NoBinPacking.BinPackParameters = false;
  418. verifyFormat("aaaaaaaa(/* parameter 1 */ aaaaaa,\n"
  419. " /* parameter 2 */ aaaaaa,\n"
  420. " /* parameter 3 */ aaaaaa,\n"
  421. " /* parameter 4 */ aaaaaa);",
  422. NoBinPacking);
  423. // Aligning block comments in macros.
  424. verifyGoogleFormat("#define A \\\n"
  425. " int i; /*a*/ \\\n"
  426. " int jjj; /*b*/");
  427. }
  428. TEST_F(FormatTestComments, AlignsBlockComments) {
  429. EXPECT_EQ("/*\n"
  430. " * Really multi-line\n"
  431. " * comment.\n"
  432. " */\n"
  433. "void f() {}",
  434. format(" /*\n"
  435. " * Really multi-line\n"
  436. " * comment.\n"
  437. " */\n"
  438. " void f() {}"));
  439. EXPECT_EQ("class C {\n"
  440. " /*\n"
  441. " * Another multi-line\n"
  442. " * comment.\n"
  443. " */\n"
  444. " void f() {}\n"
  445. "};",
  446. format("class C {\n"
  447. "/*\n"
  448. " * Another multi-line\n"
  449. " * comment.\n"
  450. " */\n"
  451. "void f() {}\n"
  452. "};"));
  453. EXPECT_EQ("/*\n"
  454. " 1. This is a comment with non-trivial formatting.\n"
  455. " 1.1. We have to indent/outdent all lines equally\n"
  456. " 1.1.1. to keep the formatting.\n"
  457. " */",
  458. format(" /*\n"
  459. " 1. This is a comment with non-trivial formatting.\n"
  460. " 1.1. We have to indent/outdent all lines equally\n"
  461. " 1.1.1. to keep the formatting.\n"
  462. " */"));
  463. EXPECT_EQ("/*\n"
  464. "Don't try to outdent if there's not enough indentation.\n"
  465. "*/",
  466. format(" /*\n"
  467. " Don't try to outdent if there's not enough indentation.\n"
  468. " */"));
  469. EXPECT_EQ("int i; /* Comment with empty...\n"
  470. " *\n"
  471. " * line. */",
  472. format("int i; /* Comment with empty...\n"
  473. " *\n"
  474. " * line. */"));
  475. EXPECT_EQ("int foobar = 0; /* comment */\n"
  476. "int bar = 0; /* multiline\n"
  477. " comment 1 */\n"
  478. "int baz = 0; /* multiline\n"
  479. " comment 2 */\n"
  480. "int bzz = 0; /* multiline\n"
  481. " comment 3 */",
  482. format("int foobar = 0; /* comment */\n"
  483. "int bar = 0; /* multiline\n"
  484. " comment 1 */\n"
  485. "int baz = 0; /* multiline\n"
  486. " comment 2 */\n"
  487. "int bzz = 0; /* multiline\n"
  488. " comment 3 */"));
  489. EXPECT_EQ("int foobar = 0; /* comment */\n"
  490. "int bar = 0; /* multiline\n"
  491. " comment */\n"
  492. "int baz = 0; /* multiline\n"
  493. "comment */",
  494. format("int foobar = 0; /* comment */\n"
  495. "int bar = 0; /* multiline\n"
  496. "comment */\n"
  497. "int baz = 0; /* multiline\n"
  498. "comment */"));
  499. }
  500. TEST_F(FormatTestComments, CommentReflowingCanBeTurnedOff) {
  501. FormatStyle Style = getLLVMStyleWithColumns(20);
  502. Style.ReflowComments = false;
  503. verifyFormat("// aaaaaaaaa aaaaaaaaaa aaaaaaaaaa", Style);
  504. verifyFormat("/* aaaaaaaaa aaaaaaaaaa aaaaaaaaaa */", Style);
  505. }
  506. TEST_F(FormatTestComments, CorrectlyHandlesLengthOfBlockComments) {
  507. EXPECT_EQ("double *x; /* aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n"
  508. " aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa */",
  509. format("double *x; /* aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n"
  510. " aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa */"));
  511. EXPECT_EQ(
  512. "void ffffffffffff(\n"
  513. " int aaaaaaaa, int bbbbbbbb,\n"
  514. " int cccccccccccc) { /*\n"
  515. " aaaaaaaaaa\n"
  516. " aaaaaaaaaaaaa\n"
  517. " bbbbbbbbbbbbbb\n"
  518. " bbbbbbbbbb\n"
  519. " */\n"
  520. "}",
  521. format("void ffffffffffff(int aaaaaaaa, int bbbbbbbb, int cccccccccccc)\n"
  522. "{ /*\n"
  523. " aaaaaaaaaa aaaaaaaaaaaaa\n"
  524. " bbbbbbbbbbbbbb bbbbbbbbbb\n"
  525. " */\n"
  526. "}",
  527. getLLVMStyleWithColumns(40)));
  528. }
  529. TEST_F(FormatTestComments, DontBreakNonTrailingBlockComments) {
  530. EXPECT_EQ("void ffffffffff(\n"
  531. " int aaaaa /* test */);",
  532. format("void ffffffffff(int aaaaa /* test */);",
  533. getLLVMStyleWithColumns(35)));
  534. }
  535. TEST_F(FormatTestComments, SplitsLongCxxComments) {
  536. EXPECT_EQ("// A comment that\n"
  537. "// doesn't fit on\n"
  538. "// one line",
  539. format("// A comment that doesn't fit on one line",
  540. getLLVMStyleWithColumns(20)));
  541. EXPECT_EQ("/// A comment that\n"
  542. "/// doesn't fit on\n"
  543. "/// one line",
  544. format("/// A comment that doesn't fit on one line",
  545. getLLVMStyleWithColumns(20)));
  546. EXPECT_EQ("//! A comment that\n"
  547. "//! doesn't fit on\n"
  548. "//! one line",
  549. format("//! A comment that doesn't fit on one line",
  550. getLLVMStyleWithColumns(20)));
  551. EXPECT_EQ("// a b c d\n"
  552. "// e f g\n"
  553. "// h i j k",
  554. format("// a b c d e f g h i j k", getLLVMStyleWithColumns(10)));
  555. EXPECT_EQ(
  556. "// a b c d\n"
  557. "// e f g\n"
  558. "// h i j k",
  559. format("\\\n// a b c d e f g h i j k", getLLVMStyleWithColumns(10)));
  560. EXPECT_EQ("if (true) // A comment that\n"
  561. " // doesn't fit on\n"
  562. " // one line",
  563. format("if (true) // A comment that doesn't fit on one line ",
  564. getLLVMStyleWithColumns(30)));
  565. EXPECT_EQ("// Don't_touch_leading_whitespace",
  566. format("// Don't_touch_leading_whitespace",
  567. getLLVMStyleWithColumns(20)));
  568. EXPECT_EQ("// Add leading\n"
  569. "// whitespace",
  570. format("//Add leading whitespace", getLLVMStyleWithColumns(20)));
  571. EXPECT_EQ("/// Add leading\n"
  572. "/// whitespace",
  573. format("///Add leading whitespace", getLLVMStyleWithColumns(20)));
  574. EXPECT_EQ("//! Add leading\n"
  575. "//! whitespace",
  576. format("//!Add leading whitespace", getLLVMStyleWithColumns(20)));
  577. EXPECT_EQ("// whitespace", format("//whitespace", getLLVMStyle()));
  578. EXPECT_EQ("// Even if it makes the line exceed the column\n"
  579. "// limit",
  580. format("//Even if it makes the line exceed the column limit",
  581. getLLVMStyleWithColumns(51)));
  582. EXPECT_EQ("//--But not here", format("//--But not here", getLLVMStyle()));
  583. EXPECT_EQ("/// line 1\n"
  584. "// add leading whitespace",
  585. format("/// line 1\n"
  586. "//add leading whitespace",
  587. getLLVMStyleWithColumns(30)));
  588. EXPECT_EQ("/// line 1\n"
  589. "/// line 2\n"
  590. "//! line 3\n"
  591. "//! line 4\n"
  592. "//! line 5\n"
  593. "// line 6\n"
  594. "// line 7",
  595. format("///line 1\n"
  596. "///line 2\n"
  597. "//! line 3\n"
  598. "//!line 4\n"
  599. "//!line 5\n"
  600. "// line 6\n"
  601. "//line 7", getLLVMStyleWithColumns(20)));
  602. EXPECT_EQ("// aa bb cc dd",
  603. format("// aa bb cc dd ",
  604. getLLVMStyleWithColumns(15)));
  605. EXPECT_EQ("// A comment before\n"
  606. "// a macro\n"
  607. "// definition\n"
  608. "#define a b",
  609. format("// A comment before a macro definition\n"
  610. "#define a b",
  611. getLLVMStyleWithColumns(20)));
  612. EXPECT_EQ("void ffffff(\n"
  613. " int aaaaaaaaa, // wwww\n"
  614. " int bbbbbbbbbb, // xxxxxxx\n"
  615. " // yyyyyyyyyy\n"
  616. " int c, int d, int e) {}",
  617. format("void ffffff(\n"
  618. " int aaaaaaaaa, // wwww\n"
  619. " int bbbbbbbbbb, // xxxxxxx yyyyyyyyyy\n"
  620. " int c, int d, int e) {}",
  621. getLLVMStyleWithColumns(40)));
  622. EXPECT_EQ("//\t aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  623. format("//\t aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  624. getLLVMStyleWithColumns(20)));
  625. EXPECT_EQ(
  626. "#define XXX // a b c d\n"
  627. " // e f g h",
  628. format("#define XXX // a b c d e f g h", getLLVMStyleWithColumns(22)));
  629. EXPECT_EQ(
  630. "#define XXX // q w e r\n"
  631. " // t y u i",
  632. format("#define XXX //q w e r t y u i", getLLVMStyleWithColumns(22)));
  633. EXPECT_EQ("{\n"
  634. " //\n"
  635. " //\\\n"
  636. " // long 1 2 3 4\n"
  637. " // 5\n"
  638. "}",
  639. format("{\n"
  640. " //\n"
  641. " //\\\n"
  642. " // long 1 2 3 4 5\n"
  643. "}",
  644. getLLVMStyleWithColumns(20)));
  645. }
  646. TEST_F(FormatTestComments, PreservesHangingIndentInCxxComments) {
  647. EXPECT_EQ("// A comment\n"
  648. "// that doesn't\n"
  649. "// fit on one\n"
  650. "// line",
  651. format("// A comment that doesn't fit on one line",
  652. getLLVMStyleWithColumns(20)));
  653. EXPECT_EQ("/// A comment\n"
  654. "/// that doesn't\n"
  655. "/// fit on one\n"
  656. "/// line",
  657. format("/// A comment that doesn't fit on one line",
  658. getLLVMStyleWithColumns(20)));
  659. }
  660. TEST_F(FormatTestComments, DontSplitLineCommentsWithEscapedNewlines) {
  661. EXPECT_EQ("// aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\\\n"
  662. "// aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\\\n"
  663. "// aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  664. format("// aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\\\n"
  665. "// aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\\\n"
  666. "// aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"));
  667. EXPECT_EQ("int a; // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\\n"
  668. " // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\\n"
  669. " // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  670. format("int a; // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\\n"
  671. " // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\\n"
  672. " // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  673. getLLVMStyleWithColumns(50)));
  674. // FIXME: One day we might want to implement adjustment of leading whitespace
  675. // of the consecutive lines in this kind of comment:
  676. EXPECT_EQ("double\n"
  677. " a; // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\\n"
  678. " // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\\n"
  679. " // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  680. format("double a; // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\\n"
  681. " // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\\\n"
  682. " // AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  683. getLLVMStyleWithColumns(49)));
  684. }
  685. TEST_F(FormatTestComments, DontSplitLineCommentsWithPragmas) {
  686. FormatStyle Pragmas = getLLVMStyleWithColumns(30);
  687. Pragmas.CommentPragmas = "^ IWYU pragma:";
  688. EXPECT_EQ(
  689. "// IWYU pragma: aaaaaaaaaaaaaaaaaa bbbbbbbbbbbbbb",
  690. format("// IWYU pragma: aaaaaaaaaaaaaaaaaa bbbbbbbbbbbbbb", Pragmas));
  691. EXPECT_EQ(
  692. "/* IWYU pragma: aaaaaaaaaaaaaaaaaa bbbbbbbbbbbbbb */",
  693. format("/* IWYU pragma: aaaaaaaaaaaaaaaaaa bbbbbbbbbbbbbb */", Pragmas));
  694. }
  695. TEST_F(FormatTestComments, PriorityOfCommentBreaking) {
  696. EXPECT_EQ("if (xxx ==\n"
  697. " yyy && // aaaaaaaaaaaa bbbbbbbbb\n"
  698. " zzz)\n"
  699. " q();",
  700. format("if (xxx == yyy && // aaaaaaaaaaaa bbbbbbbbb\n"
  701. " zzz) q();",
  702. getLLVMStyleWithColumns(40)));
  703. EXPECT_EQ("if (xxxxxxxxxx ==\n"
  704. " yyy && // aaaaaa bbbbbbbb cccc\n"
  705. " zzz)\n"
  706. " q();",
  707. format("if (xxxxxxxxxx == yyy && // aaaaaa bbbbbbbb cccc\n"
  708. " zzz) q();",
  709. getLLVMStyleWithColumns(40)));
  710. EXPECT_EQ("if (xxxxxxxxxx &&\n"
  711. " yyy || // aaaaaa bbbbbbbb cccc\n"
  712. " zzz)\n"
  713. " q();",
  714. format("if (xxxxxxxxxx && yyy || // aaaaaa bbbbbbbb cccc\n"
  715. " zzz) q();",
  716. getLLVMStyleWithColumns(40)));
  717. EXPECT_EQ("fffffffff(\n"
  718. " &xxx, // aaaaaaaaaaaa bbbbbbbbbbb\n"
  719. " zzz);",
  720. format("fffffffff(&xxx, // aaaaaaaaaaaa bbbbbbbbbbb\n"
  721. " zzz);",
  722. getLLVMStyleWithColumns(40)));
  723. }
  724. TEST_F(FormatTestComments, MultiLineCommentsInDefines) {
  725. EXPECT_EQ("#define A(x) /* \\\n"
  726. " a comment \\\n"
  727. " inside */ \\\n"
  728. " f();",
  729. format("#define A(x) /* \\\n"
  730. " a comment \\\n"
  731. " inside */ \\\n"
  732. " f();",
  733. getLLVMStyleWithColumns(17)));
  734. EXPECT_EQ("#define A( \\\n"
  735. " x) /* \\\n"
  736. " a comment \\\n"
  737. " inside */ \\\n"
  738. " f();",
  739. format("#define A( \\\n"
  740. " x) /* \\\n"
  741. " a comment \\\n"
  742. " inside */ \\\n"
  743. " f();",
  744. getLLVMStyleWithColumns(17)));
  745. }
  746. TEST_F(FormatTestComments, ParsesCommentsAdjacentToPPDirectives) {
  747. EXPECT_EQ("namespace {}\n// Test\n#define A",
  748. format("namespace {}\n // Test\n#define A"));
  749. EXPECT_EQ("namespace {}\n/* Test */\n#define A",
  750. format("namespace {}\n /* Test */\n#define A"));
  751. EXPECT_EQ("namespace {}\n/* Test */ #define A",
  752. format("namespace {}\n /* Test */ #define A"));
  753. }
  754. TEST_F(FormatTestComments, KeepsLevelOfCommentBeforePPDirective) {
  755. // Keep the current level if the comment was originally not aligned with
  756. // the preprocessor directive.
  757. EXPECT_EQ("void f() {\n"
  758. " int i;\n"
  759. " /* comment */\n"
  760. "#ifdef A\n"
  761. " int j;\n"
  762. "}",
  763. format("void f() {\n"
  764. " int i;\n"
  765. " /* comment */\n"
  766. "#ifdef A\n"
  767. " int j;\n"
  768. "}"));
  769. EXPECT_EQ("void f() {\n"
  770. " int i;\n"
  771. " /* comment */\n"
  772. "\n"
  773. "#ifdef A\n"
  774. " int j;\n"
  775. "}",
  776. format("void f() {\n"
  777. " int i;\n"
  778. " /* comment */\n"
  779. "\n"
  780. "#ifdef A\n"
  781. " int j;\n"
  782. "}"));
  783. EXPECT_EQ("int f(int i) {\n"
  784. " if (true) {\n"
  785. " ++i;\n"
  786. " }\n"
  787. " // comment\n"
  788. "#ifdef A\n"
  789. " int j;\n"
  790. "#endif\n"
  791. "}",
  792. format("int f(int i) {\n"
  793. " if (true) {\n"
  794. " ++i;\n"
  795. " }\n"
  796. " // comment\n"
  797. "#ifdef A\n"
  798. "int j;\n"
  799. "#endif\n"
  800. "}"));
  801. EXPECT_EQ("int f(int i) {\n"
  802. " if (true) {\n"
  803. " i++;\n"
  804. " } else {\n"
  805. " // comment in else\n"
  806. "#ifdef A\n"
  807. " j++;\n"
  808. "#endif\n"
  809. " }\n"
  810. "}",
  811. format("int f(int i) {\n"
  812. " if (true) {\n"
  813. " i++;\n"
  814. " } else {\n"
  815. " // comment in else\n"
  816. "#ifdef A\n"
  817. " j++;\n"
  818. "#endif\n"
  819. " }\n"
  820. "}"));
  821. EXPECT_EQ("int f(int i) {\n"
  822. " if (true) {\n"
  823. " i++;\n"
  824. " } else {\n"
  825. " /* comment in else */\n"
  826. "#ifdef A\n"
  827. " j++;\n"
  828. "#endif\n"
  829. " }\n"
  830. "}",
  831. format("int f(int i) {\n"
  832. " if (true) {\n"
  833. " i++;\n"
  834. " } else {\n"
  835. " /* comment in else */\n"
  836. "#ifdef A\n"
  837. " j++;\n"
  838. "#endif\n"
  839. " }\n"
  840. "}"));
  841. // Keep the current level if there is an empty line between the comment and
  842. // the preprocessor directive.
  843. EXPECT_EQ("void f() {\n"
  844. " int i;\n"
  845. " /* comment */\n"
  846. "\n"
  847. "#ifdef A\n"
  848. " int j;\n"
  849. "}",
  850. format("void f() {\n"
  851. " int i;\n"
  852. "/* comment */\n"
  853. "\n"
  854. "#ifdef A\n"
  855. " int j;\n"
  856. "}"));
  857. EXPECT_EQ("void f() {\n"
  858. " int i;\n"
  859. " return i;\n"
  860. "}\n"
  861. "// comment\n"
  862. "\n"
  863. "#ifdef A\n"
  864. "int i;\n"
  865. "#endif // A",
  866. format("void f() {\n"
  867. " int i;\n"
  868. " return i;\n"
  869. "}\n"
  870. "// comment\n"
  871. "\n"
  872. "#ifdef A\n"
  873. "int i;\n"
  874. "#endif // A"));
  875. EXPECT_EQ("int f(int i) {\n"
  876. " if (true) {\n"
  877. " ++i;\n"
  878. " }\n"
  879. " // comment\n"
  880. "\n"
  881. "#ifdef A\n"
  882. " int j;\n"
  883. "#endif\n"
  884. "}",
  885. format("int f(int i) {\n"
  886. " if (true) {\n"
  887. " ++i;\n"
  888. " }\n"
  889. " // comment\n"
  890. "\n"
  891. "#ifdef A\n"
  892. " int j;\n"
  893. "#endif\n"
  894. "}"));
  895. EXPECT_EQ("int f(int i) {\n"
  896. " if (true) {\n"
  897. " i++;\n"
  898. " } else {\n"
  899. " // comment in else\n"
  900. "\n"
  901. "#ifdef A\n"
  902. " j++;\n"
  903. "#endif\n"
  904. " }\n"
  905. "}",
  906. format("int f(int i) {\n"
  907. " if (true) {\n"
  908. " i++;\n"
  909. " } else {\n"
  910. "// comment in else\n"
  911. "\n"
  912. "#ifdef A\n"
  913. " j++;\n"
  914. "#endif\n"
  915. " }\n"
  916. "}"));
  917. EXPECT_EQ("int f(int i) {\n"
  918. " if (true) {\n"
  919. " i++;\n"
  920. " } else {\n"
  921. " /* comment in else */\n"
  922. "\n"
  923. "#ifdef A\n"
  924. " j++;\n"
  925. "#endif\n"
  926. " }\n"
  927. "}",
  928. format("int f(int i) {\n"
  929. " if (true) {\n"
  930. " i++;\n"
  931. " } else {\n"
  932. "/* comment in else */\n"
  933. "\n"
  934. "#ifdef A\n"
  935. " j++;\n"
  936. "#endif\n"
  937. " }\n"
  938. "}"));
  939. // Align with the preprocessor directive if the comment was originally aligned
  940. // with the preprocessor directive and there is no newline between the comment
  941. // and the preprocessor directive.
  942. EXPECT_EQ("void f() {\n"
  943. " int i;\n"
  944. "/* comment */\n"
  945. "#ifdef A\n"
  946. " int j;\n"
  947. "}",
  948. format("void f() {\n"
  949. " int i;\n"
  950. "/* comment */\n"
  951. "#ifdef A\n"
  952. " int j;\n"
  953. "}"));
  954. EXPECT_EQ("int f(int i) {\n"
  955. " if (true) {\n"
  956. " ++i;\n"
  957. " }\n"
  958. "// comment\n"
  959. "#ifdef A\n"
  960. " int j;\n"
  961. "#endif\n"
  962. "}",
  963. format("int f(int i) {\n"
  964. " if (true) {\n"
  965. " ++i;\n"
  966. " }\n"
  967. "// comment\n"
  968. "#ifdef A\n"
  969. " int j;\n"
  970. "#endif\n"
  971. "}"));
  972. EXPECT_EQ("int f(int i) {\n"
  973. " if (true) {\n"
  974. " i++;\n"
  975. " } else {\n"
  976. "// comment in else\n"
  977. "#ifdef A\n"
  978. " j++;\n"
  979. "#endif\n"
  980. " }\n"
  981. "}",
  982. format("int f(int i) {\n"
  983. " if (true) {\n"
  984. " i++;\n"
  985. " } else {\n"
  986. " // comment in else\n"
  987. " #ifdef A\n"
  988. " j++;\n"
  989. "#endif\n"
  990. " }\n"
  991. "}"));
  992. EXPECT_EQ("int f(int i) {\n"
  993. " if (true) {\n"
  994. " i++;\n"
  995. " } else {\n"
  996. "/* comment in else */\n"
  997. "#ifdef A\n"
  998. " j++;\n"
  999. "#endif\n"
  1000. " }\n"
  1001. "}",
  1002. format("int f(int i) {\n"
  1003. " if (true) {\n"
  1004. " i++;\n"
  1005. " } else {\n"
  1006. " /* comment in else */\n"
  1007. " #ifdef A\n"
  1008. " j++;\n"
  1009. "#endif\n"
  1010. " }\n"
  1011. "}"));
  1012. }
  1013. TEST_F(FormatTestComments, SplitsLongLinesInComments) {
  1014. EXPECT_EQ("/* This is a long\n"
  1015. " * comment that\n"
  1016. " * doesn't\n"
  1017. " * fit on one line.\n"
  1018. " */",
  1019. format("/* "
  1020. "This is a long "
  1021. "comment that "
  1022. "doesn't "
  1023. "fit on one line. */",
  1024. getLLVMStyleWithColumns(20)));
  1025. EXPECT_EQ(
  1026. "/* a b c d\n"
  1027. " * e f g\n"
  1028. " * h i j k\n"
  1029. " */",
  1030. format("/* a b c d e f g h i j k */", getLLVMStyleWithColumns(10)));
  1031. EXPECT_EQ(
  1032. "/* a b c d\n"
  1033. " * e f g\n"
  1034. " * h i j k\n"
  1035. " */",
  1036. format("\\\n/* a b c d e f g h i j k */", getLLVMStyleWithColumns(10)));
  1037. EXPECT_EQ("/*\n"
  1038. "This is a long\n"
  1039. "comment that doesn't\n"
  1040. "fit on one line.\n"
  1041. "*/",
  1042. format("/*\n"
  1043. "This is a long "
  1044. "comment that doesn't "
  1045. "fit on one line. \n"
  1046. "*/",
  1047. getLLVMStyleWithColumns(20)));
  1048. EXPECT_EQ("/*\n"
  1049. " * This is a long\n"
  1050. " * comment that\n"
  1051. " * doesn't fit on\n"
  1052. " * one line.\n"
  1053. " */",
  1054. format("/* \n"
  1055. " * This is a long "
  1056. " comment that "
  1057. " doesn't fit on "
  1058. " one line. \n"
  1059. " */",
  1060. getLLVMStyleWithColumns(20)));
  1061. EXPECT_EQ("/*\n"
  1062. " * This_is_a_comment_with_words_that_dont_fit_on_one_line\n"
  1063. " * so_it_should_be_broken\n"
  1064. " * wherever_a_space_occurs\n"
  1065. " */",
  1066. format("/*\n"
  1067. " * This_is_a_comment_with_words_that_dont_fit_on_one_line "
  1068. " so_it_should_be_broken "
  1069. " wherever_a_space_occurs \n"
  1070. " */",
  1071. getLLVMStyleWithColumns(20)));
  1072. EXPECT_EQ("/*\n"
  1073. " * This_comment_can_not_be_broken_into_lines\n"
  1074. " */",
  1075. format("/*\n"
  1076. " * This_comment_can_not_be_broken_into_lines\n"
  1077. " */",
  1078. getLLVMStyleWithColumns(20)));
  1079. EXPECT_EQ("{\n"
  1080. " /*\n"
  1081. " This is another\n"
  1082. " long comment that\n"
  1083. " doesn't fit on one\n"
  1084. " line 1234567890\n"
  1085. " */\n"
  1086. "}",
  1087. format("{\n"
  1088. "/*\n"
  1089. "This is another "
  1090. " long comment that "
  1091. " doesn't fit on one"
  1092. " line 1234567890\n"
  1093. "*/\n"
  1094. "}",
  1095. getLLVMStyleWithColumns(20)));
  1096. EXPECT_EQ("{\n"
  1097. " /*\n"
  1098. " * This i s\n"
  1099. " * another comment\n"
  1100. " * t hat doesn' t\n"
  1101. " * fit on one l i\n"
  1102. " * n e\n"
  1103. " */\n"
  1104. "}",
  1105. format("{\n"
  1106. "/*\n"
  1107. " * This i s"
  1108. " another comment"
  1109. " t hat doesn' t"
  1110. " fit on one l i"
  1111. " n e\n"
  1112. " */\n"
  1113. "}",
  1114. getLLVMStyleWithColumns(20)));
  1115. EXPECT_EQ("/*\n"
  1116. " * This is a long\n"
  1117. " * comment that\n"
  1118. " * doesn't fit on\n"
  1119. " * one line\n"
  1120. " */",
  1121. format(" /*\n"
  1122. " * This is a long comment that doesn't fit on one line\n"
  1123. " */",
  1124. getLLVMStyleWithColumns(20)));
  1125. EXPECT_EQ("{\n"
  1126. " if (something) /* This is a\n"
  1127. " long\n"
  1128. " comment */\n"
  1129. " ;\n"
  1130. "}",
  1131. format("{\n"
  1132. " if (something) /* This is a long comment */\n"
  1133. " ;\n"
  1134. "}",
  1135. getLLVMStyleWithColumns(30)));
  1136. EXPECT_EQ("/* A comment before\n"
  1137. " * a macro\n"
  1138. " * definition */\n"
  1139. "#define a b",
  1140. format("/* A comment before a macro definition */\n"
  1141. "#define a b",
  1142. getLLVMStyleWithColumns(20)));
  1143. EXPECT_EQ("/* some comment\n"
  1144. " * a comment that\n"
  1145. " * we break another\n"
  1146. " * comment we have\n"
  1147. " * to break a left\n"
  1148. " * comment\n"
  1149. " */",
  1150. format(" /* some comment\n"
  1151. " * a comment that we break\n"
  1152. " * another comment we have to break\n"
  1153. "* a left comment\n"
  1154. " */",
  1155. getLLVMStyleWithColumns(20)));
  1156. EXPECT_EQ("/**\n"
  1157. " * multiline block\n"
  1158. " * comment\n"
  1159. " *\n"
  1160. " */",
  1161. format("/**\n"
  1162. " * multiline block comment\n"
  1163. " *\n"
  1164. " */",
  1165. getLLVMStyleWithColumns(20)));
  1166. EXPECT_EQ("/*\n"
  1167. "\n"
  1168. "\n"
  1169. " */\n",
  1170. format(" /* \n"
  1171. " \n"
  1172. " \n"
  1173. " */\n"));
  1174. EXPECT_EQ("/* a a */",
  1175. format("/* a a */", getLLVMStyleWithColumns(15)));
  1176. EXPECT_EQ("/* a a bc */",
  1177. format("/* a a bc */", getLLVMStyleWithColumns(15)));
  1178. EXPECT_EQ("/* aaa aaa\n"
  1179. " * aaaaa */",
  1180. format("/* aaa aaa aaaaa */", getLLVMStyleWithColumns(15)));
  1181. EXPECT_EQ("/* aaa aaa\n"
  1182. " * aaaaa */",
  1183. format("/* aaa aaa aaaaa */", getLLVMStyleWithColumns(15)));
  1184. }
  1185. TEST_F(FormatTestComments, SplitsLongLinesInCommentsInPreprocessor) {
  1186. EXPECT_EQ("#define X \\\n"
  1187. " /* \\\n"
  1188. " Test \\\n"
  1189. " Macro comment \\\n"
  1190. " with a long \\\n"
  1191. " line \\\n"
  1192. " */ \\\n"
  1193. " A + B",
  1194. format("#define X \\\n"
  1195. " /*\n"
  1196. " Test\n"
  1197. " Macro comment with a long line\n"
  1198. " */ \\\n"
  1199. " A + B",
  1200. getLLVMStyleWithColumns(20)));
  1201. EXPECT_EQ("#define X \\\n"
  1202. " /* Macro comment \\\n"
  1203. " with a long \\\n"
  1204. " line */ \\\n"
  1205. " A + B",
  1206. format("#define X \\\n"
  1207. " /* Macro comment with a long\n"
  1208. " line */ \\\n"
  1209. " A + B",
  1210. getLLVMStyleWithColumns(20)));
  1211. EXPECT_EQ("#define X \\\n"
  1212. " /* Macro comment \\\n"
  1213. " * with a long \\\n"
  1214. " * line */ \\\n"
  1215. " A + B",
  1216. format("#define X \\\n"
  1217. " /* Macro comment with a long line */ \\\n"
  1218. " A + B",
  1219. getLLVMStyleWithColumns(20)));
  1220. }
  1221. TEST_F(FormatTestComments, KeepsTrailingPPCommentsAndSectionCommentsSeparate) {
  1222. verifyFormat("#ifdef A // line about A\n"
  1223. "// section comment\n"
  1224. "#endif",
  1225. getLLVMStyleWithColumns(80));
  1226. verifyFormat("#ifdef A // line 1 about A\n"
  1227. " // line 2 about A\n"
  1228. "// section comment\n"
  1229. "#endif",
  1230. getLLVMStyleWithColumns(80));
  1231. EXPECT_EQ("#ifdef A // line 1 about A\n"
  1232. " // line 2 about A\n"
  1233. "// section comment\n"
  1234. "#endif",
  1235. format("#ifdef A // line 1 about A\n"
  1236. " // line 2 about A\n"
  1237. "// section comment\n"
  1238. "#endif",
  1239. getLLVMStyleWithColumns(80)));
  1240. verifyFormat("int f() {\n"
  1241. " int i;\n"
  1242. "#ifdef A // comment about A\n"
  1243. " // section comment 1\n"
  1244. " // section comment 2\n"
  1245. " i = 2;\n"
  1246. "#else // comment about #else\n"
  1247. " // section comment 3\n"
  1248. " i = 4;\n"
  1249. "#endif\n"
  1250. "}", getLLVMStyleWithColumns(80));
  1251. }
  1252. TEST_F(FormatTestComments, AlignsPPElseEndifComments) {
  1253. verifyFormat("#if A\n"
  1254. "#else // A\n"
  1255. "int iiii;\n"
  1256. "#endif // B",
  1257. getLLVMStyleWithColumns(20));
  1258. verifyFormat("#if A\n"
  1259. "#else // A\n"
  1260. "int iiii; // CC\n"
  1261. "#endif // B",
  1262. getLLVMStyleWithColumns(20));
  1263. EXPECT_EQ("#if A\n"
  1264. "#else // A1\n"
  1265. " // A2\n"
  1266. "int ii;\n"
  1267. "#endif // B",
  1268. format("#if A\n"
  1269. "#else // A1\n"
  1270. " // A2\n"
  1271. "int ii;\n"
  1272. "#endif // B",
  1273. getLLVMStyleWithColumns(20)));
  1274. }
  1275. TEST_F(FormatTestComments, CommentsInStaticInitializers) {
  1276. EXPECT_EQ(
  1277. "static SomeType type = {aaaaaaaaaaaaaaaaaaaa, /* comment */\n"
  1278. " aaaaaaaaaaaaaaaaaaaa /* comment */,\n"
  1279. " /* comment */ aaaaaaaaaaaaaaaaaaaa,\n"
  1280. " aaaaaaaaaaaaaaaaaaaa, // comment\n"
  1281. " aaaaaaaaaaaaaaaaaaaa};",
  1282. format("static SomeType type = { aaaaaaaaaaaaaaaaaaaa , /* comment */\n"
  1283. " aaaaaaaaaaaaaaaaaaaa /* comment */ ,\n"
  1284. " /* comment */ aaaaaaaaaaaaaaaaaaaa ,\n"
  1285. " aaaaaaaaaaaaaaaaaaaa , // comment\n"
  1286. " aaaaaaaaaaaaaaaaaaaa };"));
  1287. verifyFormat("static SomeType type = {aaaaaaaaaaa, // comment for aa...\n"
  1288. " bbbbbbbbbbb, ccccccccccc};");
  1289. verifyFormat("static SomeType type = {aaaaaaaaaaa,\n"
  1290. " // comment for bb....\n"
  1291. " bbbbbbbbbbb, ccccccccccc};");
  1292. verifyGoogleFormat(
  1293. "static SomeType type = {aaaaaaaaaaa, // comment for aa...\n"
  1294. " bbbbbbbbbbb, ccccccccccc};");
  1295. verifyGoogleFormat("static SomeType type = {aaaaaaaaaaa,\n"
  1296. " // comment for bb....\n"
  1297. " bbbbbbbbbbb, ccccccccccc};");
  1298. verifyFormat("S s = {{a, b, c}, // Group #1\n"
  1299. " {d, e, f}, // Group #2\n"
  1300. " {g, h, i}}; // Group #3");
  1301. verifyFormat("S s = {{// Group #1\n"
  1302. " a, b, c},\n"
  1303. " {// Group #2\n"
  1304. " d, e, f},\n"
  1305. " {// Group #3\n"
  1306. " g, h, i}};");
  1307. EXPECT_EQ("S s = {\n"
  1308. " // Some comment\n"
  1309. " a,\n"
  1310. "\n"
  1311. " // Comment after empty line\n"
  1312. " b}",
  1313. format("S s = {\n"
  1314. " // Some comment\n"
  1315. " a,\n"
  1316. " \n"
  1317. " // Comment after empty line\n"
  1318. " b\n"
  1319. "}"));
  1320. EXPECT_EQ("S s = {\n"
  1321. " /* Some comment */\n"
  1322. " a,\n"
  1323. "\n"
  1324. " /* Comment after empty line */\n"
  1325. " b}",
  1326. format("S s = {\n"
  1327. " /* Some comment */\n"
  1328. " a,\n"
  1329. " \n"
  1330. " /* Comment after empty line */\n"
  1331. " b\n"
  1332. "}"));
  1333. verifyFormat("const uint8_t aaaaaaaaaaaaaaaaaaaaaa[0] = {\n"
  1334. " 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // comment\n"
  1335. " 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // comment\n"
  1336. " 0x00, 0x00, 0x00, 0x00}; // comment\n");
  1337. }
  1338. TEST_F(FormatTestComments, LineCommentsAfterRightBrace) {
  1339. EXPECT_EQ("if (true) { // comment about branch\n"
  1340. " // comment about f\n"
  1341. " f();\n"
  1342. "}",
  1343. format("if (true) { // comment about branch\n"
  1344. " // comment about f\n"
  1345. " f();\n"
  1346. "}",
  1347. getLLVMStyleWithColumns(80)));
  1348. EXPECT_EQ("if (1) { // if line 1\n"
  1349. " // if line 2\n"
  1350. " // if line 3\n"
  1351. " // f line 1\n"
  1352. " // f line 2\n"
  1353. " f();\n"
  1354. "} else { // else line 1\n"
  1355. " // else line 2\n"
  1356. " // else line 3\n"
  1357. " // g line 1\n"
  1358. " g();\n"
  1359. "}",
  1360. format("if (1) { // if line 1\n"
  1361. " // if line 2\n"
  1362. " // if line 3\n"
  1363. " // f line 1\n"
  1364. " // f line 2\n"
  1365. " f();\n"
  1366. "} else { // else line 1\n"
  1367. " // else line 2\n"
  1368. " // else line 3\n"
  1369. " // g line 1\n"
  1370. " g();\n"
  1371. "}"));
  1372. EXPECT_EQ("do { // line 1\n"
  1373. " // line 2\n"
  1374. " // line 3\n"
  1375. " f();\n"
  1376. "} while (true);",
  1377. format("do { // line 1\n"
  1378. " // line 2\n"
  1379. " // line 3\n"
  1380. " f();\n"
  1381. "} while (true);",
  1382. getLLVMStyleWithColumns(80)));
  1383. EXPECT_EQ("while (a < b) { // line 1\n"
  1384. " // line 2\n"
  1385. " // line 3\n"
  1386. " f();\n"
  1387. "}",
  1388. format("while (a < b) {// line 1\n"
  1389. " // line 2\n"
  1390. " // line 3\n"
  1391. " f();\n"
  1392. "}",
  1393. getLLVMStyleWithColumns(80)));
  1394. }
  1395. TEST_F(FormatTestComments, ReflowsComments) {
  1396. // Break a long line and reflow with the full next line.
  1397. EXPECT_EQ("// long long long\n"
  1398. "// long long",
  1399. format("// long long long long\n"
  1400. "// long",
  1401. getLLVMStyleWithColumns(20)));
  1402. // Keep the trailing newline while reflowing.
  1403. EXPECT_EQ("// long long long\n"
  1404. "// long long\n",
  1405. format("// long long long long\n"
  1406. "// long\n",
  1407. getLLVMStyleWithColumns(20)));
  1408. // Break a long line and reflow with a part of the next line.
  1409. EXPECT_EQ("// long long long\n"
  1410. "// long long\n"
  1411. "// long_long",
  1412. format("// long long long long\n"
  1413. "// long long_long",
  1414. getLLVMStyleWithColumns(20)));
  1415. // Break but do not reflow if the first word from the next line is too long.
  1416. EXPECT_EQ("// long long long\n"
  1417. "// long\n"
  1418. "// long_long_long\n",
  1419. format("// long long long long\n"
  1420. "// long_long_long\n",
  1421. getLLVMStyleWithColumns(20)));
  1422. // Don't break or reflow short lines.
  1423. verifyFormat("// long\n"
  1424. "// long long long lo\n"
  1425. "// long long long lo\n"
  1426. "// long",
  1427. getLLVMStyleWithColumns(20));
  1428. // Keep prefixes and decorations while reflowing.
  1429. EXPECT_EQ("/// long long long\n"
  1430. "/// long long\n",
  1431. format("/// long long long long\n"
  1432. "/// long\n",
  1433. getLLVMStyleWithColumns(20)));
  1434. EXPECT_EQ("//! long long long\n"
  1435. "//! long long\n",
  1436. format("//! long long long long\n"
  1437. "//! long\n",
  1438. getLLVMStyleWithColumns(20)));
  1439. EXPECT_EQ("/* long long long\n"
  1440. " * long long */",
  1441. format("/* long long long long\n"
  1442. " * long */",
  1443. getLLVMStyleWithColumns(20)));
  1444. EXPECT_EQ("///< long long long\n"
  1445. "///< long long\n",
  1446. format("///< long long long long\n"
  1447. "///< long\n",
  1448. getLLVMStyleWithColumns(20)));
  1449. EXPECT_EQ("//!< long long long\n"
  1450. "//!< long long\n",
  1451. format("//!< long long long long\n"
  1452. "//!< long\n",
  1453. getLLVMStyleWithColumns(20)));
  1454. // Don't bring leading whitespace up while reflowing.
  1455. EXPECT_EQ("/* long long long\n"
  1456. " * long long long\n"
  1457. " */",
  1458. format("/* long long long long\n"
  1459. " * long long\n"
  1460. " */",
  1461. getLLVMStyleWithColumns(20)));
  1462. // Reflow the last line of a block comment with its trailing '*/'.
  1463. EXPECT_EQ("/* long long long\n"
  1464. " long long */",
  1465. format("/* long long long long\n"
  1466. " long */",
  1467. getLLVMStyleWithColumns(20)));
  1468. // Reflow two short lines; keep the postfix of the last one.
  1469. EXPECT_EQ("/* long long long\n"
  1470. " * long long long */",
  1471. format("/* long long long long\n"
  1472. " * long\n"
  1473. " * long */",
  1474. getLLVMStyleWithColumns(20)));
  1475. // Put the postfix of the last short reflow line on a newline if it doesn't
  1476. // fit.
  1477. EXPECT_EQ("/* long long long\n"
  1478. " * long long longg\n"
  1479. " */",
  1480. format("/* long long long long\n"
  1481. " * long\n"
  1482. " * longg */",
  1483. getLLVMStyleWithColumns(20)));
  1484. // Reflow lines with leading whitespace.
  1485. EXPECT_EQ("{\n"
  1486. " /*\n"
  1487. " * long long long\n"
  1488. " * long long long\n"
  1489. " * long long long\n"
  1490. " */\n"
  1491. "}",
  1492. format("{\n"
  1493. "/*\n"
  1494. " * long long long long\n"
  1495. " * long\n"
  1496. " * long long long long\n"
  1497. " */\n"
  1498. "}",
  1499. getLLVMStyleWithColumns(20)));
  1500. // Break single line block comments that are first in the line with ' *'
  1501. // decoration.
  1502. EXPECT_EQ("/* long long long\n"
  1503. " * long */",
  1504. format("/* long long long long */", getLLVMStyleWithColumns(20)));
  1505. // Break single line block comment that are not first in the line with ' '
  1506. // decoration.
  1507. EXPECT_EQ("int i; /* long long\n"
  1508. " long */",
  1509. format("int i; /* long long long */", getLLVMStyleWithColumns(20)));
  1510. // Reflow a line that goes just over the column limit.
  1511. EXPECT_EQ("// long long long\n"
  1512. "// lon long",
  1513. format("// long long long lon\n"
  1514. "// long",
  1515. getLLVMStyleWithColumns(20)));
  1516. // Stop reflowing if the next line has a different indentation than the
  1517. // previous line.
  1518. EXPECT_EQ("// long long long\n"
  1519. "// long\n"
  1520. "// long long\n"
  1521. "// long",
  1522. format("// long long long long\n"
  1523. "// long long\n"
  1524. "// long",
  1525. getLLVMStyleWithColumns(20)));
  1526. // Reflow into the last part of a really long line that has been broken into
  1527. // multiple lines.
  1528. EXPECT_EQ("// long long long\n"
  1529. "// long long long\n"
  1530. "// long long long\n",
  1531. format("// long long long long long long long long\n"
  1532. "// long\n",
  1533. getLLVMStyleWithColumns(20)));
  1534. // Break the first line, then reflow the beginning of the second and third
  1535. // line up.
  1536. EXPECT_EQ("// long long long\n"
  1537. "// lon1 lon2 lon2\n"
  1538. "// lon2 lon3 lon3",
  1539. format("// long long long lon1\n"
  1540. "// lon2 lon2 lon2\n"
  1541. "// lon3 lon3",
  1542. getLLVMStyleWithColumns(20)));
  1543. // Reflow the beginning of the second line, then break the rest.
  1544. EXPECT_EQ("// long long long\n"
  1545. "// lon1 lon2 lon2\n"
  1546. "// lon2 lon2 lon2\n"
  1547. "// lon3",
  1548. format("// long long long lon1\n"
  1549. "// lon2 lon2 lon2 lon2 lon2 lon3",
  1550. getLLVMStyleWithColumns(20)));
  1551. // Shrink the first line, then reflow the second line up.
  1552. EXPECT_EQ("// long long long", format("// long long\n"
  1553. "// long",
  1554. getLLVMStyleWithColumns(20)));
  1555. // Don't shrink leading whitespace.
  1556. EXPECT_EQ("int i; /// a",
  1557. format("int i; /// a", getLLVMStyleWithColumns(20)));
  1558. // Shrink trailing whitespace if there is no postfix and reflow.
  1559. EXPECT_EQ("// long long long\n"
  1560. "// long long",
  1561. format("// long long long long \n"
  1562. "// long",
  1563. getLLVMStyleWithColumns(20)));
  1564. // Shrink trailing whitespace to a single one if there is postfix.
  1565. EXPECT_EQ("/* long long long */",
  1566. format("/* long long long */", getLLVMStyleWithColumns(20)));
  1567. // Break a block comment postfix if exceeding the line limit.
  1568. EXPECT_EQ("/* long\n"
  1569. " */",
  1570. format("/* long */", getLLVMStyleWithColumns(20)));
  1571. // Reflow indented comments.
  1572. EXPECT_EQ("{\n"
  1573. " // long long long\n"
  1574. " // long long\n"
  1575. " int i; /* long lon\n"
  1576. " g long\n"
  1577. " */\n"
  1578. "}",
  1579. format("{\n"
  1580. " // long long long long\n"
  1581. " // long\n"
  1582. " int i; /* long lon g\n"
  1583. " long */\n"
  1584. "}",
  1585. getLLVMStyleWithColumns(20)));
  1586. // Don't realign trailing comments after reflow has happened.
  1587. EXPECT_EQ("// long long long\n"
  1588. "// long long\n"
  1589. "long i; // long",
  1590. format("// long long long long\n"
  1591. "// long\n"
  1592. "long i; // long",
  1593. getLLVMStyleWithColumns(20)));
  1594. EXPECT_EQ("// long long long\n"
  1595. "// longng long long\n"
  1596. "// long lo",
  1597. format("// long long long longng\n"
  1598. "// long long long\n"
  1599. "// lo",
  1600. getLLVMStyleWithColumns(20)));
  1601. // Reflow lines after a broken line.
  1602. EXPECT_EQ("int a; // Trailing\n"
  1603. " // comment on\n"
  1604. " // 2 or 3\n"
  1605. " // lines.\n",
  1606. format("int a; // Trailing comment\n"
  1607. " // on 2\n"
  1608. " // or 3\n"
  1609. " // lines.\n",
  1610. getLLVMStyleWithColumns(20)));
  1611. EXPECT_EQ("/// This long line\n"
  1612. "/// gets reflown.\n",
  1613. format("/// This long line gets\n"
  1614. "/// reflown.\n",
  1615. getLLVMStyleWithColumns(20)));
  1616. EXPECT_EQ("//! This long line\n"
  1617. "//! gets reflown.\n",
  1618. format(" //! This long line gets\n"
  1619. " //! reflown.\n",
  1620. getLLVMStyleWithColumns(20)));
  1621. EXPECT_EQ("/* This long line\n"
  1622. " * gets reflown.\n"
  1623. " */\n",
  1624. format("/* This long line gets\n"
  1625. " * reflown.\n"
  1626. " */\n",
  1627. getLLVMStyleWithColumns(20)));
  1628. // Reflow after indentation makes a line too long.
  1629. EXPECT_EQ("{\n"
  1630. " // long long long\n"
  1631. " // lo long\n"
  1632. "}\n",
  1633. format("{\n"
  1634. "// long long long lo\n"
  1635. "// long\n"
  1636. "}\n",
  1637. getLLVMStyleWithColumns(20)));
  1638. // Break and reflow multiple lines.
  1639. EXPECT_EQ("/*\n"
  1640. " * Reflow the end of\n"
  1641. " * line by 11 22 33\n"
  1642. " * 4.\n"
  1643. " */\n",
  1644. format("/*\n"
  1645. " * Reflow the end of line\n"
  1646. " * by\n"
  1647. " * 11\n"
  1648. " * 22\n"
  1649. " * 33\n"
  1650. " * 4.\n"
  1651. " */\n",
  1652. getLLVMStyleWithColumns(20)));
  1653. EXPECT_EQ("/// First line gets\n"
  1654. "/// broken. Second\n"
  1655. "/// line gets\n"
  1656. "/// reflown and\n"
  1657. "/// broken. Third\n"
  1658. "/// gets reflown.\n",
  1659. format("/// First line gets broken.\n"
  1660. "/// Second line gets reflown and broken.\n"
  1661. "/// Third gets reflown.\n",
  1662. getLLVMStyleWithColumns(20)));
  1663. EXPECT_EQ("int i; // first long\n"
  1664. " // long snd\n"
  1665. " // long.\n",
  1666. format("int i; // first long long\n"
  1667. " // snd long.\n",
  1668. getLLVMStyleWithColumns(20)));
  1669. EXPECT_EQ("{\n"
  1670. " // first long line\n"
  1671. " // line second\n"
  1672. " // long line line\n"
  1673. " // third long line\n"
  1674. " // line\n"
  1675. "}\n",
  1676. format("{\n"
  1677. " // first long line line\n"
  1678. " // second long line line\n"
  1679. " // third long line line\n"
  1680. "}\n",
  1681. getLLVMStyleWithColumns(20)));
  1682. EXPECT_EQ("int i; /* first line\n"
  1683. " * second\n"
  1684. " * line third\n"
  1685. " * line\n"
  1686. " */",
  1687. format("int i; /* first line\n"
  1688. " * second line\n"
  1689. " * third line\n"
  1690. " */",
  1691. getLLVMStyleWithColumns(20)));
  1692. // Reflow the last two lines of a section that starts with a line having
  1693. // different indentation.
  1694. EXPECT_EQ(
  1695. "// long\n"
  1696. "// long long long\n"
  1697. "// long long",
  1698. format("// long\n"
  1699. "// long long long long\n"
  1700. "// long",
  1701. getLLVMStyleWithColumns(20)));
  1702. // Keep the block comment endling '*/' while reflowing.
  1703. EXPECT_EQ("/* Long long long\n"
  1704. " * line short */\n",
  1705. format("/* Long long long line\n"
  1706. " * short */\n",
  1707. getLLVMStyleWithColumns(20)));
  1708. // Don't reflow between separate blocks of comments.
  1709. EXPECT_EQ("/* First comment\n"
  1710. " * block will */\n"
  1711. "/* Snd\n"
  1712. " */\n",
  1713. format("/* First comment block\n"
  1714. " * will */\n"
  1715. "/* Snd\n"
  1716. " */\n",
  1717. getLLVMStyleWithColumns(20)));
  1718. // Don't reflow across blank comment lines.
  1719. EXPECT_EQ("int i; // This long\n"
  1720. " // line gets\n"
  1721. " // broken.\n"
  1722. " //\n"
  1723. " // keep.\n",
  1724. format("int i; // This long line gets broken.\n"
  1725. " // \n"
  1726. " // keep.\n",
  1727. getLLVMStyleWithColumns(20)));
  1728. EXPECT_EQ("{\n"
  1729. " /// long long long\n"
  1730. " /// long long\n"
  1731. " ///\n"
  1732. " /// long\n"
  1733. "}",
  1734. format("{\n"
  1735. " /// long long long long\n"
  1736. " /// long\n"
  1737. " ///\n"
  1738. " /// long\n"
  1739. "}",
  1740. getLLVMStyleWithColumns(20)));
  1741. EXPECT_EQ("//! long long long\n"
  1742. "//! long\n"
  1743. "\n"
  1744. "//! long",
  1745. format("//! long long long long\n"
  1746. "\n"
  1747. "//! long",
  1748. getLLVMStyleWithColumns(20)));
  1749. EXPECT_EQ("/* long long long\n"
  1750. " long\n"
  1751. "\n"
  1752. " long */",
  1753. format("/* long long long long\n"
  1754. "\n"
  1755. " long */",
  1756. getLLVMStyleWithColumns(20)));
  1757. EXPECT_EQ("/* long long long\n"
  1758. " * long\n"
  1759. " *\n"
  1760. " * long */",
  1761. format("/* long long long long\n"
  1762. " *\n"
  1763. " * long */",
  1764. getLLVMStyleWithColumns(20)));
  1765. // Don't reflow lines having content that is a single character.
  1766. EXPECT_EQ("// long long long\n"
  1767. "// long\n"
  1768. "// l",
  1769. format("// long long long long\n"
  1770. "// l",
  1771. getLLVMStyleWithColumns(20)));
  1772. // Don't reflow lines starting with two punctuation characters.
  1773. EXPECT_EQ("// long long long\n"
  1774. "// long\n"
  1775. "// ... --- ...",
  1776. format(
  1777. "// long long long long\n"
  1778. "// ... --- ...",
  1779. getLLVMStyleWithColumns(20)));
  1780. // Don't reflow lines starting with '@'.
  1781. EXPECT_EQ("// long long long\n"
  1782. "// long\n"
  1783. "// @param arg",
  1784. format("// long long long long\n"
  1785. "// @param arg",
  1786. getLLVMStyleWithColumns(20)));
  1787. // Don't reflow lines starting with 'TODO'.
  1788. EXPECT_EQ("// long long long\n"
  1789. "// long\n"
  1790. "// TODO: long",
  1791. format("// long long long long\n"
  1792. "// TODO: long",
  1793. getLLVMStyleWithColumns(20)));
  1794. // Don't reflow lines starting with 'FIXME'.
  1795. EXPECT_EQ("// long long long\n"
  1796. "// long\n"
  1797. "// FIXME: long",
  1798. format("// long long long long\n"
  1799. "// FIXME: long",
  1800. getLLVMStyleWithColumns(20)));
  1801. // Don't reflow lines starting with 'XXX'.
  1802. EXPECT_EQ("// long long long\n"
  1803. "// long\n"
  1804. "// XXX: long",
  1805. format("// long long long long\n"
  1806. "// XXX: long",
  1807. getLLVMStyleWithColumns(20)));
  1808. // Don't reflow comment pragmas.
  1809. EXPECT_EQ("// long long long\n"
  1810. "// long\n"
  1811. "// IWYU pragma:",
  1812. format("// long long long long\n"
  1813. "// IWYU pragma:",
  1814. getLLVMStyleWithColumns(20)));
  1815. EXPECT_EQ("/* long long long\n"
  1816. " * long\n"
  1817. " * IWYU pragma:\n"
  1818. " */",
  1819. format("/* long long long long\n"
  1820. " * IWYU pragma:\n"
  1821. " */",
  1822. getLLVMStyleWithColumns(20)));
  1823. // Reflow lines that have a non-punctuation character among their first 2
  1824. // characters.
  1825. EXPECT_EQ("// long long long\n"
  1826. "// long 'long'",
  1827. format(
  1828. "// long long long long\n"
  1829. "// 'long'",
  1830. getLLVMStyleWithColumns(20)));
  1831. // Don't reflow between separate blocks of comments.
  1832. EXPECT_EQ("/* First comment\n"
  1833. " * block will */\n"
  1834. "/* Snd\n"
  1835. " */\n",
  1836. format("/* First comment block\n"
  1837. " * will */\n"
  1838. "/* Snd\n"
  1839. " */\n",
  1840. getLLVMStyleWithColumns(20)));
  1841. // Don't reflow lines having different indentation.
  1842. EXPECT_EQ("// long long long\n"
  1843. "// long\n"
  1844. "// long",
  1845. format("// long long long long\n"
  1846. "// long",
  1847. getLLVMStyleWithColumns(20)));
  1848. // Don't reflow separate bullets in list
  1849. EXPECT_EQ("// - long long long\n"
  1850. "// long\n"
  1851. "// - long",
  1852. format("// - long long long long\n"
  1853. "// - long",
  1854. getLLVMStyleWithColumns(20)));
  1855. EXPECT_EQ("// * long long long\n"
  1856. "// long\n"
  1857. "// * long",
  1858. format("// * long long long long\n"
  1859. "// * long",
  1860. getLLVMStyleWithColumns(20)));
  1861. EXPECT_EQ("// + long long long\n"
  1862. "// long\n"
  1863. "// + long",
  1864. format("// + long long long long\n"
  1865. "// + long",
  1866. getLLVMStyleWithColumns(20)));
  1867. EXPECT_EQ("// 1. long long long\n"
  1868. "// long\n"
  1869. "// 2. long",
  1870. format("// 1. long long long long\n"
  1871. "// 2. long",
  1872. getLLVMStyleWithColumns(20)));
  1873. EXPECT_EQ("// -# long long long\n"
  1874. "// long\n"
  1875. "// -# long",
  1876. format("// -# long long long long\n"
  1877. "// -# long",
  1878. getLLVMStyleWithColumns(20)));
  1879. EXPECT_EQ("// - long long long\n"
  1880. "// long long long\n"
  1881. "// - long",
  1882. format("// - long long long long\n"
  1883. "// long long\n"
  1884. "// - long",
  1885. getLLVMStyleWithColumns(20)));
  1886. EXPECT_EQ("// - long long long\n"
  1887. "// long long long\n"
  1888. "// long\n"
  1889. "// - long",
  1890. format("// - long long long long\n"
  1891. "// long long long\n"
  1892. "// - long",
  1893. getLLVMStyleWithColumns(20)));
  1894. // Large number (>2 digits) are not list items
  1895. EXPECT_EQ("// long long long\n"
  1896. "// long 1024. long.",
  1897. format("// long long long long\n"
  1898. "// 1024. long.",
  1899. getLLVMStyleWithColumns(20)));
  1900. // Do not break before number, to avoid introducing a non-reflowable doxygen
  1901. // list item.
  1902. EXPECT_EQ("// long long\n"
  1903. "// long 10. long.",
  1904. format("// long long long 10.\n"
  1905. "// long.",
  1906. getLLVMStyleWithColumns(20)));
  1907. // Don't break or reflow after implicit string literals.
  1908. verifyFormat("#include <t> // l l l\n"
  1909. " // l",
  1910. getLLVMStyleWithColumns(20));
  1911. // Don't break or reflow comments on import lines.
  1912. EXPECT_EQ("#include \"t\" /* l l l\n"
  1913. " * l */",
  1914. format("#include \"t\" /* l l l\n"
  1915. " * l */",
  1916. getLLVMStyleWithColumns(20)));
  1917. // Don't reflow between different trailing comment sections.
  1918. EXPECT_EQ("int i; // long long\n"
  1919. " // long\n"
  1920. "int j; // long long\n"
  1921. " // long\n",
  1922. format("int i; // long long long\n"
  1923. "int j; // long long long\n",
  1924. getLLVMStyleWithColumns(20)));
  1925. // Don't reflow if the first word on the next line is longer than the
  1926. // available space at current line.
  1927. EXPECT_EQ("int i; // trigger\n"
  1928. " // reflow\n"
  1929. " // longsec\n",
  1930. format("int i; // trigger reflow\n"
  1931. " // longsec\n",
  1932. getLLVMStyleWithColumns(20)));
  1933. // Keep empty comment lines.
  1934. EXPECT_EQ("/**/", format(" /**/", getLLVMStyleWithColumns(20)));
  1935. EXPECT_EQ("/* */", format(" /* */", getLLVMStyleWithColumns(20)));
  1936. EXPECT_EQ("/* */", format(" /* */", getLLVMStyleWithColumns(20)));
  1937. EXPECT_EQ("//", format(" // ", getLLVMStyleWithColumns(20)));
  1938. EXPECT_EQ("///", format(" /// ", getLLVMStyleWithColumns(20)));
  1939. }
  1940. TEST_F(FormatTestComments, IgnoresIf0Contents) {
  1941. EXPECT_EQ("#if 0\n"
  1942. "}{)(&*(^%%#%@! fsadj f;ldjs ,:;| <<<>>>][)(][\n"
  1943. "#endif\n"
  1944. "void f() {}",
  1945. format("#if 0\n"
  1946. "}{)(&*(^%%#%@! fsadj f;ldjs ,:;| <<<>>>][)(][\n"
  1947. "#endif\n"
  1948. "void f( ) { }"));
  1949. EXPECT_EQ("#if false\n"
  1950. "void f( ) { }\n"
  1951. "#endif\n"
  1952. "void g() {}\n",
  1953. format("#if false\n"
  1954. "void f( ) { }\n"
  1955. "#endif\n"
  1956. "void g( ) { }\n"));
  1957. EXPECT_EQ("enum E {\n"
  1958. " One,\n"
  1959. " Two,\n"
  1960. "#if 0\n"
  1961. "Three,\n"
  1962. " Four,\n"
  1963. "#endif\n"
  1964. " Five\n"
  1965. "};",
  1966. format("enum E {\n"
  1967. " One,Two,\n"
  1968. "#if 0\n"
  1969. "Three,\n"
  1970. " Four,\n"
  1971. "#endif\n"
  1972. " Five};"));
  1973. EXPECT_EQ("enum F {\n"
  1974. " One,\n"
  1975. "#if 1\n"
  1976. " Two,\n"
  1977. "#if 0\n"
  1978. "Three,\n"
  1979. " Four,\n"
  1980. "#endif\n"
  1981. " Five\n"
  1982. "#endif\n"
  1983. "};",
  1984. format("enum F {\n"
  1985. "One,\n"
  1986. "#if 1\n"
  1987. "Two,\n"
  1988. "#if 0\n"
  1989. "Three,\n"
  1990. " Four,\n"
  1991. "#endif\n"
  1992. "Five\n"
  1993. "#endif\n"
  1994. "};"));
  1995. EXPECT_EQ("enum G {\n"
  1996. " One,\n"
  1997. "#if 0\n"
  1998. "Two,\n"
  1999. "#else\n"
  2000. " Three,\n"
  2001. "#endif\n"
  2002. " Four\n"
  2003. "};",
  2004. format("enum G {\n"
  2005. "One,\n"
  2006. "#if 0\n"
  2007. "Two,\n"
  2008. "#else\n"
  2009. "Three,\n"
  2010. "#endif\n"
  2011. "Four\n"
  2012. "};"));
  2013. EXPECT_EQ("enum H {\n"
  2014. " One,\n"
  2015. "#if 0\n"
  2016. "#ifdef Q\n"
  2017. "Two,\n"
  2018. "#else\n"
  2019. "Three,\n"
  2020. "#endif\n"
  2021. "#endif\n"
  2022. " Four\n"
  2023. "};",
  2024. format("enum H {\n"
  2025. "One,\n"
  2026. "#if 0\n"
  2027. "#ifdef Q\n"
  2028. "Two,\n"
  2029. "#else\n"
  2030. "Three,\n"
  2031. "#endif\n"
  2032. "#endif\n"
  2033. "Four\n"
  2034. "};"));
  2035. EXPECT_EQ("enum I {\n"
  2036. " One,\n"
  2037. "#if /* test */ 0 || 1\n"
  2038. "Two,\n"
  2039. "Three,\n"
  2040. "#endif\n"
  2041. " Four\n"
  2042. "};",
  2043. format("enum I {\n"
  2044. "One,\n"
  2045. "#if /* test */ 0 || 1\n"
  2046. "Two,\n"
  2047. "Three,\n"
  2048. "#endif\n"
  2049. "Four\n"
  2050. "};"));
  2051. EXPECT_EQ("enum J {\n"
  2052. " One,\n"
  2053. "#if 0\n"
  2054. "#if 0\n"
  2055. "Two,\n"
  2056. "#else\n"
  2057. "Three,\n"
  2058. "#endif\n"
  2059. "Four,\n"
  2060. "#endif\n"
  2061. " Five\n"
  2062. "};",
  2063. format("enum J {\n"
  2064. "One,\n"
  2065. "#if 0\n"
  2066. "#if 0\n"
  2067. "Two,\n"
  2068. "#else\n"
  2069. "Three,\n"
  2070. "#endif\n"
  2071. "Four,\n"
  2072. "#endif\n"
  2073. "Five\n"
  2074. "};"));
  2075. // Ignore stuff in SWIG-blocks.
  2076. EXPECT_EQ("#ifdef SWIG\n"
  2077. "}{)(&*(^%%#%@! fsadj f;ldjs ,:;| <<<>>>][)(][\n"
  2078. "#endif\n"
  2079. "void f() {}",
  2080. format("#ifdef SWIG\n"
  2081. "}{)(&*(^%%#%@! fsadj f;ldjs ,:;| <<<>>>][)(][\n"
  2082. "#endif\n"
  2083. "void f( ) { }"));
  2084. EXPECT_EQ("#ifndef SWIG\n"
  2085. "void f() {}\n"
  2086. "#endif",
  2087. format("#ifndef SWIG\n"
  2088. "void f( ) { }\n"
  2089. "#endif"));
  2090. }
  2091. TEST_F(FormatTestComments, DontCrashOnBlockComments) {
  2092. EXPECT_EQ(
  2093. "int xxxxxxxxx; /* "
  2094. "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy\n"
  2095. "zzzzzz\n"
  2096. "0*/",
  2097. format("int xxxxxxxxx; /* "
  2098. "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy zzzzzz\n"
  2099. "0*/"));
  2100. }
  2101. TEST_F(FormatTestComments, BlockCommentsInControlLoops) {
  2102. verifyFormat("if (0) /* a comment in a strange place */ {\n"
  2103. " f();\n"
  2104. "}");
  2105. verifyFormat("if (0) /* a comment in a strange place */ {\n"
  2106. " f();\n"
  2107. "} /* another comment */ else /* comment #3 */ {\n"
  2108. " g();\n"
  2109. "}");
  2110. verifyFormat("while (0) /* a comment in a strange place */ {\n"
  2111. " f();\n"
  2112. "}");
  2113. verifyFormat("for (;;) /* a comment in a strange place */ {\n"
  2114. " f();\n"
  2115. "}");
  2116. verifyFormat("do /* a comment in a strange place */ {\n"
  2117. " f();\n"
  2118. "} /* another comment */ while (0);");
  2119. }
  2120. TEST_F(FormatTestComments, BlockComments) {
  2121. EXPECT_EQ("/* */ /* */ /* */\n/* */ /* */ /* */",
  2122. format("/* *//* */ /* */\n/* *//* */ /* */"));
  2123. EXPECT_EQ("/* */ a /* */ b;", format(" /* */ a/* */ b;"));
  2124. EXPECT_EQ("#define A /*123*/ \\\n"
  2125. " b\n"
  2126. "/* */\n"
  2127. "someCall(\n"
  2128. " parameter);",
  2129. format("#define A /*123*/ b\n"
  2130. "/* */\n"
  2131. "someCall(parameter);",
  2132. getLLVMStyleWithColumns(15)));
  2133. EXPECT_EQ("#define A\n"
  2134. "/* */ someCall(\n"
  2135. " parameter);",
  2136. format("#define A\n"
  2137. "/* */someCall(parameter);",
  2138. getLLVMStyleWithColumns(15)));
  2139. EXPECT_EQ("/*\n**\n*/", format("/*\n**\n*/"));
  2140. EXPECT_EQ("/*\n"
  2141. " *\n"
  2142. " * aaaaaa\n"
  2143. " * aaaaaa\n"
  2144. " */",
  2145. format("/*\n"
  2146. "*\n"
  2147. " * aaaaaa aaaaaa\n"
  2148. "*/",
  2149. getLLVMStyleWithColumns(10)));
  2150. EXPECT_EQ("/*\n"
  2151. "**\n"
  2152. "* aaaaaa\n"
  2153. "*aaaaaa\n"
  2154. "*/",
  2155. format("/*\n"
  2156. "**\n"
  2157. "* aaaaaa aaaaaa\n"
  2158. "*/",
  2159. getLLVMStyleWithColumns(10)));
  2160. EXPECT_EQ("int aaaaaaaaaaaaaaaaaaaaaaaaaaaa =\n"
  2161. " /* line 1\n"
  2162. " bbbbbbbbbbbb */\n"
  2163. " bbbbbbbbbbbbbbbbbbbbbbbbbbbb;",
  2164. format("int aaaaaaaaaaaaaaaaaaaaaaaaaaaa =\n"
  2165. " /* line 1\n"
  2166. " bbbbbbbbbbbb */ bbbbbbbbbbbbbbbbbbbbbbbbbbbb;",
  2167. getLLVMStyleWithColumns(50)));
  2168. FormatStyle NoBinPacking = getLLVMStyle();
  2169. NoBinPacking.BinPackParameters = false;
  2170. EXPECT_EQ("someFunction(1, /* comment 1 */\n"
  2171. " 2, /* comment 2 */\n"
  2172. " 3, /* comment 3 */\n"
  2173. " aaaa,\n"
  2174. " bbbb);",
  2175. format("someFunction (1, /* comment 1 */\n"
  2176. " 2, /* comment 2 */ \n"
  2177. " 3, /* comment 3 */\n"
  2178. "aaaa, bbbb );",
  2179. NoBinPacking));
  2180. verifyFormat(
  2181. "bool aaaaaaaaaaaaa = /* comment: */ aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ||\n"
  2182. " aaaaaaaaaaaaaaaaaaaaaaaaaaaa;");
  2183. EXPECT_EQ(
  2184. "bool aaaaaaaaaaaaa = /* trailing comment */\n"
  2185. " aaaaaaaaaaaaaaaaaaaaaaaaaaa || aaaaaaaaaaaaaaaaaaaaaaaaa ||\n"
  2186. " aaaaaaaaaaaaaaaaaaaaaaaaaaaa || aaaaaaaaaaaaaaaaaaaaaaaaaa;",
  2187. format(
  2188. "bool aaaaaaaaaaaaa = /* trailing comment */\n"
  2189. " aaaaaaaaaaaaaaaaaaaaaaaaaaa||aaaaaaaaaaaaaaaaaaaaaaaaa ||\n"
  2190. " aaaaaaaaaaaaaaaaaaaaaaaaaaaa || aaaaaaaaaaaaaaaaaaaaaaaaaa;"));
  2191. EXPECT_EQ(
  2192. "int aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa; /* comment */\n"
  2193. "int bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb; /* comment */\n"
  2194. "int cccccccccccccccccccccccccccccc; /* comment */\n",
  2195. format("int aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa; /* comment */\n"
  2196. "int bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb; /* comment */\n"
  2197. "int cccccccccccccccccccccccccccccc; /* comment */\n"));
  2198. verifyFormat("void f(int * /* unused */) {}");
  2199. EXPECT_EQ("/*\n"
  2200. " **\n"
  2201. " */",
  2202. format("/*\n"
  2203. " **\n"
  2204. " */"));
  2205. EXPECT_EQ("/*\n"
  2206. " *q\n"
  2207. " */",
  2208. format("/*\n"
  2209. " *q\n"
  2210. " */"));
  2211. EXPECT_EQ("/*\n"
  2212. " * q\n"
  2213. " */",
  2214. format("/*\n"
  2215. " * q\n"
  2216. " */"));
  2217. EXPECT_EQ("/*\n"
  2218. " **/",
  2219. format("/*\n"
  2220. " **/"));
  2221. EXPECT_EQ("/*\n"
  2222. " ***/",
  2223. format("/*\n"
  2224. " ***/"));
  2225. }
  2226. TEST_F(FormatTestComments, BlockCommentsInMacros) {
  2227. EXPECT_EQ("#define A \\\n"
  2228. " { \\\n"
  2229. " /* one line */ \\\n"
  2230. " someCall();",
  2231. format("#define A { \\\n"
  2232. " /* one line */ \\\n"
  2233. " someCall();",
  2234. getLLVMStyleWithColumns(20)));
  2235. EXPECT_EQ("#define A \\\n"
  2236. " { \\\n"
  2237. " /* previous */ \\\n"
  2238. " /* one line */ \\\n"
  2239. " someCall();",
  2240. format("#define A { \\\n"
  2241. " /* previous */ \\\n"
  2242. " /* one line */ \\\n"
  2243. " someCall();",
  2244. getLLVMStyleWithColumns(20)));
  2245. }
  2246. TEST_F(FormatTestComments, BlockCommentsAtEndOfLine) {
  2247. EXPECT_EQ("a = {\n"
  2248. " 1111 /* */\n"
  2249. "};",
  2250. format("a = {1111 /* */\n"
  2251. "};",
  2252. getLLVMStyleWithColumns(15)));
  2253. EXPECT_EQ("a = {\n"
  2254. " 1111 /* */\n"
  2255. "};",
  2256. format("a = {1111 /* */\n"
  2257. "};",
  2258. getLLVMStyleWithColumns(15)));
  2259. EXPECT_EQ("a = {\n"
  2260. " 1111 /* a\n"
  2261. " */\n"
  2262. "};",
  2263. format("a = {1111 /* a */\n"
  2264. "};",
  2265. getLLVMStyleWithColumns(15)));
  2266. }
  2267. TEST_F(FormatTestComments, IndentLineCommentsInStartOfBlockAtEndOfFile) {
  2268. verifyFormat("{\n"
  2269. " // a\n"
  2270. " // b");
  2271. }
  2272. TEST_F(FormatTestComments, AlignTrailingComments) {
  2273. EXPECT_EQ("#define MACRO(V) \\\n"
  2274. " V(Rt2) /* one more char */ \\\n"
  2275. " V(Rs) /* than here */ \\\n"
  2276. "/* comment 3 */\n",
  2277. format("#define MACRO(V)\\\n"
  2278. "V(Rt2) /* one more char */ \\\n"
  2279. "V(Rs) /* than here */ \\\n"
  2280. "/* comment 3 */\n",
  2281. getLLVMStyleWithColumns(40)));
  2282. EXPECT_EQ("int i = f(abc, // line 1\n"
  2283. " d, // line 2\n"
  2284. " // line 3\n"
  2285. " b);",
  2286. format("int i = f(abc, // line 1\n"
  2287. " d, // line 2\n"
  2288. " // line 3\n"
  2289. " b);",
  2290. getLLVMStyleWithColumns(40)));
  2291. // Align newly broken trailing comments.
  2292. EXPECT_EQ("int ab; // line\n"
  2293. "int a; // long\n"
  2294. " // long\n",
  2295. format("int ab; // line\n"
  2296. "int a; // long long\n",
  2297. getLLVMStyleWithColumns(15)));
  2298. EXPECT_EQ("int ab; // line\n"
  2299. "int a; // long\n"
  2300. " // long\n"
  2301. " // long",
  2302. format("int ab; // line\n"
  2303. "int a; // long long\n"
  2304. " // long",
  2305. getLLVMStyleWithColumns(15)));
  2306. EXPECT_EQ("int ab; // line\n"
  2307. "int a; // long\n"
  2308. " // long\n"
  2309. "pt c; // long",
  2310. format("int ab; // line\n"
  2311. "int a; // long long\n"
  2312. "pt c; // long",
  2313. getLLVMStyleWithColumns(15)));
  2314. EXPECT_EQ("int ab; // line\n"
  2315. "int a; // long\n"
  2316. " // long\n"
  2317. "\n"
  2318. "// long",
  2319. format("int ab; // line\n"
  2320. "int a; // long long\n"
  2321. "\n"
  2322. "// long",
  2323. getLLVMStyleWithColumns(15)));
  2324. // Don't align newly broken trailing comments if that would put them over the
  2325. // column limit.
  2326. EXPECT_EQ("int i, j; // line 1\n"
  2327. "int k; // line longg\n"
  2328. " // long",
  2329. format("int i, j; // line 1\n"
  2330. "int k; // line longg long",
  2331. getLLVMStyleWithColumns(20)));
  2332. // Always align if ColumnLimit = 0
  2333. EXPECT_EQ("int i, j; // line 1\n"
  2334. "int k; // line longg long",
  2335. format("int i, j; // line 1\n"
  2336. "int k; // line longg long",
  2337. getLLVMStyleWithColumns(0)));
  2338. // Align comment line sections aligned with the next token with the next
  2339. // token.
  2340. EXPECT_EQ("class A {\n"
  2341. "public: // public comment\n"
  2342. " // comment about a\n"
  2343. " int a;\n"
  2344. "};",
  2345. format("class A {\n"
  2346. "public: // public comment\n"
  2347. " // comment about a\n"
  2348. " int a;\n"
  2349. "};",
  2350. getLLVMStyleWithColumns(40)));
  2351. EXPECT_EQ("class A {\n"
  2352. "public: // public comment 1\n"
  2353. " // public comment 2\n"
  2354. " // comment 1 about a\n"
  2355. " // comment 2 about a\n"
  2356. " int a;\n"
  2357. "};",
  2358. format("class A {\n"
  2359. "public: // public comment 1\n"
  2360. " // public comment 2\n"
  2361. " // comment 1 about a\n"
  2362. " // comment 2 about a\n"
  2363. " int a;\n"
  2364. "};",
  2365. getLLVMStyleWithColumns(40)));
  2366. EXPECT_EQ("int f(int n) { // comment line 1 on f\n"
  2367. " // comment line 2 on f\n"
  2368. " // comment line 1 before return\n"
  2369. " // comment line 2 before return\n"
  2370. " return n; // comment line 1 on return\n"
  2371. " // comment line 2 on return\n"
  2372. " // comment line 1 after return\n"
  2373. "}",
  2374. format("int f(int n) { // comment line 1 on f\n"
  2375. " // comment line 2 on f\n"
  2376. " // comment line 1 before return\n"
  2377. " // comment line 2 before return\n"
  2378. " return n; // comment line 1 on return\n"
  2379. " // comment line 2 on return\n"
  2380. " // comment line 1 after return\n"
  2381. "}",
  2382. getLLVMStyleWithColumns(40)));
  2383. EXPECT_EQ("int f(int n) {\n"
  2384. " switch (n) { // comment line 1 on switch\n"
  2385. " // comment line 2 on switch\n"
  2386. " // comment line 1 before case 1\n"
  2387. " // comment line 2 before case 1\n"
  2388. " case 1: // comment line 1 on case 1\n"
  2389. " // comment line 2 on case 1\n"
  2390. " // comment line 1 before return 1\n"
  2391. " // comment line 2 before return 1\n"
  2392. " return 1; // comment line 1 on return 1\n"
  2393. " // comment line 2 on return 1\n"
  2394. " // comment line 1 before default\n"
  2395. " // comment line 2 before default\n"
  2396. " default: // comment line 1 on default\n"
  2397. " // comment line 2 on default\n"
  2398. " // comment line 1 before return 2\n"
  2399. " return 2 * f(n - 1); // comment line 1 on return 2\n"
  2400. " // comment line 2 on return 2\n"
  2401. " // comment line 1 after return\n"
  2402. " // comment line 2 after return\n"
  2403. " }\n"
  2404. "}",
  2405. format("int f(int n) {\n"
  2406. " switch (n) { // comment line 1 on switch\n"
  2407. " // comment line 2 on switch\n"
  2408. " // comment line 1 before case 1\n"
  2409. " // comment line 2 before case 1\n"
  2410. " case 1: // comment line 1 on case 1\n"
  2411. " // comment line 2 on case 1\n"
  2412. " // comment line 1 before return 1\n"
  2413. " // comment line 2 before return 1\n"
  2414. " return 1; // comment line 1 on return 1\n"
  2415. " // comment line 2 on return 1\n"
  2416. " // comment line 1 before default\n"
  2417. " // comment line 2 before default\n"
  2418. " default: // comment line 1 on default\n"
  2419. " // comment line 2 on default\n"
  2420. " // comment line 1 before return 2\n"
  2421. " return 2 * f(n - 1); // comment line 1 on return 2\n"
  2422. " // comment line 2 on return 2\n"
  2423. " // comment line 1 after return\n"
  2424. " // comment line 2 after return\n"
  2425. " }\n"
  2426. "}",
  2427. getLLVMStyleWithColumns(80)));
  2428. // If all the lines in a sequence of line comments are aligned with the next
  2429. // token, the first line belongs to the previous token and the other lines
  2430. // belong to the next token.
  2431. EXPECT_EQ("int a; // line about a\n"
  2432. "long b;",
  2433. format("int a; // line about a\n"
  2434. " long b;",
  2435. getLLVMStyleWithColumns(80)));
  2436. EXPECT_EQ("int a; // line about a\n"
  2437. "// line about b\n"
  2438. "long b;",
  2439. format("int a; // line about a\n"
  2440. " // line about b\n"
  2441. " long b;",
  2442. getLLVMStyleWithColumns(80)));
  2443. EXPECT_EQ("int a; // line about a\n"
  2444. "// line 1 about b\n"
  2445. "// line 2 about b\n"
  2446. "long b;",
  2447. format("int a; // line about a\n"
  2448. " // line 1 about b\n"
  2449. " // line 2 about b\n"
  2450. " long b;",
  2451. getLLVMStyleWithColumns(80)));
  2452. }
  2453. TEST_F(FormatTestComments, AlignsBlockCommentDecorations) {
  2454. EXPECT_EQ("/*\n"
  2455. " */",
  2456. format("/*\n"
  2457. "*/", getLLVMStyle()));
  2458. EXPECT_EQ("/*\n"
  2459. " */",
  2460. format("/*\n"
  2461. " */", getLLVMStyle()));
  2462. EXPECT_EQ("/*\n"
  2463. " */",
  2464. format("/*\n"
  2465. " */", getLLVMStyle()));
  2466. // Align a single line.
  2467. EXPECT_EQ("/*\n"
  2468. " * line */",
  2469. format("/*\n"
  2470. "* line */",
  2471. getLLVMStyle()));
  2472. EXPECT_EQ("/*\n"
  2473. " * line */",
  2474. format("/*\n"
  2475. " * line */",
  2476. getLLVMStyle()));
  2477. EXPECT_EQ("/*\n"
  2478. " * line */",
  2479. format("/*\n"
  2480. " * line */",
  2481. getLLVMStyle()));
  2482. EXPECT_EQ("/*\n"
  2483. " * line */",
  2484. format("/*\n"
  2485. " * line */",
  2486. getLLVMStyle()));
  2487. EXPECT_EQ("/**\n"
  2488. " * line */",
  2489. format("/**\n"
  2490. "* line */",
  2491. getLLVMStyle()));
  2492. EXPECT_EQ("/**\n"
  2493. " * line */",
  2494. format("/**\n"
  2495. " * line */",
  2496. getLLVMStyle()));
  2497. EXPECT_EQ("/**\n"
  2498. " * line */",
  2499. format("/**\n"
  2500. " * line */",
  2501. getLLVMStyle()));
  2502. EXPECT_EQ("/**\n"
  2503. " * line */",
  2504. format("/**\n"
  2505. " * line */",
  2506. getLLVMStyle()));
  2507. EXPECT_EQ("/**\n"
  2508. " * line */",
  2509. format("/**\n"
  2510. " * line */",
  2511. getLLVMStyle()));
  2512. // Align the end '*/' after a line.
  2513. EXPECT_EQ("/*\n"
  2514. " * line\n"
  2515. " */",
  2516. format("/*\n"
  2517. "* line\n"
  2518. "*/", getLLVMStyle()));
  2519. EXPECT_EQ("/*\n"
  2520. " * line\n"
  2521. " */",
  2522. format("/*\n"
  2523. " * line\n"
  2524. " */", getLLVMStyle()));
  2525. EXPECT_EQ("/*\n"
  2526. " * line\n"
  2527. " */",
  2528. format("/*\n"
  2529. " * line\n"
  2530. " */", getLLVMStyle()));
  2531. // Align two lines.
  2532. EXPECT_EQ("/* line 1\n"
  2533. " * line 2 */",
  2534. format("/* line 1\n"
  2535. " * line 2 */",
  2536. getLLVMStyle()));
  2537. EXPECT_EQ("/* line 1\n"
  2538. " * line 2 */",
  2539. format("/* line 1\n"
  2540. "* line 2 */",
  2541. getLLVMStyle()));
  2542. EXPECT_EQ("/* line 1\n"
  2543. " * line 2 */",
  2544. format("/* line 1\n"
  2545. " * line 2 */",
  2546. getLLVMStyle()));
  2547. EXPECT_EQ("/* line 1\n"
  2548. " * line 2 */",
  2549. format("/* line 1\n"
  2550. " * line 2 */",
  2551. getLLVMStyle()));
  2552. EXPECT_EQ("/* line 1\n"
  2553. " * line 2 */",
  2554. format("/* line 1\n"
  2555. " * line 2 */",
  2556. getLLVMStyle()));
  2557. EXPECT_EQ("int i; /* line 1\n"
  2558. " * line 2 */",
  2559. format("int i; /* line 1\n"
  2560. "* line 2 */",
  2561. getLLVMStyle()));
  2562. EXPECT_EQ("int i; /* line 1\n"
  2563. " * line 2 */",
  2564. format("int i; /* line 1\n"
  2565. " * line 2 */",
  2566. getLLVMStyle()));
  2567. EXPECT_EQ("int i; /* line 1\n"
  2568. " * line 2 */",
  2569. format("int i; /* line 1\n"
  2570. " * line 2 */",
  2571. getLLVMStyle()));
  2572. // Align several lines.
  2573. EXPECT_EQ("/* line 1\n"
  2574. " * line 2\n"
  2575. " * line 3 */",
  2576. format("/* line 1\n"
  2577. " * line 2\n"
  2578. "* line 3 */",
  2579. getLLVMStyle()));
  2580. EXPECT_EQ("/* line 1\n"
  2581. " * line 2\n"
  2582. " * line 3 */",
  2583. format("/* line 1\n"
  2584. " * line 2\n"
  2585. "* line 3 */",
  2586. getLLVMStyle()));
  2587. EXPECT_EQ("/*\n"
  2588. "** line 1\n"
  2589. "** line 2\n"
  2590. "*/",
  2591. format("/*\n"
  2592. "** line 1\n"
  2593. " ** line 2\n"
  2594. "*/",
  2595. getLLVMStyle()));
  2596. // Align with different indent after the decorations.
  2597. EXPECT_EQ("/*\n"
  2598. " * line 1\n"
  2599. " * line 2\n"
  2600. " * line 3\n"
  2601. " * line 4\n"
  2602. " */",
  2603. format("/*\n"
  2604. "* line 1\n"
  2605. " * line 2\n"
  2606. " * line 3\n"
  2607. "* line 4\n"
  2608. "*/", getLLVMStyle()));
  2609. // Align empty or blank lines.
  2610. EXPECT_EQ("/**\n"
  2611. " *\n"
  2612. " *\n"
  2613. " *\n"
  2614. " */",
  2615. format("/**\n"
  2616. "* \n"
  2617. " * \n"
  2618. " *\n"
  2619. "*/", getLLVMStyle()));
  2620. // Align while breaking and reflowing.
  2621. EXPECT_EQ("/*\n"
  2622. " * long long long\n"
  2623. " * long long\n"
  2624. " *\n"
  2625. " * long */",
  2626. format("/*\n"
  2627. " * long long long long\n"
  2628. " * long\n"
  2629. " *\n"
  2630. "* long */",
  2631. getLLVMStyleWithColumns(20)));
  2632. }
  2633. TEST_F(FormatTestComments, NonTrailingBlockComments) {
  2634. verifyFormat("const /** comment comment */ A = B;",
  2635. getLLVMStyleWithColumns(40));
  2636. verifyFormat("const /** comment comment comment */ A =\n"
  2637. " B;",
  2638. getLLVMStyleWithColumns(40));
  2639. EXPECT_EQ("const /** comment comment comment\n"
  2640. " comment */\n"
  2641. " A = B;",
  2642. format("const /** comment comment comment comment */\n"
  2643. " A = B;",
  2644. getLLVMStyleWithColumns(40)));
  2645. }
  2646. TEST_F(FormatTestComments, NoCrush_Bug34236) {
  2647. // This is a test case from a crasher reported in:
  2648. // https://bugs.llvm.org/show_bug.cgi?id=34236
  2649. EXPECT_EQ(
  2650. R"(
  2651. /* */ /*
  2652. * a
  2653. * b c
  2654. * d*/)",
  2655. format(
  2656. R"(
  2657. /* */ /*
  2658. * a b
  2659. * c d*/)",
  2660. getLLVMStyleWithColumns(80)));
  2661. }
  2662. } // end namespace
  2663. } // end namespace format
  2664. } // end namespace clang