FormatTestComments.cpp 87 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479
  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, SplitsLongLinesInComments) {
  755. EXPECT_EQ("/* This is a long\n"
  756. " * comment that\n"
  757. " * doesn't\n"
  758. " * fit on one line.\n"
  759. " */",
  760. format("/* "
  761. "This is a long "
  762. "comment that "
  763. "doesn't "
  764. "fit on one line. */",
  765. getLLVMStyleWithColumns(20)));
  766. EXPECT_EQ(
  767. "/* a b c d\n"
  768. " * e f g\n"
  769. " * h i j k\n"
  770. " */",
  771. format("/* a b c d e f g h i j k */", getLLVMStyleWithColumns(10)));
  772. EXPECT_EQ(
  773. "/* a b c d\n"
  774. " * e f g\n"
  775. " * h i j k\n"
  776. " */",
  777. format("\\\n/* a b c d e f g h i j k */", getLLVMStyleWithColumns(10)));
  778. EXPECT_EQ("/*\n"
  779. "This is a long\n"
  780. "comment that doesn't\n"
  781. "fit on one line.\n"
  782. "*/",
  783. format("/*\n"
  784. "This is a long "
  785. "comment that doesn't "
  786. "fit on one line. \n"
  787. "*/",
  788. getLLVMStyleWithColumns(20)));
  789. EXPECT_EQ("/*\n"
  790. " * This is a long\n"
  791. " * comment that\n"
  792. " * doesn't fit on\n"
  793. " * one line.\n"
  794. " */",
  795. format("/* \n"
  796. " * This is a long "
  797. " comment that "
  798. " doesn't fit on "
  799. " one line. \n"
  800. " */",
  801. getLLVMStyleWithColumns(20)));
  802. EXPECT_EQ("/*\n"
  803. " * This_is_a_comment_with_words_that_dont_fit_on_one_line\n"
  804. " * so_it_should_be_broken\n"
  805. " * wherever_a_space_occurs\n"
  806. " */",
  807. format("/*\n"
  808. " * This_is_a_comment_with_words_that_dont_fit_on_one_line "
  809. " so_it_should_be_broken "
  810. " wherever_a_space_occurs \n"
  811. " */",
  812. getLLVMStyleWithColumns(20)));
  813. EXPECT_EQ("/*\n"
  814. " * This_comment_can_not_be_broken_into_lines\n"
  815. " */",
  816. format("/*\n"
  817. " * This_comment_can_not_be_broken_into_lines\n"
  818. " */",
  819. getLLVMStyleWithColumns(20)));
  820. EXPECT_EQ("{\n"
  821. " /*\n"
  822. " This is another\n"
  823. " long comment that\n"
  824. " doesn't fit on one\n"
  825. " line 1234567890\n"
  826. " */\n"
  827. "}",
  828. format("{\n"
  829. "/*\n"
  830. "This is another "
  831. " long comment that "
  832. " doesn't fit on one"
  833. " line 1234567890\n"
  834. "*/\n"
  835. "}",
  836. getLLVMStyleWithColumns(20)));
  837. EXPECT_EQ("{\n"
  838. " /*\n"
  839. " * This i s\n"
  840. " * another comment\n"
  841. " * t hat doesn' t\n"
  842. " * fit on one l i\n"
  843. " * n e\n"
  844. " */\n"
  845. "}",
  846. format("{\n"
  847. "/*\n"
  848. " * This i s"
  849. " another comment"
  850. " t hat doesn' t"
  851. " fit on one l i"
  852. " n e\n"
  853. " */\n"
  854. "}",
  855. getLLVMStyleWithColumns(20)));
  856. EXPECT_EQ("/*\n"
  857. " * This is a long\n"
  858. " * comment that\n"
  859. " * doesn't fit on\n"
  860. " * one line\n"
  861. " */",
  862. format(" /*\n"
  863. " * This is a long comment that doesn't fit on one line\n"
  864. " */",
  865. getLLVMStyleWithColumns(20)));
  866. EXPECT_EQ("{\n"
  867. " if (something) /* This is a\n"
  868. " long\n"
  869. " comment */\n"
  870. " ;\n"
  871. "}",
  872. format("{\n"
  873. " if (something) /* This is a long comment */\n"
  874. " ;\n"
  875. "}",
  876. getLLVMStyleWithColumns(30)));
  877. EXPECT_EQ("/* A comment before\n"
  878. " * a macro\n"
  879. " * definition */\n"
  880. "#define a b",
  881. format("/* A comment before a macro definition */\n"
  882. "#define a b",
  883. getLLVMStyleWithColumns(20)));
  884. EXPECT_EQ("/* some comment\n"
  885. " * a comment that\n"
  886. " * we break another\n"
  887. " * comment we have\n"
  888. " * to break a left\n"
  889. " * comment\n"
  890. " */",
  891. format(" /* some comment\n"
  892. " * a comment that we break\n"
  893. " * another comment we have to break\n"
  894. "* a left comment\n"
  895. " */",
  896. getLLVMStyleWithColumns(20)));
  897. EXPECT_EQ("/**\n"
  898. " * multiline block\n"
  899. " * comment\n"
  900. " *\n"
  901. " */",
  902. format("/**\n"
  903. " * multiline block comment\n"
  904. " *\n"
  905. " */",
  906. getLLVMStyleWithColumns(20)));
  907. EXPECT_EQ("/*\n"
  908. "\n"
  909. "\n"
  910. " */\n",
  911. format(" /* \n"
  912. " \n"
  913. " \n"
  914. " */\n"));
  915. EXPECT_EQ("/* a a */",
  916. format("/* a a */", getLLVMStyleWithColumns(15)));
  917. EXPECT_EQ("/* a a bc */",
  918. format("/* a a bc */", getLLVMStyleWithColumns(15)));
  919. EXPECT_EQ("/* aaa aaa\n"
  920. " * aaaaa */",
  921. format("/* aaa aaa aaaaa */", getLLVMStyleWithColumns(15)));
  922. EXPECT_EQ("/* aaa aaa\n"
  923. " * aaaaa */",
  924. format("/* aaa aaa aaaaa */", getLLVMStyleWithColumns(15)));
  925. }
  926. TEST_F(FormatTestComments, SplitsLongLinesInCommentsInPreprocessor) {
  927. EXPECT_EQ("#define X \\\n"
  928. " /* \\\n"
  929. " Test \\\n"
  930. " Macro comment \\\n"
  931. " with a long \\\n"
  932. " line \\\n"
  933. " */ \\\n"
  934. " A + B",
  935. format("#define X \\\n"
  936. " /*\n"
  937. " Test\n"
  938. " Macro comment with a long line\n"
  939. " */ \\\n"
  940. " A + B",
  941. getLLVMStyleWithColumns(20)));
  942. EXPECT_EQ("#define X \\\n"
  943. " /* Macro comment \\\n"
  944. " with a long \\\n"
  945. " line */ \\\n"
  946. " A + B",
  947. format("#define X \\\n"
  948. " /* Macro comment with a long\n"
  949. " line */ \\\n"
  950. " A + B",
  951. getLLVMStyleWithColumns(20)));
  952. EXPECT_EQ("#define X \\\n"
  953. " /* Macro comment \\\n"
  954. " * with a long \\\n"
  955. " * line */ \\\n"
  956. " A + B",
  957. format("#define X \\\n"
  958. " /* Macro comment with a long line */ \\\n"
  959. " A + B",
  960. getLLVMStyleWithColumns(20)));
  961. }
  962. TEST_F(FormatTestComments, KeepsTrailingPPCommentsAndSectionCommentsSeparate) {
  963. verifyFormat("#ifdef A // line about A\n"
  964. "// section comment\n"
  965. "#endif",
  966. getLLVMStyleWithColumns(80));
  967. verifyFormat("#ifdef A // line 1 about A\n"
  968. " // line 2 about A\n"
  969. "// section comment\n"
  970. "#endif",
  971. getLLVMStyleWithColumns(80));
  972. EXPECT_EQ("#ifdef A // line 1 about A\n"
  973. " // line 2 about A\n"
  974. "// section comment\n"
  975. "#endif",
  976. format("#ifdef A // line 1 about A\n"
  977. " // line 2 about A\n"
  978. "// section comment\n"
  979. "#endif",
  980. getLLVMStyleWithColumns(80)));
  981. verifyFormat("int f() {\n"
  982. " int i;\n"
  983. "#ifdef A // comment about A\n"
  984. " // section comment 1\n"
  985. " // section comment 2\n"
  986. " i = 2;\n"
  987. "#else // comment about #else\n"
  988. " // section comment 3\n"
  989. " i = 4;\n"
  990. "#endif\n"
  991. "}", getLLVMStyleWithColumns(80));
  992. }
  993. TEST_F(FormatTestComments, CommentsInStaticInitializers) {
  994. EXPECT_EQ(
  995. "static SomeType type = {aaaaaaaaaaaaaaaaaaaa, /* comment */\n"
  996. " aaaaaaaaaaaaaaaaaaaa /* comment */,\n"
  997. " /* comment */ aaaaaaaaaaaaaaaaaaaa,\n"
  998. " aaaaaaaaaaaaaaaaaaaa, // comment\n"
  999. " aaaaaaaaaaaaaaaaaaaa};",
  1000. format("static SomeType type = { aaaaaaaaaaaaaaaaaaaa , /* comment */\n"
  1001. " aaaaaaaaaaaaaaaaaaaa /* comment */ ,\n"
  1002. " /* comment */ aaaaaaaaaaaaaaaaaaaa ,\n"
  1003. " aaaaaaaaaaaaaaaaaaaa , // comment\n"
  1004. " aaaaaaaaaaaaaaaaaaaa };"));
  1005. verifyFormat("static SomeType type = {aaaaaaaaaaa, // comment for aa...\n"
  1006. " bbbbbbbbbbb, ccccccccccc};");
  1007. verifyFormat("static SomeType type = {aaaaaaaaaaa,\n"
  1008. " // comment for bb....\n"
  1009. " bbbbbbbbbbb, ccccccccccc};");
  1010. verifyGoogleFormat(
  1011. "static SomeType type = {aaaaaaaaaaa, // comment for aa...\n"
  1012. " bbbbbbbbbbb, ccccccccccc};");
  1013. verifyGoogleFormat("static SomeType type = {aaaaaaaaaaa,\n"
  1014. " // comment for bb....\n"
  1015. " bbbbbbbbbbb, ccccccccccc};");
  1016. verifyFormat("S s = {{a, b, c}, // Group #1\n"
  1017. " {d, e, f}, // Group #2\n"
  1018. " {g, h, i}}; // Group #3");
  1019. verifyFormat("S s = {{// Group #1\n"
  1020. " a, b, c},\n"
  1021. " {// Group #2\n"
  1022. " d, e, f},\n"
  1023. " {// Group #3\n"
  1024. " g, h, i}};");
  1025. EXPECT_EQ("S s = {\n"
  1026. " // Some comment\n"
  1027. " a,\n"
  1028. "\n"
  1029. " // Comment after empty line\n"
  1030. " b}",
  1031. format("S s = {\n"
  1032. " // Some comment\n"
  1033. " a,\n"
  1034. " \n"
  1035. " // Comment after empty line\n"
  1036. " b\n"
  1037. "}"));
  1038. EXPECT_EQ("S s = {\n"
  1039. " /* Some comment */\n"
  1040. " a,\n"
  1041. "\n"
  1042. " /* Comment after empty line */\n"
  1043. " b}",
  1044. format("S s = {\n"
  1045. " /* Some comment */\n"
  1046. " a,\n"
  1047. " \n"
  1048. " /* Comment after empty line */\n"
  1049. " b\n"
  1050. "}"));
  1051. verifyFormat("const uint8_t aaaaaaaaaaaaaaaaaaaaaa[0] = {\n"
  1052. " 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // comment\n"
  1053. " 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // comment\n"
  1054. " 0x00, 0x00, 0x00, 0x00}; // comment\n");
  1055. }
  1056. TEST_F(FormatTestComments, LineCommentsAfterRightBrace) {
  1057. EXPECT_EQ("if (true) { // comment about branch\n"
  1058. " // comment about f\n"
  1059. " f();\n"
  1060. "}",
  1061. format("if (true) { // comment about branch\n"
  1062. " // comment about f\n"
  1063. " f();\n"
  1064. "}",
  1065. getLLVMStyleWithColumns(80)));
  1066. EXPECT_EQ("if (1) { // if line 1\n"
  1067. " // if line 2\n"
  1068. " // if line 3\n"
  1069. " // f line 1\n"
  1070. " // f line 2\n"
  1071. " f();\n"
  1072. "} else { // else line 1\n"
  1073. " // else line 2\n"
  1074. " // else line 3\n"
  1075. " // g line 1\n"
  1076. " g();\n"
  1077. "}",
  1078. format("if (1) { // if line 1\n"
  1079. " // if line 2\n"
  1080. " // if line 3\n"
  1081. " // f line 1\n"
  1082. " // f line 2\n"
  1083. " f();\n"
  1084. "} else { // else line 1\n"
  1085. " // else line 2\n"
  1086. " // else line 3\n"
  1087. " // g line 1\n"
  1088. " g();\n"
  1089. "}"));
  1090. EXPECT_EQ("do { // line 1\n"
  1091. " // line 2\n"
  1092. " // line 3\n"
  1093. " f();\n"
  1094. "} while (true);",
  1095. format("do { // line 1\n"
  1096. " // line 2\n"
  1097. " // line 3\n"
  1098. " f();\n"
  1099. "} while (true);",
  1100. getLLVMStyleWithColumns(80)));
  1101. EXPECT_EQ("while (a < b) { // line 1\n"
  1102. " // line 2\n"
  1103. " // line 3\n"
  1104. " f();\n"
  1105. "}",
  1106. format("while (a < b) {// line 1\n"
  1107. " // line 2\n"
  1108. " // line 3\n"
  1109. " f();\n"
  1110. "}",
  1111. getLLVMStyleWithColumns(80)));
  1112. }
  1113. TEST_F(FormatTestComments, ReflowsComments) {
  1114. // Break a long line and reflow with the full next line.
  1115. EXPECT_EQ("// long long long\n"
  1116. "// long long",
  1117. format("// long long long long\n"
  1118. "// long",
  1119. getLLVMStyleWithColumns(20)));
  1120. // Keep the trailing newline while reflowing.
  1121. EXPECT_EQ("// long long long\n"
  1122. "// long long\n",
  1123. format("// long long long long\n"
  1124. "// long\n",
  1125. getLLVMStyleWithColumns(20)));
  1126. // Break a long line and reflow with a part of the next line.
  1127. EXPECT_EQ("// long long long\n"
  1128. "// long long\n"
  1129. "// long_long",
  1130. format("// long long long long\n"
  1131. "// long long_long",
  1132. getLLVMStyleWithColumns(20)));
  1133. // Break but do not reflow if the first word from the next line is too long.
  1134. EXPECT_EQ("// long long long\n"
  1135. "// long\n"
  1136. "// long_long_long\n",
  1137. format("// long long long long\n"
  1138. "// long_long_long\n",
  1139. getLLVMStyleWithColumns(20)));
  1140. // Don't break or reflow short lines.
  1141. verifyFormat("// long\n"
  1142. "// long long long lo\n"
  1143. "// long long long lo\n"
  1144. "// long",
  1145. getLLVMStyleWithColumns(20));
  1146. // Keep prefixes and decorations while reflowing.
  1147. EXPECT_EQ("/// long long long\n"
  1148. "/// long long\n",
  1149. format("/// long long long long\n"
  1150. "/// long\n",
  1151. getLLVMStyleWithColumns(20)));
  1152. EXPECT_EQ("//! long long long\n"
  1153. "//! long long\n",
  1154. format("//! long long long long\n"
  1155. "//! long\n",
  1156. getLLVMStyleWithColumns(20)));
  1157. EXPECT_EQ("/* long long long\n"
  1158. " * long long */",
  1159. format("/* long long long long\n"
  1160. " * long */",
  1161. getLLVMStyleWithColumns(20)));
  1162. EXPECT_EQ("///< long long long\n"
  1163. "///< long long\n",
  1164. format("///< long long long long\n"
  1165. "///< long\n",
  1166. getLLVMStyleWithColumns(20)));
  1167. EXPECT_EQ("//!< long long long\n"
  1168. "//!< long long\n",
  1169. format("//!< long long long long\n"
  1170. "//!< long\n",
  1171. getLLVMStyleWithColumns(20)));
  1172. // Don't bring leading whitespace up while reflowing.
  1173. EXPECT_EQ("/* long long long\n"
  1174. " * long long long\n"
  1175. " */",
  1176. format("/* long long long long\n"
  1177. " * long long\n"
  1178. " */",
  1179. getLLVMStyleWithColumns(20)));
  1180. // Reflow the last line of a block comment with its trailing '*/'.
  1181. EXPECT_EQ("/* long long long\n"
  1182. " long long */",
  1183. format("/* long long long long\n"
  1184. " long */",
  1185. getLLVMStyleWithColumns(20)));
  1186. // Reflow two short lines; keep the postfix of the last one.
  1187. EXPECT_EQ("/* long long long\n"
  1188. " * long long long */",
  1189. format("/* long long long long\n"
  1190. " * long\n"
  1191. " * long */",
  1192. getLLVMStyleWithColumns(20)));
  1193. // Put the postfix of the last short reflow line on a newline if it doesn't
  1194. // fit.
  1195. EXPECT_EQ("/* long long long\n"
  1196. " * long long longg\n"
  1197. " */",
  1198. format("/* long long long long\n"
  1199. " * long\n"
  1200. " * longg */",
  1201. getLLVMStyleWithColumns(20)));
  1202. // Reflow lines with leading whitespace.
  1203. EXPECT_EQ("{\n"
  1204. " /*\n"
  1205. " * long long long\n"
  1206. " * long long long\n"
  1207. " * long long long\n"
  1208. " */\n"
  1209. "}",
  1210. format("{\n"
  1211. "/*\n"
  1212. " * long long long long\n"
  1213. " * long\n"
  1214. " * long long long long\n"
  1215. " */\n"
  1216. "}",
  1217. getLLVMStyleWithColumns(20)));
  1218. // Break single line block comments that are first in the line with ' *'
  1219. // decoration.
  1220. EXPECT_EQ("/* long long long\n"
  1221. " * long */",
  1222. format("/* long long long long */", getLLVMStyleWithColumns(20)));
  1223. // Break single line block comment that are not first in the line with ' '
  1224. // decoration.
  1225. EXPECT_EQ("int i; /* long long\n"
  1226. " long */",
  1227. format("int i; /* long long long */", getLLVMStyleWithColumns(20)));
  1228. // Reflow a line that goes just over the column limit.
  1229. EXPECT_EQ("// long long long\n"
  1230. "// lon long",
  1231. format("// long long long lon\n"
  1232. "// long",
  1233. getLLVMStyleWithColumns(20)));
  1234. // Stop reflowing if the next line has a different indentation than the
  1235. // previous line.
  1236. EXPECT_EQ("// long long long\n"
  1237. "// long\n"
  1238. "// long long\n"
  1239. "// long",
  1240. format("// long long long long\n"
  1241. "// long long\n"
  1242. "// long",
  1243. getLLVMStyleWithColumns(20)));
  1244. // Reflow into the last part of a really long line that has been broken into
  1245. // multiple lines.
  1246. EXPECT_EQ("// long long long\n"
  1247. "// long long long\n"
  1248. "// long long long\n",
  1249. format("// long long long long long long long long\n"
  1250. "// long\n",
  1251. getLLVMStyleWithColumns(20)));
  1252. // Break the first line, then reflow the beginning of the second and third
  1253. // line up.
  1254. EXPECT_EQ("// long long long\n"
  1255. "// lon1 lon2 lon2\n"
  1256. "// lon2 lon3 lon3",
  1257. format("// long long long lon1\n"
  1258. "// lon2 lon2 lon2\n"
  1259. "// lon3 lon3",
  1260. getLLVMStyleWithColumns(20)));
  1261. // Reflow the beginning of the second line, then break the rest.
  1262. EXPECT_EQ("// long long long\n"
  1263. "// lon1 lon2 lon2\n"
  1264. "// lon2 lon2 lon2\n"
  1265. "// lon3",
  1266. format("// long long long lon1\n"
  1267. "// lon2 lon2 lon2 lon2 lon2 lon3",
  1268. getLLVMStyleWithColumns(20)));
  1269. // Shrink the first line, then reflow the second line up.
  1270. EXPECT_EQ("// long long long", format("// long long\n"
  1271. "// long",
  1272. getLLVMStyleWithColumns(20)));
  1273. // Don't shrink leading whitespace.
  1274. EXPECT_EQ("int i; /// a",
  1275. format("int i; /// a", getLLVMStyleWithColumns(20)));
  1276. // Shrink trailing whitespace if there is no postfix and reflow.
  1277. EXPECT_EQ("// long long long\n"
  1278. "// long long",
  1279. format("// long long long long \n"
  1280. "// long",
  1281. getLLVMStyleWithColumns(20)));
  1282. // Shrink trailing whitespace to a single one if there is postfix.
  1283. EXPECT_EQ("/* long long long */",
  1284. format("/* long long long */", getLLVMStyleWithColumns(20)));
  1285. // Break a block comment postfix if exceeding the line limit.
  1286. EXPECT_EQ("/* long\n"
  1287. " */",
  1288. format("/* long */", getLLVMStyleWithColumns(20)));
  1289. // Reflow indented comments.
  1290. EXPECT_EQ("{\n"
  1291. " // long long long\n"
  1292. " // long long\n"
  1293. " int i; /* long lon\n"
  1294. " g long\n"
  1295. " */\n"
  1296. "}",
  1297. format("{\n"
  1298. " // long long long long\n"
  1299. " // long\n"
  1300. " int i; /* long lon g\n"
  1301. " long */\n"
  1302. "}",
  1303. getLLVMStyleWithColumns(20)));
  1304. // Don't realign trailing comments after reflow has happened.
  1305. EXPECT_EQ("// long long long\n"
  1306. "// long long\n"
  1307. "long i; // long",
  1308. format("// long long long long\n"
  1309. "// long\n"
  1310. "long i; // long",
  1311. getLLVMStyleWithColumns(20)));
  1312. EXPECT_EQ("// long long long\n"
  1313. "// longng long long\n"
  1314. "// long lo",
  1315. format("// long long long longng\n"
  1316. "// long long long\n"
  1317. "// lo",
  1318. getLLVMStyleWithColumns(20)));
  1319. // Reflow lines after a broken line.
  1320. EXPECT_EQ("int a; // Trailing\n"
  1321. " // comment on\n"
  1322. " // 2 or 3\n"
  1323. " // lines.\n",
  1324. format("int a; // Trailing comment\n"
  1325. " // on 2\n"
  1326. " // or 3\n"
  1327. " // lines.\n",
  1328. getLLVMStyleWithColumns(20)));
  1329. EXPECT_EQ("/// This long line\n"
  1330. "/// gets reflown.\n",
  1331. format("/// This long line gets\n"
  1332. "/// reflown.\n",
  1333. getLLVMStyleWithColumns(20)));
  1334. EXPECT_EQ("//! This long line\n"
  1335. "//! gets reflown.\n",
  1336. format(" //! This long line gets\n"
  1337. " //! reflown.\n",
  1338. getLLVMStyleWithColumns(20)));
  1339. EXPECT_EQ("/* This long line\n"
  1340. " * gets reflown.\n"
  1341. " */\n",
  1342. format("/* This long line gets\n"
  1343. " * reflown.\n"
  1344. " */\n",
  1345. getLLVMStyleWithColumns(20)));
  1346. // Reflow after indentation makes a line too long.
  1347. EXPECT_EQ("{\n"
  1348. " // long long long\n"
  1349. " // lo long\n"
  1350. "}\n",
  1351. format("{\n"
  1352. "// long long long lo\n"
  1353. "// long\n"
  1354. "}\n",
  1355. getLLVMStyleWithColumns(20)));
  1356. // Break and reflow multiple lines.
  1357. EXPECT_EQ("/*\n"
  1358. " * Reflow the end of\n"
  1359. " * line by 11 22 33\n"
  1360. " * 4.\n"
  1361. " */\n",
  1362. format("/*\n"
  1363. " * Reflow the end of line\n"
  1364. " * by\n"
  1365. " * 11\n"
  1366. " * 22\n"
  1367. " * 33\n"
  1368. " * 4.\n"
  1369. " */\n",
  1370. getLLVMStyleWithColumns(20)));
  1371. EXPECT_EQ("/// First line gets\n"
  1372. "/// broken. Second\n"
  1373. "/// line gets\n"
  1374. "/// reflown and\n"
  1375. "/// broken. Third\n"
  1376. "/// gets reflown.\n",
  1377. format("/// First line gets broken.\n"
  1378. "/// Second line gets reflown and broken.\n"
  1379. "/// Third gets reflown.\n",
  1380. getLLVMStyleWithColumns(20)));
  1381. EXPECT_EQ("int i; // first long\n"
  1382. " // long snd\n"
  1383. " // long.\n",
  1384. format("int i; // first long long\n"
  1385. " // snd long.\n",
  1386. getLLVMStyleWithColumns(20)));
  1387. EXPECT_EQ("{\n"
  1388. " // first long line\n"
  1389. " // line second\n"
  1390. " // long line line\n"
  1391. " // third long line\n"
  1392. " // line\n"
  1393. "}\n",
  1394. format("{\n"
  1395. " // first long line line\n"
  1396. " // second long line line\n"
  1397. " // third long line line\n"
  1398. "}\n",
  1399. getLLVMStyleWithColumns(20)));
  1400. EXPECT_EQ("int i; /* first line\n"
  1401. " * second\n"
  1402. " * line third\n"
  1403. " * line\n"
  1404. " */",
  1405. format("int i; /* first line\n"
  1406. " * second line\n"
  1407. " * third line\n"
  1408. " */",
  1409. getLLVMStyleWithColumns(20)));
  1410. // Reflow the last two lines of a section that starts with a line having
  1411. // different indentation.
  1412. EXPECT_EQ(
  1413. "// long\n"
  1414. "// long long long\n"
  1415. "// long long",
  1416. format("// long\n"
  1417. "// long long long long\n"
  1418. "// long",
  1419. getLLVMStyleWithColumns(20)));
  1420. // Keep the block comment endling '*/' while reflowing.
  1421. EXPECT_EQ("/* Long long long\n"
  1422. " * line short */\n",
  1423. format("/* Long long long line\n"
  1424. " * short */\n",
  1425. getLLVMStyleWithColumns(20)));
  1426. // Don't reflow between separate blocks of comments.
  1427. EXPECT_EQ("/* First comment\n"
  1428. " * block will */\n"
  1429. "/* Snd\n"
  1430. " */\n",
  1431. format("/* First comment block\n"
  1432. " * will */\n"
  1433. "/* Snd\n"
  1434. " */\n",
  1435. getLLVMStyleWithColumns(20)));
  1436. // Don't reflow across blank comment lines.
  1437. EXPECT_EQ("int i; // This long\n"
  1438. " // line gets\n"
  1439. " // broken.\n"
  1440. " //\n"
  1441. " // keep.\n",
  1442. format("int i; // This long line gets broken.\n"
  1443. " // \n"
  1444. " // keep.\n",
  1445. getLLVMStyleWithColumns(20)));
  1446. EXPECT_EQ("{\n"
  1447. " /// long long long\n"
  1448. " /// long long\n"
  1449. " ///\n"
  1450. " /// long\n"
  1451. "}",
  1452. format("{\n"
  1453. " /// long long long long\n"
  1454. " /// long\n"
  1455. " ///\n"
  1456. " /// long\n"
  1457. "}",
  1458. getLLVMStyleWithColumns(20)));
  1459. EXPECT_EQ("//! long long long\n"
  1460. "//! long\n"
  1461. "\n"
  1462. "//! long",
  1463. format("//! long long long long\n"
  1464. "\n"
  1465. "//! long",
  1466. getLLVMStyleWithColumns(20)));
  1467. EXPECT_EQ("/* long long long\n"
  1468. " long\n"
  1469. "\n"
  1470. " long */",
  1471. format("/* long long long long\n"
  1472. "\n"
  1473. " long */",
  1474. getLLVMStyleWithColumns(20)));
  1475. EXPECT_EQ("/* long long long\n"
  1476. " * long\n"
  1477. " *\n"
  1478. " * long */",
  1479. format("/* long long long long\n"
  1480. " *\n"
  1481. " * long */",
  1482. getLLVMStyleWithColumns(20)));
  1483. // Don't reflow lines having content that is a single character.
  1484. EXPECT_EQ("// long long long\n"
  1485. "// long\n"
  1486. "// l",
  1487. format("// long long long long\n"
  1488. "// l",
  1489. getLLVMStyleWithColumns(20)));
  1490. // Don't reflow lines starting with two punctuation characters.
  1491. EXPECT_EQ("// long long long\n"
  1492. "// long\n"
  1493. "// ... --- ...",
  1494. format(
  1495. "// long long long long\n"
  1496. "// ... --- ...",
  1497. getLLVMStyleWithColumns(20)));
  1498. // Don't reflow lines starting with '@'.
  1499. EXPECT_EQ("// long long long\n"
  1500. "// long\n"
  1501. "// @param arg",
  1502. format("// long long long long\n"
  1503. "// @param arg",
  1504. getLLVMStyleWithColumns(20)));
  1505. // Don't reflow lines starting with 'TODO'.
  1506. EXPECT_EQ("// long long long\n"
  1507. "// long\n"
  1508. "// TODO: long",
  1509. format("// long long long long\n"
  1510. "// TODO: long",
  1511. getLLVMStyleWithColumns(20)));
  1512. // Don't reflow lines starting with 'FIXME'.
  1513. EXPECT_EQ("// long long long\n"
  1514. "// long\n"
  1515. "// FIXME: long",
  1516. format("// long long long long\n"
  1517. "// FIXME: long",
  1518. getLLVMStyleWithColumns(20)));
  1519. // Don't reflow lines starting with 'XXX'.
  1520. EXPECT_EQ("// long long long\n"
  1521. "// long\n"
  1522. "// XXX: long",
  1523. format("// long long long long\n"
  1524. "// XXX: long",
  1525. getLLVMStyleWithColumns(20)));
  1526. // Don't reflow comment pragmas.
  1527. EXPECT_EQ("// long long long\n"
  1528. "// long\n"
  1529. "// IWYU pragma:",
  1530. format("// long long long long\n"
  1531. "// IWYU pragma:",
  1532. getLLVMStyleWithColumns(20)));
  1533. EXPECT_EQ("/* long long long\n"
  1534. " * long\n"
  1535. " * IWYU pragma:\n"
  1536. " */",
  1537. format("/* long long long long\n"
  1538. " * IWYU pragma:\n"
  1539. " */",
  1540. getLLVMStyleWithColumns(20)));
  1541. // Reflow lines that have a non-punctuation character among their first 2
  1542. // characters.
  1543. EXPECT_EQ("// long long long\n"
  1544. "// long 'long'",
  1545. format(
  1546. "// long long long long\n"
  1547. "// 'long'",
  1548. getLLVMStyleWithColumns(20)));
  1549. // Don't reflow between separate blocks of comments.
  1550. EXPECT_EQ("/* First comment\n"
  1551. " * block will */\n"
  1552. "/* Snd\n"
  1553. " */\n",
  1554. format("/* First comment block\n"
  1555. " * will */\n"
  1556. "/* Snd\n"
  1557. " */\n",
  1558. getLLVMStyleWithColumns(20)));
  1559. // Don't reflow lines having different indentation.
  1560. EXPECT_EQ("// long long long\n"
  1561. "// long\n"
  1562. "// long",
  1563. format("// long long long long\n"
  1564. "// long",
  1565. getLLVMStyleWithColumns(20)));
  1566. // Don't reflow separate bullets in list
  1567. EXPECT_EQ("// - long long long\n"
  1568. "// long\n"
  1569. "// - long",
  1570. format("// - long long long long\n"
  1571. "// - long",
  1572. getLLVMStyleWithColumns(20)));
  1573. EXPECT_EQ("// * long long long\n"
  1574. "// long\n"
  1575. "// * long",
  1576. format("// * long long long long\n"
  1577. "// * long",
  1578. getLLVMStyleWithColumns(20)));
  1579. EXPECT_EQ("// + long long long\n"
  1580. "// long\n"
  1581. "// + long",
  1582. format("// + long long long long\n"
  1583. "// + long",
  1584. getLLVMStyleWithColumns(20)));
  1585. EXPECT_EQ("// 1. long long long\n"
  1586. "// long\n"
  1587. "// 2. long",
  1588. format("// 1. long long long long\n"
  1589. "// 2. long",
  1590. getLLVMStyleWithColumns(20)));
  1591. EXPECT_EQ("// -# long long long\n"
  1592. "// long\n"
  1593. "// -# long",
  1594. format("// -# long long long long\n"
  1595. "// -# long",
  1596. getLLVMStyleWithColumns(20)));
  1597. EXPECT_EQ("// - long long long\n"
  1598. "// long long long\n"
  1599. "// - long",
  1600. format("// - long long long long\n"
  1601. "// long long\n"
  1602. "// - long",
  1603. getLLVMStyleWithColumns(20)));
  1604. EXPECT_EQ("// - long long long\n"
  1605. "// long long long\n"
  1606. "// long\n"
  1607. "// - long",
  1608. format("// - long long long long\n"
  1609. "// long long long\n"
  1610. "// - long",
  1611. getLLVMStyleWithColumns(20)));
  1612. // Large number (>2 digits) are not list items
  1613. EXPECT_EQ("// long long long\n"
  1614. "// long 1024. long.",
  1615. format("// long long long long\n"
  1616. "// 1024. long.",
  1617. getLLVMStyleWithColumns(20)));
  1618. // Do not break before number, to avoid introducing a non-reflowable doxygen
  1619. // list item.
  1620. EXPECT_EQ("// long long\n"
  1621. "// long 10. long.",
  1622. format("// long long long 10.\n"
  1623. "// long.",
  1624. getLLVMStyleWithColumns(20)));
  1625. // Don't break or reflow after implicit string literals.
  1626. verifyFormat("#include <t> // l l l\n"
  1627. " // l",
  1628. getLLVMStyleWithColumns(20));
  1629. // Don't break or reflow comments on import lines.
  1630. EXPECT_EQ("#include \"t\" /* l l l\n"
  1631. " * l */",
  1632. format("#include \"t\" /* l l l\n"
  1633. " * l */",
  1634. getLLVMStyleWithColumns(20)));
  1635. // Don't reflow between different trailing comment sections.
  1636. EXPECT_EQ("int i; // long long\n"
  1637. " // long\n"
  1638. "int j; // long long\n"
  1639. " // long\n",
  1640. format("int i; // long long long\n"
  1641. "int j; // long long long\n",
  1642. getLLVMStyleWithColumns(20)));
  1643. // Don't reflow if the first word on the next line is longer than the
  1644. // available space at current line.
  1645. EXPECT_EQ("int i; // trigger\n"
  1646. " // reflow\n"
  1647. " // longsec\n",
  1648. format("int i; // trigger reflow\n"
  1649. " // longsec\n",
  1650. getLLVMStyleWithColumns(20)));
  1651. // Keep empty comment lines.
  1652. EXPECT_EQ("/**/", format(" /**/", getLLVMStyleWithColumns(20)));
  1653. EXPECT_EQ("/* */", format(" /* */", getLLVMStyleWithColumns(20)));
  1654. EXPECT_EQ("/* */", format(" /* */", getLLVMStyleWithColumns(20)));
  1655. EXPECT_EQ("//", format(" // ", getLLVMStyleWithColumns(20)));
  1656. EXPECT_EQ("///", format(" /// ", getLLVMStyleWithColumns(20)));
  1657. }
  1658. TEST_F(FormatTestComments, IgnoresIf0Contents) {
  1659. EXPECT_EQ("#if 0\n"
  1660. "}{)(&*(^%%#%@! fsadj f;ldjs ,:;| <<<>>>][)(][\n"
  1661. "#endif\n"
  1662. "void f() {}",
  1663. format("#if 0\n"
  1664. "}{)(&*(^%%#%@! fsadj f;ldjs ,:;| <<<>>>][)(][\n"
  1665. "#endif\n"
  1666. "void f( ) { }"));
  1667. EXPECT_EQ("#if false\n"
  1668. "void f( ) { }\n"
  1669. "#endif\n"
  1670. "void g() {}\n",
  1671. format("#if false\n"
  1672. "void f( ) { }\n"
  1673. "#endif\n"
  1674. "void g( ) { }\n"));
  1675. EXPECT_EQ("enum E {\n"
  1676. " One,\n"
  1677. " Two,\n"
  1678. "#if 0\n"
  1679. "Three,\n"
  1680. " Four,\n"
  1681. "#endif\n"
  1682. " Five\n"
  1683. "};",
  1684. format("enum E {\n"
  1685. " One,Two,\n"
  1686. "#if 0\n"
  1687. "Three,\n"
  1688. " Four,\n"
  1689. "#endif\n"
  1690. " Five};"));
  1691. EXPECT_EQ("enum F {\n"
  1692. " One,\n"
  1693. "#if 1\n"
  1694. " Two,\n"
  1695. "#if 0\n"
  1696. "Three,\n"
  1697. " Four,\n"
  1698. "#endif\n"
  1699. " Five\n"
  1700. "#endif\n"
  1701. "};",
  1702. format("enum F {\n"
  1703. "One,\n"
  1704. "#if 1\n"
  1705. "Two,\n"
  1706. "#if 0\n"
  1707. "Three,\n"
  1708. " Four,\n"
  1709. "#endif\n"
  1710. "Five\n"
  1711. "#endif\n"
  1712. "};"));
  1713. EXPECT_EQ("enum G {\n"
  1714. " One,\n"
  1715. "#if 0\n"
  1716. "Two,\n"
  1717. "#else\n"
  1718. " Three,\n"
  1719. "#endif\n"
  1720. " Four\n"
  1721. "};",
  1722. format("enum G {\n"
  1723. "One,\n"
  1724. "#if 0\n"
  1725. "Two,\n"
  1726. "#else\n"
  1727. "Three,\n"
  1728. "#endif\n"
  1729. "Four\n"
  1730. "};"));
  1731. EXPECT_EQ("enum H {\n"
  1732. " One,\n"
  1733. "#if 0\n"
  1734. "#ifdef Q\n"
  1735. "Two,\n"
  1736. "#else\n"
  1737. "Three,\n"
  1738. "#endif\n"
  1739. "#endif\n"
  1740. " Four\n"
  1741. "};",
  1742. format("enum H {\n"
  1743. "One,\n"
  1744. "#if 0\n"
  1745. "#ifdef Q\n"
  1746. "Two,\n"
  1747. "#else\n"
  1748. "Three,\n"
  1749. "#endif\n"
  1750. "#endif\n"
  1751. "Four\n"
  1752. "};"));
  1753. EXPECT_EQ("enum I {\n"
  1754. " One,\n"
  1755. "#if /* test */ 0 || 1\n"
  1756. "Two,\n"
  1757. "Three,\n"
  1758. "#endif\n"
  1759. " Four\n"
  1760. "};",
  1761. format("enum I {\n"
  1762. "One,\n"
  1763. "#if /* test */ 0 || 1\n"
  1764. "Two,\n"
  1765. "Three,\n"
  1766. "#endif\n"
  1767. "Four\n"
  1768. "};"));
  1769. EXPECT_EQ("enum J {\n"
  1770. " One,\n"
  1771. "#if 0\n"
  1772. "#if 0\n"
  1773. "Two,\n"
  1774. "#else\n"
  1775. "Three,\n"
  1776. "#endif\n"
  1777. "Four,\n"
  1778. "#endif\n"
  1779. " Five\n"
  1780. "};",
  1781. format("enum J {\n"
  1782. "One,\n"
  1783. "#if 0\n"
  1784. "#if 0\n"
  1785. "Two,\n"
  1786. "#else\n"
  1787. "Three,\n"
  1788. "#endif\n"
  1789. "Four,\n"
  1790. "#endif\n"
  1791. "Five\n"
  1792. "};"));
  1793. // Ignore stuff in SWIG-blocks.
  1794. EXPECT_EQ("#ifdef SWIG\n"
  1795. "}{)(&*(^%%#%@! fsadj f;ldjs ,:;| <<<>>>][)(][\n"
  1796. "#endif\n"
  1797. "void f() {}",
  1798. format("#ifdef SWIG\n"
  1799. "}{)(&*(^%%#%@! fsadj f;ldjs ,:;| <<<>>>][)(][\n"
  1800. "#endif\n"
  1801. "void f( ) { }"));
  1802. EXPECT_EQ("#ifndef SWIG\n"
  1803. "void f() {}\n"
  1804. "#endif",
  1805. format("#ifndef SWIG\n"
  1806. "void f( ) { }\n"
  1807. "#endif"));
  1808. }
  1809. TEST_F(FormatTestComments, DontCrashOnBlockComments) {
  1810. EXPECT_EQ(
  1811. "int xxxxxxxxx; /* "
  1812. "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy\n"
  1813. "zzzzzz\n"
  1814. "0*/",
  1815. format("int xxxxxxxxx; /* "
  1816. "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy zzzzzz\n"
  1817. "0*/"));
  1818. }
  1819. TEST_F(FormatTestComments, BlockCommentsInControlLoops) {
  1820. verifyFormat("if (0) /* a comment in a strange place */ {\n"
  1821. " f();\n"
  1822. "}");
  1823. verifyFormat("if (0) /* a comment in a strange place */ {\n"
  1824. " f();\n"
  1825. "} /* another comment */ else /* comment #3 */ {\n"
  1826. " g();\n"
  1827. "}");
  1828. verifyFormat("while (0) /* a comment in a strange place */ {\n"
  1829. " f();\n"
  1830. "}");
  1831. verifyFormat("for (;;) /* a comment in a strange place */ {\n"
  1832. " f();\n"
  1833. "}");
  1834. verifyFormat("do /* a comment in a strange place */ {\n"
  1835. " f();\n"
  1836. "} /* another comment */ while (0);");
  1837. }
  1838. TEST_F(FormatTestComments, BlockComments) {
  1839. EXPECT_EQ("/* */ /* */ /* */\n/* */ /* */ /* */",
  1840. format("/* *//* */ /* */\n/* *//* */ /* */"));
  1841. EXPECT_EQ("/* */ a /* */ b;", format(" /* */ a/* */ b;"));
  1842. EXPECT_EQ("#define A /*123*/ \\\n"
  1843. " b\n"
  1844. "/* */\n"
  1845. "someCall(\n"
  1846. " parameter);",
  1847. format("#define A /*123*/ b\n"
  1848. "/* */\n"
  1849. "someCall(parameter);",
  1850. getLLVMStyleWithColumns(15)));
  1851. EXPECT_EQ("#define A\n"
  1852. "/* */ someCall(\n"
  1853. " parameter);",
  1854. format("#define A\n"
  1855. "/* */someCall(parameter);",
  1856. getLLVMStyleWithColumns(15)));
  1857. EXPECT_EQ("/*\n**\n*/", format("/*\n**\n*/"));
  1858. EXPECT_EQ("/*\n"
  1859. " *\n"
  1860. " * aaaaaa\n"
  1861. " * aaaaaa\n"
  1862. " */",
  1863. format("/*\n"
  1864. "*\n"
  1865. " * aaaaaa aaaaaa\n"
  1866. "*/",
  1867. getLLVMStyleWithColumns(10)));
  1868. EXPECT_EQ("/*\n"
  1869. "**\n"
  1870. "* aaaaaa\n"
  1871. "*aaaaaa\n"
  1872. "*/",
  1873. format("/*\n"
  1874. "**\n"
  1875. "* aaaaaa aaaaaa\n"
  1876. "*/",
  1877. getLLVMStyleWithColumns(10)));
  1878. EXPECT_EQ("int aaaaaaaaaaaaaaaaaaaaaaaaaaaa =\n"
  1879. " /* line 1\n"
  1880. " bbbbbbbbbbbb */\n"
  1881. " bbbbbbbbbbbbbbbbbbbbbbbbbbbb;",
  1882. format("int aaaaaaaaaaaaaaaaaaaaaaaaaaaa =\n"
  1883. " /* line 1\n"
  1884. " bbbbbbbbbbbb */ bbbbbbbbbbbbbbbbbbbbbbbbbbbb;",
  1885. getLLVMStyleWithColumns(50)));
  1886. FormatStyle NoBinPacking = getLLVMStyle();
  1887. NoBinPacking.BinPackParameters = false;
  1888. EXPECT_EQ("someFunction(1, /* comment 1 */\n"
  1889. " 2, /* comment 2 */\n"
  1890. " 3, /* comment 3 */\n"
  1891. " aaaa,\n"
  1892. " bbbb);",
  1893. format("someFunction (1, /* comment 1 */\n"
  1894. " 2, /* comment 2 */ \n"
  1895. " 3, /* comment 3 */\n"
  1896. "aaaa, bbbb );",
  1897. NoBinPacking));
  1898. verifyFormat(
  1899. "bool aaaaaaaaaaaaa = /* comment: */ aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ||\n"
  1900. " aaaaaaaaaaaaaaaaaaaaaaaaaaaa;");
  1901. EXPECT_EQ(
  1902. "bool aaaaaaaaaaaaa = /* trailing comment */\n"
  1903. " aaaaaaaaaaaaaaaaaaaaaaaaaaa || aaaaaaaaaaaaaaaaaaaaaaaaa ||\n"
  1904. " aaaaaaaaaaaaaaaaaaaaaaaaaaaa || aaaaaaaaaaaaaaaaaaaaaaaaaa;",
  1905. format(
  1906. "bool aaaaaaaaaaaaa = /* trailing comment */\n"
  1907. " aaaaaaaaaaaaaaaaaaaaaaaaaaa||aaaaaaaaaaaaaaaaaaaaaaaaa ||\n"
  1908. " aaaaaaaaaaaaaaaaaaaaaaaaaaaa || aaaaaaaaaaaaaaaaaaaaaaaaaa;"));
  1909. EXPECT_EQ(
  1910. "int aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa; /* comment */\n"
  1911. "int bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb; /* comment */\n"
  1912. "int cccccccccccccccccccccccccccccc; /* comment */\n",
  1913. format("int aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa; /* comment */\n"
  1914. "int bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb; /* comment */\n"
  1915. "int cccccccccccccccccccccccccccccc; /* comment */\n"));
  1916. verifyFormat("void f(int * /* unused */) {}");
  1917. EXPECT_EQ("/*\n"
  1918. " **\n"
  1919. " */",
  1920. format("/*\n"
  1921. " **\n"
  1922. " */"));
  1923. EXPECT_EQ("/*\n"
  1924. " *q\n"
  1925. " */",
  1926. format("/*\n"
  1927. " *q\n"
  1928. " */"));
  1929. EXPECT_EQ("/*\n"
  1930. " * q\n"
  1931. " */",
  1932. format("/*\n"
  1933. " * q\n"
  1934. " */"));
  1935. EXPECT_EQ("/*\n"
  1936. " **/",
  1937. format("/*\n"
  1938. " **/"));
  1939. EXPECT_EQ("/*\n"
  1940. " ***/",
  1941. format("/*\n"
  1942. " ***/"));
  1943. }
  1944. TEST_F(FormatTestComments, BlockCommentsInMacros) {
  1945. EXPECT_EQ("#define A \\\n"
  1946. " { \\\n"
  1947. " /* one line */ \\\n"
  1948. " someCall();",
  1949. format("#define A { \\\n"
  1950. " /* one line */ \\\n"
  1951. " someCall();",
  1952. getLLVMStyleWithColumns(20)));
  1953. EXPECT_EQ("#define A \\\n"
  1954. " { \\\n"
  1955. " /* previous */ \\\n"
  1956. " /* one line */ \\\n"
  1957. " someCall();",
  1958. format("#define A { \\\n"
  1959. " /* previous */ \\\n"
  1960. " /* one line */ \\\n"
  1961. " someCall();",
  1962. getLLVMStyleWithColumns(20)));
  1963. }
  1964. TEST_F(FormatTestComments, BlockCommentsAtEndOfLine) {
  1965. EXPECT_EQ("a = {\n"
  1966. " 1111 /* */\n"
  1967. "};",
  1968. format("a = {1111 /* */\n"
  1969. "};",
  1970. getLLVMStyleWithColumns(15)));
  1971. EXPECT_EQ("a = {\n"
  1972. " 1111 /* */\n"
  1973. "};",
  1974. format("a = {1111 /* */\n"
  1975. "};",
  1976. getLLVMStyleWithColumns(15)));
  1977. EXPECT_EQ("a = {\n"
  1978. " 1111 /* a\n"
  1979. " */\n"
  1980. "};",
  1981. format("a = {1111 /* a */\n"
  1982. "};",
  1983. getLLVMStyleWithColumns(15)));
  1984. }
  1985. TEST_F(FormatTestComments, IndentLineCommentsInStartOfBlockAtEndOfFile) {
  1986. verifyFormat("{\n"
  1987. " // a\n"
  1988. " // b");
  1989. }
  1990. TEST_F(FormatTestComments, AlignTrailingComments) {
  1991. EXPECT_EQ("#define MACRO(V) \\\n"
  1992. " V(Rt2) /* one more char */ \\\n"
  1993. " V(Rs) /* than here */ \\\n"
  1994. "/* comment 3 */\n",
  1995. format("#define MACRO(V)\\\n"
  1996. "V(Rt2) /* one more char */ \\\n"
  1997. "V(Rs) /* than here */ \\\n"
  1998. "/* comment 3 */\n",
  1999. getLLVMStyleWithColumns(40)));
  2000. EXPECT_EQ("int i = f(abc, // line 1\n"
  2001. " d, // line 2\n"
  2002. " // line 3\n"
  2003. " b);",
  2004. format("int i = f(abc, // line 1\n"
  2005. " d, // line 2\n"
  2006. " // line 3\n"
  2007. " b);",
  2008. getLLVMStyleWithColumns(40)));
  2009. // Align newly broken trailing comments.
  2010. EXPECT_EQ("int ab; // line\n"
  2011. "int a; // long\n"
  2012. " // long\n",
  2013. format("int ab; // line\n"
  2014. "int a; // long long\n",
  2015. getLLVMStyleWithColumns(15)));
  2016. EXPECT_EQ("int ab; // line\n"
  2017. "int a; // long\n"
  2018. " // long\n"
  2019. " // long",
  2020. format("int ab; // line\n"
  2021. "int a; // long long\n"
  2022. " // long",
  2023. getLLVMStyleWithColumns(15)));
  2024. EXPECT_EQ("int ab; // line\n"
  2025. "int a; // long\n"
  2026. " // long\n"
  2027. "pt c; // long",
  2028. format("int ab; // line\n"
  2029. "int a; // long long\n"
  2030. "pt c; // long",
  2031. getLLVMStyleWithColumns(15)));
  2032. EXPECT_EQ("int ab; // line\n"
  2033. "int a; // long\n"
  2034. " // long\n"
  2035. "\n"
  2036. "// long",
  2037. format("int ab; // line\n"
  2038. "int a; // long long\n"
  2039. "\n"
  2040. "// long",
  2041. getLLVMStyleWithColumns(15)));
  2042. // Align comment line sections aligned with the next token with the next
  2043. // token.
  2044. EXPECT_EQ("class A {\n"
  2045. "public: // public comment\n"
  2046. " // comment about a\n"
  2047. " int a;\n"
  2048. "};",
  2049. format("class A {\n"
  2050. "public: // public comment\n"
  2051. " // comment about a\n"
  2052. " int a;\n"
  2053. "};",
  2054. getLLVMStyleWithColumns(40)));
  2055. EXPECT_EQ("class A {\n"
  2056. "public: // public comment 1\n"
  2057. " // public comment 2\n"
  2058. " // comment 1 about a\n"
  2059. " // comment 2 about a\n"
  2060. " int a;\n"
  2061. "};",
  2062. format("class A {\n"
  2063. "public: // public comment 1\n"
  2064. " // public comment 2\n"
  2065. " // comment 1 about a\n"
  2066. " // comment 2 about a\n"
  2067. " int a;\n"
  2068. "};",
  2069. getLLVMStyleWithColumns(40)));
  2070. EXPECT_EQ("int f(int n) { // comment line 1 on f\n"
  2071. " // comment line 2 on f\n"
  2072. " // comment line 1 before return\n"
  2073. " // comment line 2 before return\n"
  2074. " return n; // comment line 1 on return\n"
  2075. " // comment line 2 on return\n"
  2076. " // comment line 1 after return\n"
  2077. "}",
  2078. format("int f(int n) { // comment line 1 on f\n"
  2079. " // comment line 2 on f\n"
  2080. " // comment line 1 before return\n"
  2081. " // comment line 2 before return\n"
  2082. " return n; // comment line 1 on return\n"
  2083. " // comment line 2 on return\n"
  2084. " // comment line 1 after return\n"
  2085. "}",
  2086. getLLVMStyleWithColumns(40)));
  2087. EXPECT_EQ("int f(int n) {\n"
  2088. " switch (n) { // comment line 1 on switch\n"
  2089. " // comment line 2 on switch\n"
  2090. " // comment line 1 before case 1\n"
  2091. " // comment line 2 before case 1\n"
  2092. " case 1: // comment line 1 on case 1\n"
  2093. " // comment line 2 on case 1\n"
  2094. " // comment line 1 before return 1\n"
  2095. " // comment line 2 before return 1\n"
  2096. " return 1; // comment line 1 on return 1\n"
  2097. " // comment line 2 on return 1\n"
  2098. " // comment line 1 before default\n"
  2099. " // comment line 2 before default\n"
  2100. " default: // comment line 1 on default\n"
  2101. " // comment line 2 on default\n"
  2102. " // comment line 1 before return 2\n"
  2103. " return 2 * f(n - 1); // comment line 1 on return 2\n"
  2104. " // comment line 2 on return 2\n"
  2105. " // comment line 1 after return\n"
  2106. " // comment line 2 after return\n"
  2107. " }\n"
  2108. "}",
  2109. format("int f(int n) {\n"
  2110. " switch (n) { // comment line 1 on switch\n"
  2111. " // comment line 2 on switch\n"
  2112. " // comment line 1 before case 1\n"
  2113. " // comment line 2 before case 1\n"
  2114. " case 1: // comment line 1 on case 1\n"
  2115. " // comment line 2 on case 1\n"
  2116. " // comment line 1 before return 1\n"
  2117. " // comment line 2 before return 1\n"
  2118. " return 1; // comment line 1 on return 1\n"
  2119. " // comment line 2 on return 1\n"
  2120. " // comment line 1 before default\n"
  2121. " // comment line 2 before default\n"
  2122. " default: // comment line 1 on default\n"
  2123. " // comment line 2 on default\n"
  2124. " // comment line 1 before return 2\n"
  2125. " return 2 * f(n - 1); // comment line 1 on return 2\n"
  2126. " // comment line 2 on return 2\n"
  2127. " // comment line 1 after return\n"
  2128. " // comment line 2 after return\n"
  2129. " }\n"
  2130. "}",
  2131. getLLVMStyleWithColumns(80)));
  2132. // If all the lines in a sequence of line comments are aligned with the next
  2133. // token, the first line belongs to the previous token and the other lines
  2134. // belong to the next token.
  2135. EXPECT_EQ("int a; // line about a\n"
  2136. "long b;",
  2137. format("int a; // line about a\n"
  2138. " long b;",
  2139. getLLVMStyleWithColumns(80)));
  2140. EXPECT_EQ("int a; // line about a\n"
  2141. "// line about b\n"
  2142. "long b;",
  2143. format("int a; // line about a\n"
  2144. " // line about b\n"
  2145. " long b;",
  2146. getLLVMStyleWithColumns(80)));
  2147. EXPECT_EQ("int a; // line about a\n"
  2148. "// line 1 about b\n"
  2149. "// line 2 about b\n"
  2150. "long b;",
  2151. format("int a; // line about a\n"
  2152. " // line 1 about b\n"
  2153. " // line 2 about b\n"
  2154. " long b;",
  2155. getLLVMStyleWithColumns(80)));
  2156. }
  2157. TEST_F(FormatTestComments, AlignsBlockCommentDecorations) {
  2158. EXPECT_EQ("/*\n"
  2159. " */",
  2160. format("/*\n"
  2161. "*/", getLLVMStyle()));
  2162. EXPECT_EQ("/*\n"
  2163. " */",
  2164. format("/*\n"
  2165. " */", getLLVMStyle()));
  2166. EXPECT_EQ("/*\n"
  2167. " */",
  2168. format("/*\n"
  2169. " */", getLLVMStyle()));
  2170. // Align a single line.
  2171. EXPECT_EQ("/*\n"
  2172. " * line */",
  2173. format("/*\n"
  2174. "* line */",
  2175. getLLVMStyle()));
  2176. EXPECT_EQ("/*\n"
  2177. " * line */",
  2178. format("/*\n"
  2179. " * line */",
  2180. getLLVMStyle()));
  2181. EXPECT_EQ("/*\n"
  2182. " * line */",
  2183. format("/*\n"
  2184. " * line */",
  2185. getLLVMStyle()));
  2186. EXPECT_EQ("/*\n"
  2187. " * line */",
  2188. format("/*\n"
  2189. " * line */",
  2190. getLLVMStyle()));
  2191. EXPECT_EQ("/**\n"
  2192. " * line */",
  2193. format("/**\n"
  2194. "* line */",
  2195. getLLVMStyle()));
  2196. EXPECT_EQ("/**\n"
  2197. " * line */",
  2198. format("/**\n"
  2199. " * line */",
  2200. getLLVMStyle()));
  2201. EXPECT_EQ("/**\n"
  2202. " * line */",
  2203. format("/**\n"
  2204. " * line */",
  2205. getLLVMStyle()));
  2206. EXPECT_EQ("/**\n"
  2207. " * line */",
  2208. format("/**\n"
  2209. " * line */",
  2210. getLLVMStyle()));
  2211. EXPECT_EQ("/**\n"
  2212. " * line */",
  2213. format("/**\n"
  2214. " * line */",
  2215. getLLVMStyle()));
  2216. // Align the end '*/' after a line.
  2217. EXPECT_EQ("/*\n"
  2218. " * line\n"
  2219. " */",
  2220. format("/*\n"
  2221. "* line\n"
  2222. "*/", getLLVMStyle()));
  2223. EXPECT_EQ("/*\n"
  2224. " * line\n"
  2225. " */",
  2226. format("/*\n"
  2227. " * line\n"
  2228. " */", getLLVMStyle()));
  2229. EXPECT_EQ("/*\n"
  2230. " * line\n"
  2231. " */",
  2232. format("/*\n"
  2233. " * line\n"
  2234. " */", getLLVMStyle()));
  2235. // Align two lines.
  2236. EXPECT_EQ("/* line 1\n"
  2237. " * line 2 */",
  2238. format("/* line 1\n"
  2239. " * line 2 */",
  2240. getLLVMStyle()));
  2241. EXPECT_EQ("/* line 1\n"
  2242. " * line 2 */",
  2243. format("/* line 1\n"
  2244. "* line 2 */",
  2245. getLLVMStyle()));
  2246. EXPECT_EQ("/* line 1\n"
  2247. " * line 2 */",
  2248. format("/* line 1\n"
  2249. " * line 2 */",
  2250. getLLVMStyle()));
  2251. EXPECT_EQ("/* line 1\n"
  2252. " * line 2 */",
  2253. format("/* line 1\n"
  2254. " * line 2 */",
  2255. getLLVMStyle()));
  2256. EXPECT_EQ("/* line 1\n"
  2257. " * line 2 */",
  2258. format("/* line 1\n"
  2259. " * line 2 */",
  2260. getLLVMStyle()));
  2261. EXPECT_EQ("int i; /* line 1\n"
  2262. " * line 2 */",
  2263. format("int i; /* line 1\n"
  2264. "* line 2 */",
  2265. getLLVMStyle()));
  2266. EXPECT_EQ("int i; /* line 1\n"
  2267. " * line 2 */",
  2268. format("int i; /* line 1\n"
  2269. " * line 2 */",
  2270. getLLVMStyle()));
  2271. EXPECT_EQ("int i; /* line 1\n"
  2272. " * line 2 */",
  2273. format("int i; /* line 1\n"
  2274. " * line 2 */",
  2275. getLLVMStyle()));
  2276. // Align several lines.
  2277. EXPECT_EQ("/* line 1\n"
  2278. " * line 2\n"
  2279. " * line 3 */",
  2280. format("/* line 1\n"
  2281. " * line 2\n"
  2282. "* line 3 */",
  2283. getLLVMStyle()));
  2284. EXPECT_EQ("/* line 1\n"
  2285. " * line 2\n"
  2286. " * line 3 */",
  2287. format("/* line 1\n"
  2288. " * line 2\n"
  2289. "* line 3 */",
  2290. getLLVMStyle()));
  2291. EXPECT_EQ("/*\n"
  2292. "** line 1\n"
  2293. "** line 2\n"
  2294. "*/",
  2295. format("/*\n"
  2296. "** line 1\n"
  2297. " ** line 2\n"
  2298. "*/",
  2299. getLLVMStyle()));
  2300. // Align with different indent after the decorations.
  2301. EXPECT_EQ("/*\n"
  2302. " * line 1\n"
  2303. " * line 2\n"
  2304. " * line 3\n"
  2305. " * line 4\n"
  2306. " */",
  2307. format("/*\n"
  2308. "* line 1\n"
  2309. " * line 2\n"
  2310. " * line 3\n"
  2311. "* line 4\n"
  2312. "*/", getLLVMStyle()));
  2313. // Align empty or blank lines.
  2314. EXPECT_EQ("/**\n"
  2315. " *\n"
  2316. " *\n"
  2317. " *\n"
  2318. " */",
  2319. format("/**\n"
  2320. "* \n"
  2321. " * \n"
  2322. " *\n"
  2323. "*/", getLLVMStyle()));
  2324. // Align while breaking and reflowing.
  2325. EXPECT_EQ("/*\n"
  2326. " * long long long\n"
  2327. " * long long\n"
  2328. " *\n"
  2329. " * long */",
  2330. format("/*\n"
  2331. " * long long long long\n"
  2332. " * long\n"
  2333. " *\n"
  2334. "* long */",
  2335. getLLVMStyleWithColumns(20)));
  2336. }
  2337. } // end namespace
  2338. } // end namespace format
  2339. } // end namespace clang