FormatVariadicTest.cpp 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690
  1. //===- FormatVariadicTest.cpp - Unit tests for string formatting ----------===//
  2. //
  3. // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
  4. // See https://llvm.org/LICENSE.txt for license information.
  5. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
  6. //
  7. //===----------------------------------------------------------------------===//
  8. #include "llvm/Support/FormatVariadic.h"
  9. #include "llvm/Support/Error.h"
  10. #include "llvm/Support/FormatAdapters.h"
  11. #include "gtest/gtest.h"
  12. using namespace llvm;
  13. // Compile-time tests templates in the detail namespace.
  14. namespace {
  15. struct Format : public FormatAdapter<int> {
  16. Format(int N) : FormatAdapter<int>(std::move(N)) {}
  17. void format(raw_ostream &OS, StringRef Opt) override { OS << "Format"; }
  18. };
  19. using detail::uses_format_member;
  20. using detail::uses_missing_provider;
  21. static_assert(uses_format_member<Format>::value, "");
  22. static_assert(uses_format_member<Format &>::value, "");
  23. static_assert(uses_format_member<Format &&>::value, "");
  24. static_assert(uses_format_member<const Format>::value, "");
  25. static_assert(uses_format_member<const Format &>::value, "");
  26. static_assert(uses_format_member<const volatile Format>::value, "");
  27. static_assert(uses_format_member<const volatile Format &>::value, "");
  28. struct NoFormat {};
  29. static_assert(uses_missing_provider<NoFormat>::value, "");
  30. }
  31. TEST(FormatVariadicTest, EmptyFormatString) {
  32. auto Replacements = formatv_object_base::parseFormatString("");
  33. EXPECT_EQ(0U, Replacements.size());
  34. }
  35. TEST(FormatVariadicTest, NoReplacements) {
  36. const StringRef kFormatString = "This is a test";
  37. auto Replacements = formatv_object_base::parseFormatString(kFormatString);
  38. ASSERT_EQ(1U, Replacements.size());
  39. EXPECT_EQ(kFormatString, Replacements[0].Spec);
  40. EXPECT_EQ(ReplacementType::Literal, Replacements[0].Type);
  41. }
  42. TEST(FormatVariadicTest, EscapedBrace) {
  43. // {{ should be replaced with {
  44. auto Replacements = formatv_object_base::parseFormatString("{{");
  45. ASSERT_EQ(1u, Replacements.size());
  46. EXPECT_EQ("{", Replacements[0].Spec);
  47. EXPECT_EQ(ReplacementType::Literal, Replacements[0].Type);
  48. // An even number N of braces should be replaced with N/2 braces.
  49. Replacements = formatv_object_base::parseFormatString("{{{{{{");
  50. ASSERT_EQ(1u, Replacements.size());
  51. EXPECT_EQ("{{{", Replacements[0].Spec);
  52. EXPECT_EQ(ReplacementType::Literal, Replacements[0].Type);
  53. }
  54. TEST(FormatVariadicTest, ValidReplacementSequence) {
  55. // 1. Simple replacement - parameter index only
  56. auto Replacements = formatv_object_base::parseFormatString("{0}");
  57. ASSERT_EQ(1u, Replacements.size());
  58. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  59. EXPECT_EQ(0u, Replacements[0].Index);
  60. EXPECT_EQ(0u, Replacements[0].Align);
  61. EXPECT_EQ("", Replacements[0].Options);
  62. Replacements = formatv_object_base::parseFormatString("{1}");
  63. ASSERT_EQ(1u, Replacements.size());
  64. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  65. EXPECT_EQ(1u, Replacements[0].Index);
  66. EXPECT_EQ(0u, Replacements[0].Align);
  67. EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
  68. EXPECT_EQ("", Replacements[0].Options);
  69. // 2. Parameter index with right alignment
  70. Replacements = formatv_object_base::parseFormatString("{0,3}");
  71. ASSERT_EQ(1u, Replacements.size());
  72. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  73. EXPECT_EQ(0u, Replacements[0].Index);
  74. EXPECT_EQ(3u, Replacements[0].Align);
  75. EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
  76. EXPECT_EQ("", Replacements[0].Options);
  77. // 3. And left alignment
  78. Replacements = formatv_object_base::parseFormatString("{0,-3}");
  79. ASSERT_EQ(1u, Replacements.size());
  80. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  81. EXPECT_EQ(0u, Replacements[0].Index);
  82. EXPECT_EQ(3u, Replacements[0].Align);
  83. EXPECT_EQ(AlignStyle::Left, Replacements[0].Where);
  84. EXPECT_EQ("", Replacements[0].Options);
  85. // 4. And center alignment
  86. Replacements = formatv_object_base::parseFormatString("{0,=3}");
  87. ASSERT_EQ(1u, Replacements.size());
  88. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  89. EXPECT_EQ(0u, Replacements[0].Index);
  90. EXPECT_EQ(3u, Replacements[0].Align);
  91. EXPECT_EQ(AlignStyle::Center, Replacements[0].Where);
  92. EXPECT_EQ("", Replacements[0].Options);
  93. // 4. Parameter index with option string
  94. Replacements = formatv_object_base::parseFormatString("{0:foo}");
  95. ASSERT_EQ(1u, Replacements.size());
  96. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  97. EXPECT_EQ(0u, Replacements[0].Index);
  98. EXPECT_EQ(0u, Replacements[0].Align);
  99. EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
  100. EXPECT_EQ("foo", Replacements[0].Options);
  101. // 5. Parameter index with alignment before option string
  102. Replacements = formatv_object_base::parseFormatString("{0,-3:foo}");
  103. ASSERT_EQ(1u, Replacements.size());
  104. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  105. EXPECT_EQ(0u, Replacements[0].Index);
  106. EXPECT_EQ(3u, Replacements[0].Align);
  107. EXPECT_EQ(AlignStyle::Left, Replacements[0].Where);
  108. EXPECT_EQ("foo", Replacements[0].Options);
  109. // 7. Parameter indices, options, and alignment can all have whitespace.
  110. Replacements = formatv_object_base::parseFormatString("{ 0, -3 : foo }");
  111. ASSERT_EQ(1u, Replacements.size());
  112. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  113. EXPECT_EQ(0u, Replacements[0].Index);
  114. EXPECT_EQ(3u, Replacements[0].Align);
  115. EXPECT_EQ(AlignStyle::Left, Replacements[0].Where);
  116. EXPECT_EQ("foo", Replacements[0].Options);
  117. // 8. Everything after the first option specifier is part of the style, even
  118. // if it contains another option specifier.
  119. Replacements = formatv_object_base::parseFormatString("{0:0:1}");
  120. ASSERT_EQ(1u, Replacements.size());
  121. EXPECT_EQ("0:0:1", Replacements[0].Spec);
  122. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  123. EXPECT_EQ(0u, Replacements[0].Index);
  124. EXPECT_EQ(0u, Replacements[0].Align);
  125. EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
  126. EXPECT_EQ("0:1", Replacements[0].Options);
  127. // 9. Custom padding character
  128. Replacements = formatv_object_base::parseFormatString("{0,p+4:foo}");
  129. ASSERT_EQ(1u, Replacements.size());
  130. EXPECT_EQ("0,p+4:foo", Replacements[0].Spec);
  131. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  132. EXPECT_EQ(0u, Replacements[0].Index);
  133. EXPECT_EQ(4u, Replacements[0].Align);
  134. EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
  135. EXPECT_EQ('p', Replacements[0].Pad);
  136. EXPECT_EQ("foo", Replacements[0].Options);
  137. // Format string special characters are allowed as padding character
  138. Replacements = formatv_object_base::parseFormatString("{0,-+4:foo}");
  139. ASSERT_EQ(1u, Replacements.size());
  140. EXPECT_EQ("0,-+4:foo", Replacements[0].Spec);
  141. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  142. EXPECT_EQ(0u, Replacements[0].Index);
  143. EXPECT_EQ(4u, Replacements[0].Align);
  144. EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
  145. EXPECT_EQ('-', Replacements[0].Pad);
  146. EXPECT_EQ("foo", Replacements[0].Options);
  147. Replacements = formatv_object_base::parseFormatString("{0,+-4:foo}");
  148. ASSERT_EQ(1u, Replacements.size());
  149. EXPECT_EQ("0,+-4:foo", Replacements[0].Spec);
  150. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  151. EXPECT_EQ(0u, Replacements[0].Index);
  152. EXPECT_EQ(4u, Replacements[0].Align);
  153. EXPECT_EQ(AlignStyle::Left, Replacements[0].Where);
  154. EXPECT_EQ('+', Replacements[0].Pad);
  155. EXPECT_EQ("foo", Replacements[0].Options);
  156. Replacements = formatv_object_base::parseFormatString("{0,==4:foo}");
  157. ASSERT_EQ(1u, Replacements.size());
  158. EXPECT_EQ("0,==4:foo", Replacements[0].Spec);
  159. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  160. EXPECT_EQ(0u, Replacements[0].Index);
  161. EXPECT_EQ(4u, Replacements[0].Align);
  162. EXPECT_EQ(AlignStyle::Center, Replacements[0].Where);
  163. EXPECT_EQ('=', Replacements[0].Pad);
  164. EXPECT_EQ("foo", Replacements[0].Options);
  165. Replacements = formatv_object_base::parseFormatString("{0,:=4:foo}");
  166. ASSERT_EQ(1u, Replacements.size());
  167. EXPECT_EQ("0,:=4:foo", Replacements[0].Spec);
  168. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  169. EXPECT_EQ(0u, Replacements[0].Index);
  170. EXPECT_EQ(4u, Replacements[0].Align);
  171. EXPECT_EQ(AlignStyle::Center, Replacements[0].Where);
  172. EXPECT_EQ(':', Replacements[0].Pad);
  173. EXPECT_EQ("foo", Replacements[0].Options);
  174. }
  175. TEST(FormatVariadicTest, DefaultReplacementValues) {
  176. // 2. If options string is missing, it defaults to empty.
  177. auto Replacements = formatv_object_base::parseFormatString("{0,3}");
  178. ASSERT_EQ(1u, Replacements.size());
  179. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  180. EXPECT_EQ(0u, Replacements[0].Index);
  181. EXPECT_EQ(3u, Replacements[0].Align);
  182. EXPECT_EQ("", Replacements[0].Options);
  183. // Including if the colon is present but contains no text.
  184. Replacements = formatv_object_base::parseFormatString("{0,3:}");
  185. ASSERT_EQ(1u, Replacements.size());
  186. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  187. EXPECT_EQ(0u, Replacements[0].Index);
  188. EXPECT_EQ(3u, Replacements[0].Align);
  189. EXPECT_EQ("", Replacements[0].Options);
  190. // 3. If alignment is missing, it defaults to 0, right, space
  191. Replacements = formatv_object_base::parseFormatString("{0:foo}");
  192. ASSERT_EQ(1u, Replacements.size());
  193. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  194. EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
  195. EXPECT_EQ(' ', Replacements[0].Pad);
  196. EXPECT_EQ(0u, Replacements[0].Index);
  197. EXPECT_EQ(0u, Replacements[0].Align);
  198. EXPECT_EQ("foo", Replacements[0].Options);
  199. }
  200. TEST(FormatVariadicTest, MultipleReplacements) {
  201. auto Replacements =
  202. formatv_object_base::parseFormatString("{0} {1:foo}-{2,-3:bar}");
  203. ASSERT_EQ(5u, Replacements.size());
  204. // {0}
  205. EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
  206. EXPECT_EQ(0u, Replacements[0].Index);
  207. EXPECT_EQ(0u, Replacements[0].Align);
  208. EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
  209. EXPECT_EQ("", Replacements[0].Options);
  210. // " "
  211. EXPECT_EQ(ReplacementType::Literal, Replacements[1].Type);
  212. EXPECT_EQ(" ", Replacements[1].Spec);
  213. // {1:foo} - Options=foo
  214. EXPECT_EQ(ReplacementType::Format, Replacements[2].Type);
  215. EXPECT_EQ(1u, Replacements[2].Index);
  216. EXPECT_EQ(0u, Replacements[2].Align);
  217. EXPECT_EQ(AlignStyle::Right, Replacements[2].Where);
  218. EXPECT_EQ("foo", Replacements[2].Options);
  219. // "-"
  220. EXPECT_EQ(ReplacementType::Literal, Replacements[3].Type);
  221. EXPECT_EQ("-", Replacements[3].Spec);
  222. // {2:bar,-3} - Options=bar, Align=-3
  223. EXPECT_EQ(ReplacementType::Format, Replacements[4].Type);
  224. EXPECT_EQ(2u, Replacements[4].Index);
  225. EXPECT_EQ(3u, Replacements[4].Align);
  226. EXPECT_EQ(AlignStyle::Left, Replacements[4].Where);
  227. EXPECT_EQ("bar", Replacements[4].Options);
  228. }
  229. TEST(FormatVariadicTest, FormatNoReplacements) {
  230. EXPECT_EQ("", formatv("").str());
  231. EXPECT_EQ("Test", formatv("Test").str());
  232. }
  233. TEST(FormatVariadicTest, FormatBasicTypesOneReplacement) {
  234. EXPECT_EQ("1", formatv("{0}", 1).str());
  235. EXPECT_EQ("c", formatv("{0}", 'c').str());
  236. EXPECT_EQ("-3", formatv("{0}", -3).str());
  237. EXPECT_EQ("Test", formatv("{0}", "Test").str());
  238. EXPECT_EQ("Test2", formatv("{0}", StringRef("Test2")).str());
  239. EXPECT_EQ("Test3", formatv("{0}", std::string("Test3")).str());
  240. }
  241. TEST(FormatVariadicTest, IntegralHexFormatting) {
  242. // 1. Trivial cases. Make sure hex is not the default.
  243. EXPECT_EQ("0", formatv("{0}", 0).str());
  244. EXPECT_EQ("2748", formatv("{0}", 0xABC).str());
  245. EXPECT_EQ("-2748", formatv("{0}", -0xABC).str());
  246. // 3. various hex prefixes.
  247. EXPECT_EQ("0xFF", formatv("{0:X}", 255).str());
  248. EXPECT_EQ("0xFF", formatv("{0:X+}", 255).str());
  249. EXPECT_EQ("0xff", formatv("{0:x}", 255).str());
  250. EXPECT_EQ("0xff", formatv("{0:x+}", 255).str());
  251. EXPECT_EQ("FF", formatv("{0:X-}", 255).str());
  252. EXPECT_EQ("ff", formatv("{0:x-}", 255).str());
  253. // 5. Precision pads left of the most significant digit but right of the
  254. // prefix (if one exists).
  255. EXPECT_EQ("0xFF", formatv("{0:X2}", 255).str());
  256. EXPECT_EQ("0xFF", formatv("{0:X+2}", 255).str());
  257. EXPECT_EQ("0x0ff", formatv("{0:x3}", 255).str());
  258. EXPECT_EQ("0x0ff", formatv("{0:x+3}", 255).str());
  259. EXPECT_EQ("00FF", formatv("{0:X-4}", 255).str());
  260. EXPECT_EQ("00ff", formatv("{0:x-4}", 255).str());
  261. // 6. Try some larger types.
  262. EXPECT_EQ("0xDEADBEEFDEADBEEF",
  263. formatv("{0:X16}", -2401053088876216593LL).str());
  264. EXPECT_EQ("0xFEEBDAEDFEEBDAED",
  265. formatv("{0:X16}", 0xFEEBDAEDFEEBDAEDULL).str());
  266. EXPECT_EQ("0x00000000DEADBEEF", formatv("{0:X16}", 0xDEADBEEF).str());
  267. // 7. Padding should take into account the prefix
  268. EXPECT_EQ("0xff", formatv("{0,4:x}", 255).str());
  269. EXPECT_EQ(" 0xff", formatv("{0,5:x+}", 255).str());
  270. EXPECT_EQ(" FF", formatv("{0,4:X-}", 255).str());
  271. EXPECT_EQ(" ff", formatv("{0,5:x-}", 255).str());
  272. // 8. Including when it's been zero-padded
  273. EXPECT_EQ(" 0x0ff", formatv("{0,7:x3}", 255).str());
  274. EXPECT_EQ(" 0x00ff", formatv("{0,7:x+4}", 255).str());
  275. EXPECT_EQ(" 000FF", formatv("{0,7:X-5}", 255).str());
  276. EXPECT_EQ(" 0000ff", formatv("{0,7:x-6}", 255).str());
  277. // 9. Precision with default format specifier should work too
  278. EXPECT_EQ(" 255", formatv("{0,7:3}", 255).str());
  279. EXPECT_EQ(" 0255", formatv("{0,7:4}", 255).str());
  280. EXPECT_EQ(" 00255", formatv("{0,7:5}", 255).str());
  281. EXPECT_EQ(" 000255", formatv("{0,7:6}", 255).str());
  282. }
  283. TEST(FormatVariadicTest, PointerFormatting) {
  284. // 1. Trivial cases. Hex is default. Default Precision is pointer width.
  285. if (sizeof(void *) == 4) {
  286. EXPECT_EQ("0x00000000", formatv("{0}", (void *)0).str());
  287. EXPECT_EQ("0x00000ABC", formatv("{0}", (void *)0xABC).str());
  288. } else {
  289. EXPECT_EQ("0x0000000000000000", formatv("{0}", (void *)0).str());
  290. EXPECT_EQ("0x0000000000000ABC", formatv("{0}", (void *)0xABC).str());
  291. }
  292. // 2. But we can reduce the precision explicitly.
  293. EXPECT_EQ("0x0", formatv("{0:0}", (void *)0).str());
  294. EXPECT_EQ("0xABC", formatv("{0:0}", (void *)0xABC).str());
  295. EXPECT_EQ("0x0000", formatv("{0:4}", (void *)0).str());
  296. EXPECT_EQ("0x0ABC", formatv("{0:4}", (void *)0xABC).str());
  297. // 3. various hex prefixes.
  298. EXPECT_EQ("0x0ABC", formatv("{0:X4}", (void *)0xABC).str());
  299. EXPECT_EQ("0x0abc", formatv("{0:x4}", (void *)0xABC).str());
  300. EXPECT_EQ("0ABC", formatv("{0:X-4}", (void *)0xABC).str());
  301. EXPECT_EQ("0abc", formatv("{0:x-4}", (void *)0xABC).str());
  302. }
  303. TEST(FormatVariadicTest, IntegralNumberFormatting) {
  304. // 1. Test comma grouping with default widths and precisions.
  305. EXPECT_EQ("0", formatv("{0:N}", 0).str());
  306. EXPECT_EQ("10", formatv("{0:N}", 10).str());
  307. EXPECT_EQ("100", formatv("{0:N}", 100).str());
  308. EXPECT_EQ("1,000", formatv("{0:N}", 1000).str());
  309. EXPECT_EQ("1,234,567,890", formatv("{0:N}", 1234567890).str());
  310. EXPECT_EQ("-10", formatv("{0:N}", -10).str());
  311. EXPECT_EQ("-100", formatv("{0:N}", -100).str());
  312. EXPECT_EQ("-1,000", formatv("{0:N}", -1000).str());
  313. EXPECT_EQ("-1,234,567,890", formatv("{0:N}", -1234567890).str());
  314. // 2. If there is no comma, width and precision pad to the same absolute
  315. // size.
  316. EXPECT_EQ(" 1", formatv("{0,2:N}", 1).str());
  317. // 3. But if there is a comma or negative sign, width factors them in but
  318. // precision doesn't.
  319. EXPECT_EQ(" 1,000", formatv("{0,6:N}", 1000).str());
  320. EXPECT_EQ(" -1,000", formatv("{0,7:N}", -1000).str());
  321. // 4. Large widths all line up.
  322. EXPECT_EQ(" 1,000", formatv("{0,11:N}", 1000).str());
  323. EXPECT_EQ(" -1,000", formatv("{0,11:N}", -1000).str());
  324. EXPECT_EQ(" -100,000", formatv("{0,11:N}", -100000).str());
  325. }
  326. TEST(FormatVariadicTest, StringFormatting) {
  327. const char FooArray[] = "FooArray";
  328. const char *FooPtr = "FooPtr";
  329. llvm::StringRef FooRef("FooRef");
  330. constexpr StringLiteral FooLiteral("FooLiteral");
  331. std::string FooString("FooString");
  332. // 1. Test that we can print various types of strings.
  333. EXPECT_EQ(FooArray, formatv("{0}", FooArray).str());
  334. EXPECT_EQ(FooPtr, formatv("{0}", FooPtr).str());
  335. EXPECT_EQ(FooRef, formatv("{0}", FooRef).str());
  336. EXPECT_EQ(FooLiteral, formatv("{0}", FooLiteral).str());
  337. EXPECT_EQ(FooString, formatv("{0}", FooString).str());
  338. // 2. Test that the precision specifier prints the correct number of
  339. // characters.
  340. EXPECT_EQ("FooA", formatv("{0:4}", FooArray).str());
  341. EXPECT_EQ("FooP", formatv("{0:4}", FooPtr).str());
  342. EXPECT_EQ("FooR", formatv("{0:4}", FooRef).str());
  343. EXPECT_EQ("FooS", formatv("{0:4}", FooString).str());
  344. // 3. And that padding works.
  345. EXPECT_EQ(" FooA", formatv("{0,6:4}", FooArray).str());
  346. EXPECT_EQ(" FooP", formatv("{0,6:4}", FooPtr).str());
  347. EXPECT_EQ(" FooR", formatv("{0,6:4}", FooRef).str());
  348. EXPECT_EQ(" FooS", formatv("{0,6:4}", FooString).str());
  349. }
  350. TEST(FormatVariadicTest, CharFormatting) {
  351. // 1. Not much to see here. Just print a char with and without padding.
  352. EXPECT_EQ("C", formatv("{0}", 'C').str());
  353. EXPECT_EQ(" C", formatv("{0,3}", 'C').str());
  354. // 2. char is really an integral type though, where the only difference is
  355. // that the "default" is to print the ASCII. So if a non-default presentation
  356. // specifier exists, it should print as an integer.
  357. EXPECT_EQ("37", formatv("{0:D}", (char)37).str());
  358. EXPECT_EQ(" 037", formatv("{0,5:D3}", (char)37).str());
  359. }
  360. TEST(FormatVariadicTest, BoolTest) {
  361. // 1. Default style is lowercase text (same as 't')
  362. EXPECT_EQ("true", formatv("{0}", true).str());
  363. EXPECT_EQ("false", formatv("{0}", false).str());
  364. EXPECT_EQ("true", formatv("{0:t}", true).str());
  365. EXPECT_EQ("false", formatv("{0:t}", false).str());
  366. // 2. T - uppercase text
  367. EXPECT_EQ("TRUE", formatv("{0:T}", true).str());
  368. EXPECT_EQ("FALSE", formatv("{0:T}", false).str());
  369. // 3. D / d - integral
  370. EXPECT_EQ("1", formatv("{0:D}", true).str());
  371. EXPECT_EQ("0", formatv("{0:D}", false).str());
  372. EXPECT_EQ("1", formatv("{0:d}", true).str());
  373. EXPECT_EQ("0", formatv("{0:d}", false).str());
  374. // 4. Y - uppercase yes/no
  375. EXPECT_EQ("YES", formatv("{0:Y}", true).str());
  376. EXPECT_EQ("NO", formatv("{0:Y}", false).str());
  377. // 5. y - lowercase yes/no
  378. EXPECT_EQ("yes", formatv("{0:y}", true).str());
  379. EXPECT_EQ("no", formatv("{0:y}", false).str());
  380. }
  381. TEST(FormatVariadicTest, DoubleFormatting) {
  382. // Test exponents, fixed point, and percent formatting.
  383. // 1. Signed, unsigned, and zero exponent format.
  384. EXPECT_EQ("0.000000E+00", formatv("{0:E}", 0.0).str());
  385. EXPECT_EQ("-0.000000E+00", formatv("{0:E}", -0.0).str());
  386. EXPECT_EQ("1.100000E+00", formatv("{0:E}", 1.1).str());
  387. EXPECT_EQ("-1.100000E+00", formatv("{0:E}", -1.1).str());
  388. EXPECT_EQ("1.234568E+03", formatv("{0:E}", 1234.5678).str());
  389. EXPECT_EQ("-1.234568E+03", formatv("{0:E}", -1234.5678).str());
  390. EXPECT_EQ("1.234568E-03", formatv("{0:E}", .0012345678).str());
  391. EXPECT_EQ("-1.234568E-03", formatv("{0:E}", -.0012345678).str());
  392. // 2. With padding and precision.
  393. EXPECT_EQ(" 0.000E+00", formatv("{0,11:E3}", 0.0).str());
  394. EXPECT_EQ(" -1.100E+00", formatv("{0,11:E3}", -1.1).str());
  395. EXPECT_EQ(" 1.235E+03", formatv("{0,11:E3}", 1234.5678).str());
  396. EXPECT_EQ(" -1.235E-03", formatv("{0,11:E3}", -.0012345678).str());
  397. // 3. Signed, unsigned, and zero fixed point format.
  398. EXPECT_EQ("0.00", formatv("{0:F}", 0.0).str());
  399. EXPECT_EQ("-0.00", formatv("{0:F}", -0.0).str());
  400. EXPECT_EQ("1.10", formatv("{0:F}", 1.1).str());
  401. EXPECT_EQ("-1.10", formatv("{0:F}", -1.1).str());
  402. EXPECT_EQ("1234.57", formatv("{0:F}", 1234.5678).str());
  403. EXPECT_EQ("-1234.57", formatv("{0:F}", -1234.5678).str());
  404. EXPECT_EQ("0.00", formatv("{0:F}", .0012345678).str());
  405. EXPECT_EQ("-0.00", formatv("{0:F}", -.0012345678).str());
  406. // 2. With padding and precision.
  407. EXPECT_EQ(" 0.000", formatv("{0,8:F3}", 0.0).str());
  408. EXPECT_EQ(" -1.100", formatv("{0,8:F3}", -1.1).str());
  409. EXPECT_EQ("1234.568", formatv("{0,8:F3}", 1234.5678).str());
  410. EXPECT_EQ(" -0.001", formatv("{0,8:F3}", -.0012345678).str());
  411. }
  412. TEST(FormatVariadicTest, CustomPaddingCharacter) {
  413. // 1. Padding with custom character
  414. EXPECT_EQ("==123", formatv("{0,=+5}", 123).str());
  415. EXPECT_EQ("=123=", formatv("{0,==5}", 123).str());
  416. EXPECT_EQ("123==", formatv("{0,=-5}", 123).str());
  417. // 2. Combined with zero padding
  418. EXPECT_EQ("=00123=", formatv("{0,==7:5}", 123).str());
  419. }
  420. struct format_tuple {
  421. const char *Fmt;
  422. explicit format_tuple(const char *Fmt) : Fmt(Fmt) {}
  423. template <typename... Ts>
  424. auto operator()(Ts &&... Values) const
  425. -> decltype(formatv(Fmt, std::forward<Ts>(Values)...)) {
  426. return formatv(Fmt, std::forward<Ts>(Values)...);
  427. }
  428. };
  429. TEST(FormatVariadicTest, BigTest) {
  430. using Tuple =
  431. std::tuple<char, int, const char *, StringRef, std::string, double, float,
  432. void *, int, double, int64_t, uint64_t, double, uint8_t>;
  433. Tuple Ts[] = {
  434. Tuple('a', 1, "Str", StringRef(), std::string(), 3.14159, -.17532f,
  435. (void *)nullptr, 123456, 6.02E23, -908234908423, 908234908422234,
  436. std::numeric_limits<double>::quiet_NaN(), 0xAB),
  437. Tuple('x', 0xDDB5B, "LongerStr", "StringRef", "std::string", -2.7,
  438. .08215f, (void *)nullptr, 0, 6.62E-34, -908234908423,
  439. 908234908422234, std::numeric_limits<double>::infinity(), 0x0)};
  440. // Test long string formatting with many edge cases combined.
  441. const char *Intro =
  442. "There are {{{0}} items in the tuple, and {{{1}} tuple(s) in the array.";
  443. const char *Header =
  444. "{0,6}|{1,8}|{2,=10}|{3,=10}|{4,=13}|{5,7}|{6,7}|{7,10}|{8,"
  445. "-7}|{9,10}|{10,16}|{11,17}|{12,6}|{13,4}";
  446. const char *Line =
  447. "{0,6}|{1,8:X}|{2,=10}|{3,=10:5}|{4,=13}|{5,7:3}|{6,7:P2}|{7,"
  448. "10:X8}|{8,-7:N}|{9,10:E4}|{10,16:N}|{11,17:D}|{12,6}|{13,"
  449. "4:X}";
  450. std::string S;
  451. llvm::raw_string_ostream Stream(S);
  452. Stream << formatv(Intro, std::tuple_size<Tuple>::value,
  453. llvm::array_lengthof(Ts))
  454. << "\n";
  455. Stream << formatv(Header, "Char", "HexInt", "Str", "Ref", "std::str",
  456. "double", "float", "pointer", "comma", "exp", "bigint",
  457. "bigint2", "limit", "byte")
  458. << "\n";
  459. for (auto &Item : Ts) {
  460. Stream << llvm::apply_tuple(format_tuple(Line), Item) << "\n";
  461. }
  462. Stream.flush();
  463. const char *Expected =
  464. R"foo(There are {14} items in the tuple, and {2} tuple(s) in the array.
  465. Char| HexInt| Str | Ref | std::str | double| float| pointer|comma | exp| bigint| bigint2| limit|byte
  466. a| 0x1| Str | | | 3.142|-17.53%|0x00000000|123,456|6.0200E+23|-908,234,908,423| 908234908422234| nan|0xAB
  467. x| 0xDDB5B|LongerStr | Strin | std::string | -2.700| 8.21%|0x00000000|0 |6.6200E-34|-908,234,908,423| 908234908422234| INF| 0x0
  468. )foo";
  469. EXPECT_EQ(Expected, S);
  470. }
  471. TEST(FormatVariadicTest, Range) {
  472. std::vector<int> IntRange = {1, 1, 2, 3, 5, 8, 13};
  473. // 1. Simple range with default separator and element style.
  474. EXPECT_EQ("1, 1, 2, 3, 5, 8, 13",
  475. formatv("{0}", make_range(IntRange.begin(), IntRange.end())).str());
  476. EXPECT_EQ("1, 2, 3, 5, 8",
  477. formatv("{0}", make_range(IntRange.begin() + 1, IntRange.end() - 1))
  478. .str());
  479. // 2. Non-default separator
  480. EXPECT_EQ(
  481. "1/1/2/3/5/8/13",
  482. formatv("{0:$[/]}", make_range(IntRange.begin(), IntRange.end())).str());
  483. // 3. Default separator, non-default element style.
  484. EXPECT_EQ(
  485. "0x1, 0x1, 0x2, 0x3, 0x5, 0x8, 0xd",
  486. formatv("{0:@[x]}", make_range(IntRange.begin(), IntRange.end())).str());
  487. // 4. Non-default separator and element style.
  488. EXPECT_EQ(
  489. "0x1 + 0x1 + 0x2 + 0x3 + 0x5 + 0x8 + 0xd",
  490. formatv("{0:$[ + ]@[x]}", make_range(IntRange.begin(), IntRange.end()))
  491. .str());
  492. // 5. Element style and/or separator using alternate delimeters to allow using
  493. // delimeter characters as part of the separator.
  494. EXPECT_EQ(
  495. "<0x1><0x1><0x2><0x3><0x5><0x8><0xd>",
  496. formatv("<{0:$[><]@(x)}>", make_range(IntRange.begin(), IntRange.end()))
  497. .str());
  498. EXPECT_EQ(
  499. "[0x1][0x1][0x2][0x3][0x5][0x8][0xd]",
  500. formatv("[{0:$(][)@[x]}]", make_range(IntRange.begin(), IntRange.end()))
  501. .str());
  502. EXPECT_EQ(
  503. "(0x1)(0x1)(0x2)(0x3)(0x5)(0x8)(0xd)",
  504. formatv("({0:$<)(>@<x>})", make_range(IntRange.begin(), IntRange.end()))
  505. .str());
  506. // 5. Empty range.
  507. EXPECT_EQ("", formatv("{0:$[+]@[x]}",
  508. make_range(IntRange.begin(), IntRange.begin()))
  509. .str());
  510. // 6. Empty separator and style.
  511. EXPECT_EQ("11235813",
  512. formatv("{0:$[]@<>}", make_range(IntRange.begin(), IntRange.end()))
  513. .str());
  514. }
  515. TEST(FormatVariadicTest, Adapter) {
  516. class Negative : public FormatAdapter<int> {
  517. public:
  518. explicit Negative(int N) : FormatAdapter<int>(std::move(N)) {}
  519. void format(raw_ostream &S, StringRef Options) override { S << -Item; }
  520. };
  521. EXPECT_EQ("-7", formatv("{0}", Negative(7)).str());
  522. int N = 171;
  523. EXPECT_EQ(" 171 ",
  524. formatv("{0}", fmt_align(N, AlignStyle::Center, 7)).str());
  525. EXPECT_EQ("--171--",
  526. formatv("{0}", fmt_align(N, AlignStyle::Center, 7, '-')).str());
  527. EXPECT_EQ(" 171 ", formatv("{0}", fmt_pad(N, 1, 3)).str());
  528. EXPECT_EQ("171171171171171", formatv("{0}", fmt_repeat(N, 5)).str());
  529. EXPECT_EQ(" ABABABABAB ",
  530. formatv("{0:X-}", fmt_pad(fmt_repeat(N, 5), 1, 3)).str());
  531. EXPECT_EQ(" AB AB AB AB AB ",
  532. formatv("{0,=34:X-}", fmt_repeat(fmt_pad(N, 1, 3), 5)).str());
  533. }
  534. TEST(FormatVariadicTest, MoveConstructor) {
  535. auto fmt = formatv("{0} {1}", 1, 2);
  536. auto fmt2 = std::move(fmt);
  537. std::string S = fmt2;
  538. EXPECT_EQ("1 2", S);
  539. }
  540. TEST(FormatVariadicTest, ImplicitConversions) {
  541. std::string S = formatv("{0} {1}", 1, 2);
  542. EXPECT_EQ("1 2", S);
  543. SmallString<4> S2 = formatv("{0} {1}", 1, 2);
  544. EXPECT_EQ("1 2", S2);
  545. }
  546. TEST(FormatVariadicTest, FormatAdapter) {
  547. EXPECT_EQ("Format", formatv("{0}", Format(1)).str());
  548. Format var(1);
  549. EXPECT_EQ("Format", formatv("{0}", var).str());
  550. EXPECT_EQ("Format", formatv("{0}", std::move(var)).str());
  551. // Not supposed to compile
  552. // const Format cvar(1);
  553. // EXPECT_EQ("Format", formatv("{0}", cvar).str());
  554. }
  555. TEST(FormatVariadicTest, FormatFormatvObject) {
  556. EXPECT_EQ("Format", formatv("F{0}t", formatv("o{0}a", "rm")).str());
  557. EXPECT_EQ("[ ! ]", formatv("[{0,+5}]", formatv("{0,-2}", "!")).str());
  558. }
  559. namespace {
  560. struct Recorder {
  561. int Copied = 0, Moved = 0;
  562. Recorder() = default;
  563. Recorder(const Recorder &Copy) : Copied(1 + Copy.Copied), Moved(Copy.Moved) {}
  564. Recorder(const Recorder &&Move)
  565. : Copied(Move.Copied), Moved(1 + Move.Moved) {}
  566. };
  567. } // namespace
  568. namespace llvm {
  569. template <> struct format_provider<Recorder> {
  570. static void format(const Recorder &R, raw_ostream &OS, StringRef style) {
  571. OS << R.Copied << "C " << R.Moved << "M";
  572. }
  573. };
  574. } // namespace
  575. TEST(FormatVariadicTest, CopiesAndMoves) {
  576. Recorder R;
  577. EXPECT_EQ("0C 0M", formatv("{0}", R).str());
  578. EXPECT_EQ("0C 3M", formatv("{0}", std::move(R)).str());
  579. EXPECT_EQ("0C 3M", formatv("{0}", Recorder()).str());
  580. EXPECT_EQ(0, R.Copied);
  581. EXPECT_EQ(0, R.Moved);
  582. }
  583. namespace adl {
  584. struct X {};
  585. raw_ostream &operator<<(raw_ostream &OS, const X &) { return OS << "X"; }
  586. } // namespace adl
  587. TEST(FormatVariadicTest, FormatStreamable) {
  588. adl::X X;
  589. EXPECT_EQ("X", formatv("{0}", X).str());
  590. }
  591. TEST(FormatVariadicTest, FormatError) {
  592. auto E1 = make_error<StringError>("X", inconvertibleErrorCode());
  593. EXPECT_EQ("X", formatv("{0}", E1).str());
  594. EXPECT_TRUE(E1.isA<StringError>()); // not consumed
  595. EXPECT_EQ("X", formatv("{0}", fmt_consume(std::move(E1))).str());
  596. EXPECT_FALSE(E1.isA<StringError>()); // consumed
  597. }