xref: /llvm-project/llvm/unittests/Support/FormatVariadicTest.cpp (revision 459a82e6890ff41e30d486f36c8c7ec22628bb7a)
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 
9 #include "llvm/Support/FormatVariadic.h"
10 #include "llvm/Support/Error.h"
11 #include "llvm/Support/FormatAdapters.h"
12 #include "gmock/gmock.h"
13 #include "gtest/gtest.h"
14 
15 using namespace llvm;
16 using ::testing::HasSubstr;
17 
18 // Compile-time tests templates in the detail namespace.
19 namespace {
20 struct Format : public FormatAdapter<int> {
21   Format(int N) : FormatAdapter<int>(std::move(N)) {}
22   void format(raw_ostream &OS, StringRef Opt) override { OS << "Format"; }
23 };
24 
25 using support::detail::uses_format_member;
26 using support::detail::uses_missing_provider;
27 
28 static_assert(uses_format_member<Format>::value, "");
29 static_assert(uses_format_member<Format &>::value, "");
30 static_assert(uses_format_member<Format &&>::value, "");
31 static_assert(uses_format_member<const Format>::value, "");
32 static_assert(uses_format_member<const Format &>::value, "");
33 static_assert(uses_format_member<const volatile Format>::value, "");
34 static_assert(uses_format_member<const volatile Format &>::value, "");
35 
36 struct NoFormat {};
37 static_assert(uses_missing_provider<NoFormat>::value, "");
38 }
39 
40 // Helper to parse format string with no validation.
41 static SmallVector<ReplacementItem, 2> parseFormatString(StringRef Fmt) {
42   return formatv_object_base::parseFormatString(Fmt, 0, false);
43 }
44 
45 TEST(FormatVariadicTest, EmptyFormatString) {
46   auto Replacements = parseFormatString("");
47   EXPECT_EQ(0U, Replacements.size());
48 }
49 
50 TEST(FormatVariadicTest, NoReplacements) {
51   const StringRef kFormatString = "This is a test";
52   auto Replacements = parseFormatString(kFormatString);
53   ASSERT_EQ(1U, Replacements.size());
54   EXPECT_EQ(kFormatString, Replacements[0].Spec);
55   EXPECT_EQ(ReplacementType::Literal, Replacements[0].Type);
56 }
57 
58 TEST(FormatVariadicTest, EscapedBrace) {
59   // {{ should be replaced with {
60   auto Replacements = parseFormatString("{{");
61   ASSERT_EQ(1u, Replacements.size());
62   EXPECT_EQ("{", Replacements[0].Spec);
63   EXPECT_EQ(ReplacementType::Literal, Replacements[0].Type);
64 
65   // An even number N of braces should be replaced with N/2 braces.
66   Replacements = parseFormatString("{{{{{{");
67   ASSERT_EQ(1u, Replacements.size());
68   EXPECT_EQ("{{{", Replacements[0].Spec);
69   EXPECT_EQ(ReplacementType::Literal, Replacements[0].Type);
70 
71   // } does not require doubling up.
72   Replacements = parseFormatString("}");
73   ASSERT_EQ(1u, Replacements.size());
74   EXPECT_EQ("}", Replacements[0].Spec);
75   EXPECT_EQ(ReplacementType::Literal, Replacements[0].Type);
76 
77   // } does not require doubling up.
78   Replacements = parseFormatString("}}}");
79   ASSERT_EQ(1u, Replacements.size());
80   EXPECT_EQ("}}}", Replacements[0].Spec);
81   EXPECT_EQ(ReplacementType::Literal, Replacements[0].Type);
82 }
83 
84 TEST(FormatVariadicTest, ValidReplacementSequence) {
85   // 1. Simple replacement - parameter index only
86   auto Replacements = parseFormatString("{0}");
87   ASSERT_EQ(1u, Replacements.size());
88   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
89   EXPECT_EQ(0u, Replacements[0].Index);
90   EXPECT_EQ(0u, Replacements[0].Width);
91   EXPECT_EQ("", Replacements[0].Options);
92 
93   Replacements = parseFormatString("{1}");
94   ASSERT_EQ(1u, Replacements.size());
95   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
96   EXPECT_EQ(1u, Replacements[0].Index);
97   EXPECT_EQ(0u, Replacements[0].Width);
98   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
99   EXPECT_EQ("", Replacements[0].Options);
100 
101   // 2. Parameter index with right alignment
102   Replacements = parseFormatString("{0,3}");
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].Width);
107   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
108   EXPECT_EQ("", Replacements[0].Options);
109 
110   // 3. And left alignment
111   Replacements = parseFormatString("{0,-3}");
112   ASSERT_EQ(1u, Replacements.size());
113   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
114   EXPECT_EQ(0u, Replacements[0].Index);
115   EXPECT_EQ(3u, Replacements[0].Width);
116   EXPECT_EQ(AlignStyle::Left, Replacements[0].Where);
117   EXPECT_EQ("", Replacements[0].Options);
118 
119   // 4. And center alignment
120   Replacements = parseFormatString("{0,=3}");
121   ASSERT_EQ(1u, Replacements.size());
122   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
123   EXPECT_EQ(0u, Replacements[0].Index);
124   EXPECT_EQ(3u, Replacements[0].Width);
125   EXPECT_EQ(AlignStyle::Center, Replacements[0].Where);
126   EXPECT_EQ("", Replacements[0].Options);
127 
128   // 4. Parameter index with option string
129   Replacements = parseFormatString("{0:foo}");
130   ASSERT_EQ(1u, Replacements.size());
131   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
132   EXPECT_EQ(0u, Replacements[0].Index);
133   EXPECT_EQ(0u, Replacements[0].Width);
134   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
135   EXPECT_EQ("foo", Replacements[0].Options);
136 
137   // 5. Parameter index with alignment before option string
138   Replacements = parseFormatString("{0,-3:foo}");
139   ASSERT_EQ(1u, Replacements.size());
140   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
141   EXPECT_EQ(0u, Replacements[0].Index);
142   EXPECT_EQ(3u, Replacements[0].Width);
143   EXPECT_EQ(AlignStyle::Left, Replacements[0].Where);
144   EXPECT_EQ("foo", Replacements[0].Options);
145 
146   // 7. Parameter indices, options, and alignment can all have whitespace.
147   Replacements = parseFormatString("{ 0, -3 : foo }");
148   ASSERT_EQ(1u, Replacements.size());
149   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
150   EXPECT_EQ(0u, Replacements[0].Index);
151   EXPECT_EQ(3u, Replacements[0].Width);
152   EXPECT_EQ(AlignStyle::Left, Replacements[0].Where);
153   EXPECT_EQ("foo", Replacements[0].Options);
154 
155   // 8. Everything after the first option specifier is part of the style, even
156   // if it contains another option specifier.
157   Replacements = parseFormatString("{0:0:1}");
158   ASSERT_EQ(1u, Replacements.size());
159   EXPECT_EQ("0:0:1", Replacements[0].Spec);
160   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
161   EXPECT_EQ(0u, Replacements[0].Index);
162   EXPECT_EQ(0u, Replacements[0].Width);
163   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
164   EXPECT_EQ("0:1", Replacements[0].Options);
165 
166   // 9. Custom padding character
167   Replacements = parseFormatString("{0,p+4:foo}");
168   ASSERT_EQ(1u, Replacements.size());
169   EXPECT_EQ("0,p+4:foo", Replacements[0].Spec);
170   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
171   EXPECT_EQ(0u, Replacements[0].Index);
172   EXPECT_EQ(4u, Replacements[0].Width);
173   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
174   EXPECT_EQ('p', Replacements[0].Pad);
175   EXPECT_EQ("foo", Replacements[0].Options);
176 
177   // Format string special characters are allowed as padding character
178   Replacements = parseFormatString("{0,-+4:foo}");
179   ASSERT_EQ(1u, Replacements.size());
180   EXPECT_EQ("0,-+4:foo", Replacements[0].Spec);
181   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
182   EXPECT_EQ(0u, Replacements[0].Index);
183   EXPECT_EQ(4u, Replacements[0].Width);
184   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
185   EXPECT_EQ('-', Replacements[0].Pad);
186   EXPECT_EQ("foo", Replacements[0].Options);
187 
188   Replacements = parseFormatString("{0,+-4:foo}");
189   ASSERT_EQ(1u, Replacements.size());
190   EXPECT_EQ("0,+-4:foo", Replacements[0].Spec);
191   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
192   EXPECT_EQ(0u, Replacements[0].Index);
193   EXPECT_EQ(4u, Replacements[0].Width);
194   EXPECT_EQ(AlignStyle::Left, Replacements[0].Where);
195   EXPECT_EQ('+', Replacements[0].Pad);
196   EXPECT_EQ("foo", Replacements[0].Options);
197 
198   Replacements = parseFormatString("{0,==4:foo}");
199   ASSERT_EQ(1u, Replacements.size());
200   EXPECT_EQ("0,==4:foo", Replacements[0].Spec);
201   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
202   EXPECT_EQ(0u, Replacements[0].Index);
203   EXPECT_EQ(4u, Replacements[0].Width);
204   EXPECT_EQ(AlignStyle::Center, Replacements[0].Where);
205   EXPECT_EQ('=', Replacements[0].Pad);
206   EXPECT_EQ("foo", Replacements[0].Options);
207 
208   Replacements = parseFormatString("{0,:=4:foo}");
209   ASSERT_EQ(1u, Replacements.size());
210   EXPECT_EQ("0,:=4:foo", Replacements[0].Spec);
211   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
212   EXPECT_EQ(0u, Replacements[0].Index);
213   EXPECT_EQ(4u, Replacements[0].Width);
214   EXPECT_EQ(AlignStyle::Center, Replacements[0].Where);
215   EXPECT_EQ(':', Replacements[0].Pad);
216   EXPECT_EQ("foo", Replacements[0].Options);
217 }
218 
219 TEST(FormatVariadicTest, DefaultReplacementValues) {
220   // 2. If options string is missing, it defaults to empty.
221   auto Replacements = parseFormatString("{0,3}");
222   ASSERT_EQ(1u, Replacements.size());
223   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
224   EXPECT_EQ(0u, Replacements[0].Index);
225   EXPECT_EQ(3u, Replacements[0].Width);
226   EXPECT_EQ("", Replacements[0].Options);
227 
228   // Including if the colon is present but contains no text.
229   Replacements = parseFormatString("{0,3:}");
230   ASSERT_EQ(1u, Replacements.size());
231   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
232   EXPECT_EQ(0u, Replacements[0].Index);
233   EXPECT_EQ(3u, Replacements[0].Width);
234   EXPECT_EQ("", Replacements[0].Options);
235 
236   // 3. If alignment is missing, it defaults to 0, right, space
237   Replacements = parseFormatString("{0:foo}");
238   ASSERT_EQ(1u, Replacements.size());
239   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
240   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
241   EXPECT_EQ(' ', Replacements[0].Pad);
242   EXPECT_EQ(0u, Replacements[0].Index);
243   EXPECT_EQ(0u, Replacements[0].Width);
244   EXPECT_EQ("foo", Replacements[0].Options);
245 }
246 
247 TEST(FormatVariadicTest, MultipleReplacements) {
248   auto Replacements = parseFormatString("{0} {1:foo}-{2,-3:bar}");
249   ASSERT_EQ(5u, Replacements.size());
250   // {0}
251   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
252   EXPECT_EQ(0u, Replacements[0].Index);
253   EXPECT_EQ(0u, Replacements[0].Width);
254   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
255   EXPECT_EQ("", Replacements[0].Options);
256 
257   // " "
258   EXPECT_EQ(ReplacementType::Literal, Replacements[1].Type);
259   EXPECT_EQ(" ", Replacements[1].Spec);
260 
261   // {1:foo} - Options=foo
262   EXPECT_EQ(ReplacementType::Format, Replacements[2].Type);
263   EXPECT_EQ(1u, Replacements[2].Index);
264   EXPECT_EQ(0u, Replacements[2].Width);
265   EXPECT_EQ(AlignStyle::Right, Replacements[2].Where);
266   EXPECT_EQ("foo", Replacements[2].Options);
267 
268   // "-"
269   EXPECT_EQ(ReplacementType::Literal, Replacements[3].Type);
270   EXPECT_EQ("-", Replacements[3].Spec);
271 
272   // {2,-3:bar} - Options=bar, Align=-3
273   EXPECT_EQ(ReplacementType::Format, Replacements[4].Type);
274   EXPECT_EQ(2u, Replacements[4].Index);
275   EXPECT_EQ(3u, Replacements[4].Width);
276   EXPECT_EQ(AlignStyle::Left, Replacements[4].Where);
277   EXPECT_EQ("bar", Replacements[4].Options);
278 }
279 
280 TEST(FormatVariadicTest, AutomaticIndices) {
281   auto Replacements = parseFormatString("{}");
282   ASSERT_EQ(1u, Replacements.size());
283   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
284   EXPECT_EQ(0u, Replacements[0].Index);
285 
286   Replacements = parseFormatString("{}{}");
287   ASSERT_EQ(2u, Replacements.size());
288   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
289   EXPECT_EQ(0u, Replacements[0].Index);
290   EXPECT_EQ(ReplacementType::Format, Replacements[1].Type);
291   EXPECT_EQ(1u, Replacements[1].Index);
292 
293   Replacements = parseFormatString("{}{:foo}{,-3:bar}");
294   ASSERT_EQ(3u, Replacements.size());
295   EXPECT_EQ(ReplacementType::Format, Replacements[0].Type);
296   EXPECT_EQ(0u, Replacements[0].Index);
297   EXPECT_EQ(0u, Replacements[0].Width);
298   EXPECT_EQ(AlignStyle::Right, Replacements[0].Where);
299   EXPECT_EQ("", Replacements[0].Options);
300 
301   // {:foo} - Options=foo
302   EXPECT_EQ(ReplacementType::Format, Replacements[1].Type);
303   EXPECT_EQ(1u, Replacements[1].Index);
304   EXPECT_EQ(0u, Replacements[1].Width);
305   EXPECT_EQ(AlignStyle::Right, Replacements[1].Where);
306   EXPECT_EQ("foo", Replacements[1].Options);
307 
308   // {,-3:bar} - Options=bar, Align=-3
309   EXPECT_EQ(ReplacementType::Format, Replacements[2].Type);
310   EXPECT_EQ(2u, Replacements[2].Index);
311   EXPECT_EQ(3u, Replacements[2].Width);
312   EXPECT_EQ(AlignStyle::Left, Replacements[2].Where);
313   EXPECT_EQ("bar", Replacements[2].Options);
314 }
315 
316 TEST(FormatVariadicTest, FormatNoReplacements) {
317   EXPECT_EQ("", formatv("").str());
318   EXPECT_EQ("Test", formatv("Test").str());
319 }
320 
321 TEST(FormatVariadicTest, FormatBasicTypesOneReplacement) {
322   EXPECT_EQ("1", formatv("{0}", 1).str());
323   EXPECT_EQ("c", formatv("{0}", 'c').str());
324   EXPECT_EQ("-3", formatv("{0}", -3).str());
325   EXPECT_EQ("Test", formatv("{0}", "Test").str());
326   EXPECT_EQ("Test2", formatv("{0}", StringRef("Test2")).str());
327   EXPECT_EQ("Test3", formatv("{0}", std::string("Test3")).str());
328 }
329 
330 TEST(FormatVariadicTest, FormatAutomaticIndices) {
331   EXPECT_EQ("1", formatv("{}", 1).str());
332   EXPECT_EQ("c1", formatv("{}{}", 'c', 1).str());
333   EXPECT_EQ("c-1rrr-0xFF", formatv("{}-{,r-4}-{:X}", 'c', 1, 255).str());
334 }
335 
336 TEST(FormatVariadicTest, IntegralHexFormatting) {
337   // 1. Trivial cases.  Make sure hex is not the default.
338   EXPECT_EQ("0", formatv("{0}", 0).str());
339   EXPECT_EQ("2748", formatv("{0}", 0xABC).str());
340   EXPECT_EQ("-2748", formatv("{0}", -0xABC).str());
341 
342   // 3. various hex prefixes.
343   EXPECT_EQ("0xFF", formatv("{0:X}", 255).str());
344   EXPECT_EQ("0xFF", formatv("{0:X+}", 255).str());
345   EXPECT_EQ("0xff", formatv("{0:x}", 255).str());
346   EXPECT_EQ("0xff", formatv("{0:x+}", 255).str());
347   EXPECT_EQ("FF", formatv("{0:X-}", 255).str());
348   EXPECT_EQ("ff", formatv("{0:x-}", 255).str());
349 
350   // 5. Precision pads left of the most significant digit but right of the
351   // prefix (if one exists).
352   EXPECT_EQ("0xFF", formatv("{0:X2}", 255).str());
353   EXPECT_EQ("0xFF", formatv("{0:X+2}", 255).str());
354   EXPECT_EQ("0x0ff", formatv("{0:x3}", 255).str());
355   EXPECT_EQ("0x0ff", formatv("{0:x+3}", 255).str());
356   EXPECT_EQ("00FF", formatv("{0:X-4}", 255).str());
357   EXPECT_EQ("00ff", formatv("{0:x-4}", 255).str());
358 
359   // 6. Try some larger types.
360   EXPECT_EQ("0xDEADBEEFDEADBEEF",
361             formatv("{0:X16}", -2401053088876216593LL).str());
362   EXPECT_EQ("0xFEEBDAEDFEEBDAED",
363             formatv("{0:X16}", 0xFEEBDAEDFEEBDAEDULL).str());
364   EXPECT_EQ("0x00000000DEADBEEF", formatv("{0:X16}", 0xDEADBEEF).str());
365 
366   // 7. Padding should take into account the prefix
367   EXPECT_EQ("0xff", formatv("{0,4:x}", 255).str());
368   EXPECT_EQ(" 0xff", formatv("{0,5:x+}", 255).str());
369   EXPECT_EQ("  FF", formatv("{0,4:X-}", 255).str());
370   EXPECT_EQ("   ff", formatv("{0,5:x-}", 255).str());
371 
372   // 8. Including when it's been zero-padded
373   EXPECT_EQ("  0x0ff", formatv("{0,7:x3}", 255).str());
374   EXPECT_EQ(" 0x00ff", formatv("{0,7:x+4}", 255).str());
375   EXPECT_EQ("  000FF", formatv("{0,7:X-5}", 255).str());
376   EXPECT_EQ(" 0000ff", formatv("{0,7:x-6}", 255).str());
377 
378   // 9. Precision with default format specifier should work too
379   EXPECT_EQ("    255", formatv("{0,7:3}", 255).str());
380   EXPECT_EQ("   0255", formatv("{0,7:4}", 255).str());
381   EXPECT_EQ("  00255", formatv("{0,7:5}", 255).str());
382   EXPECT_EQ(" 000255", formatv("{0,7:6}", 255).str());
383 }
384 
385 TEST(FormatVariadicTest, PointerFormatting) {
386   // 1. Trivial cases.  Hex is default.  Default Precision is pointer width.
387   if (sizeof(void *) == 4) {
388     EXPECT_EQ("0x00000000", formatv("{0}", (void *)0).str());
389     EXPECT_EQ("0x00000ABC", formatv("{0}", (void *)0xABC).str());
390   } else {
391     EXPECT_EQ("0x0000000000000000", formatv("{0}", (void *)0).str());
392     EXPECT_EQ("0x0000000000000ABC", formatv("{0}", (void *)0xABC).str());
393   }
394 
395   // 2. But we can reduce the precision explicitly.
396   EXPECT_EQ("0x0", formatv("{0:0}", (void *)0).str());
397   EXPECT_EQ("0xABC", formatv("{0:0}", (void *)0xABC).str());
398   EXPECT_EQ("0x0000", formatv("{0:4}", (void *)0).str());
399   EXPECT_EQ("0x0ABC", formatv("{0:4}", (void *)0xABC).str());
400 
401   // 3. various hex prefixes.
402   EXPECT_EQ("0x0ABC", formatv("{0:X4}", (void *)0xABC).str());
403   EXPECT_EQ("0x0abc", formatv("{0:x4}", (void *)0xABC).str());
404   EXPECT_EQ("0ABC", formatv("{0:X-4}", (void *)0xABC).str());
405   EXPECT_EQ("0abc", formatv("{0:x-4}", (void *)0xABC).str());
406 }
407 
408 TEST(FormatVariadicTest, IntegralNumberFormatting) {
409   // 1. Test comma grouping with default widths and precisions.
410   EXPECT_EQ("0", formatv("{0:N}", 0).str());
411   EXPECT_EQ("10", formatv("{0:N}", 10).str());
412   EXPECT_EQ("100", formatv("{0:N}", 100).str());
413   EXPECT_EQ("1,000", formatv("{0:N}", 1000).str());
414   EXPECT_EQ("1,234,567,890", formatv("{0:N}", 1234567890).str());
415   EXPECT_EQ("-10", formatv("{0:N}", -10).str());
416   EXPECT_EQ("-100", formatv("{0:N}", -100).str());
417   EXPECT_EQ("-1,000", formatv("{0:N}", -1000).str());
418   EXPECT_EQ("-1,234,567,890", formatv("{0:N}", -1234567890).str());
419 
420   // 2. If there is no comma, width and precision pad to the same absolute
421   // size.
422   EXPECT_EQ(" 1", formatv("{0,2:N}", 1).str());
423 
424   // 3. But if there is a comma or negative sign, width factors them in but
425   // precision doesn't.
426   EXPECT_EQ(" 1,000", formatv("{0,6:N}", 1000).str());
427   EXPECT_EQ(" -1,000", formatv("{0,7:N}", -1000).str());
428 
429   // 4. Large widths all line up.
430   EXPECT_EQ("      1,000", formatv("{0,11:N}", 1000).str());
431   EXPECT_EQ("     -1,000", formatv("{0,11:N}", -1000).str());
432   EXPECT_EQ("   -100,000", formatv("{0,11:N}", -100000).str());
433 }
434 
435 TEST(FormatVariadicTest, StringFormatting) {
436   const char FooArray[] = "FooArray";
437   const char *FooPtr = "FooPtr";
438   llvm::StringRef FooRef("FooRef");
439   constexpr StringLiteral FooLiteral("FooLiteral");
440   std::string FooString("FooString");
441   // 1. Test that we can print various types of strings.
442   EXPECT_EQ(FooArray, formatv("{0}", FooArray).str());
443   EXPECT_EQ(FooPtr, formatv("{0}", FooPtr).str());
444   EXPECT_EQ(FooRef, formatv("{0}", FooRef).str());
445   EXPECT_EQ(FooLiteral, formatv("{0}", FooLiteral).str());
446   EXPECT_EQ(FooString, formatv("{0}", FooString).str());
447 
448   // 2. Test that the precision specifier prints the correct number of
449   // characters.
450   EXPECT_EQ("FooA", formatv("{0:4}", FooArray).str());
451   EXPECT_EQ("FooP", formatv("{0:4}", FooPtr).str());
452   EXPECT_EQ("FooR", formatv("{0:4}", FooRef).str());
453   EXPECT_EQ("FooS", formatv("{0:4}", FooString).str());
454 
455   // 3. And that padding works.
456   EXPECT_EQ("  FooA", formatv("{0,6:4}", FooArray).str());
457   EXPECT_EQ("  FooP", formatv("{0,6:4}", FooPtr).str());
458   EXPECT_EQ("  FooR", formatv("{0,6:4}", FooRef).str());
459   EXPECT_EQ("  FooS", formatv("{0,6:4}", FooString).str());
460 }
461 
462 TEST(FormatVariadicTest, CharFormatting) {
463   // 1. Not much to see here.  Just print a char with and without padding.
464   EXPECT_EQ("C", formatv("{0}", 'C').str());
465   EXPECT_EQ("  C", formatv("{0,3}", 'C').str());
466 
467   // 2. char is really an integral type though, where the only difference is
468   // that the "default" is to print the ASCII.  So if a non-default presentation
469   // specifier exists, it should print as an integer.
470   EXPECT_EQ("37", formatv("{0:D}", (char)37).str());
471   EXPECT_EQ("  037", formatv("{0,5:D3}", (char)37).str());
472 }
473 
474 TEST(FormatVariadicTest, BoolTest) {
475   // 1. Default style is lowercase text (same as 't')
476   EXPECT_EQ("true", formatv("{0}", true).str());
477   EXPECT_EQ("false", formatv("{0}", false).str());
478   EXPECT_EQ("true", formatv("{0:t}", true).str());
479   EXPECT_EQ("false", formatv("{0:t}", false).str());
480 
481   // 2. T - uppercase text
482   EXPECT_EQ("TRUE", formatv("{0:T}", true).str());
483   EXPECT_EQ("FALSE", formatv("{0:T}", false).str());
484 
485   // 3. D / d - integral
486   EXPECT_EQ("1", formatv("{0:D}", true).str());
487   EXPECT_EQ("0", formatv("{0:D}", false).str());
488   EXPECT_EQ("1", formatv("{0:d}", true).str());
489   EXPECT_EQ("0", formatv("{0:d}", false).str());
490 
491   // 4. Y - uppercase yes/no
492   EXPECT_EQ("YES", formatv("{0:Y}", true).str());
493   EXPECT_EQ("NO", formatv("{0:Y}", false).str());
494 
495   // 5. y - lowercase yes/no
496   EXPECT_EQ("yes", formatv("{0:y}", true).str());
497   EXPECT_EQ("no", formatv("{0:y}", false).str());
498 }
499 
500 TEST(FormatVariadicTest, DoubleFormatting) {
501   // Test exponents, fixed point, and percent formatting.
502 
503   // 1. Signed, unsigned, and zero exponent format.
504   EXPECT_EQ("0.000000E+00", formatv("{0:E}", 0.0).str());
505   EXPECT_EQ("-0.000000E+00", formatv("{0:E}", -0.0).str());
506   EXPECT_EQ("1.100000E+00", formatv("{0:E}", 1.1).str());
507   EXPECT_EQ("-1.100000E+00", formatv("{0:E}", -1.1).str());
508   EXPECT_EQ("1.234568E+03", formatv("{0:E}", 1234.5678).str());
509   EXPECT_EQ("-1.234568E+03", formatv("{0:E}", -1234.5678).str());
510   EXPECT_EQ("1.234568E-03", formatv("{0:E}", .0012345678).str());
511   EXPECT_EQ("-1.234568E-03", formatv("{0:E}", -.0012345678).str());
512 
513   // 2. With padding and precision.
514   EXPECT_EQ("  0.000E+00", formatv("{0,11:E3}", 0.0).str());
515   EXPECT_EQ(" -1.100E+00", formatv("{0,11:E3}", -1.1).str());
516   EXPECT_EQ("  1.235E+03", formatv("{0,11:E3}", 1234.5678).str());
517   EXPECT_EQ(" -1.235E-03", formatv("{0,11:E3}", -.0012345678).str());
518 
519   // 3. Signed, unsigned, and zero fixed point format.
520   EXPECT_EQ("0.00", formatv("{0:F}", 0.0).str());
521   EXPECT_EQ("-0.00", formatv("{0:F}", -0.0).str());
522   EXPECT_EQ("1.10", formatv("{0:F}", 1.1).str());
523   EXPECT_EQ("-1.10", formatv("{0:F}", -1.1).str());
524   EXPECT_EQ("1234.57", formatv("{0:F}", 1234.5678).str());
525   EXPECT_EQ("-1234.57", formatv("{0:F}", -1234.5678).str());
526   EXPECT_EQ("0.00", formatv("{0:F}", .0012345678).str());
527   EXPECT_EQ("-0.00", formatv("{0:F}", -.0012345678).str());
528 
529   // 2. With padding and precision.
530   EXPECT_EQ("   0.000", formatv("{0,8:F3}", 0.0).str());
531   EXPECT_EQ("  -1.100", formatv("{0,8:F3}", -1.1).str());
532   EXPECT_EQ("1234.568", formatv("{0,8:F3}", 1234.5678).str());
533   EXPECT_EQ("  -0.001", formatv("{0,8:F3}", -.0012345678).str());
534 }
535 
536 TEST(FormatVariadicTest, CustomPaddingCharacter) {
537   // 1. Padding with custom character
538   EXPECT_EQ("==123", formatv("{0,=+5}", 123).str());
539   EXPECT_EQ("=123=", formatv("{0,==5}", 123).str());
540   EXPECT_EQ("123==", formatv("{0,=-5}", 123).str());
541 
542   // 2. Combined with zero padding
543   EXPECT_EQ("=00123=", formatv("{0,==7:5}", 123).str());
544 }
545 
546 struct format_tuple {
547   const char *Fmt;
548   explicit format_tuple(const char *Fmt) : Fmt(Fmt) {}
549 
550   template <typename... Ts> auto operator()(Ts &&... Values) const {
551     return formatv(Fmt, std::forward<Ts>(Values)...);
552   }
553 };
554 
555 TEST(FormatVariadicTest, BigTest) {
556   using Tuple =
557       std::tuple<char, int, const char *, StringRef, std::string, double, float,
558                  void *, int, double, int64_t, uint64_t, double, uint8_t>;
559   Tuple Ts[] = {
560       Tuple('a', 1, "Str", StringRef(), std::string(), 3.14159, -.17532f,
561             (void *)nullptr, 123456, 6.02E23, -908234908423, 908234908422234,
562             std::numeric_limits<double>::quiet_NaN(), 0xAB),
563       Tuple('x', 0xDDB5B, "LongerStr", "StringRef", "std::string", -2.7,
564             .08215f, (void *)nullptr, 0, 6.62E-34, -908234908423,
565             908234908422234, std::numeric_limits<double>::infinity(), 0x0)};
566   // Test long string formatting with many edge cases combined.
567   const char *Intro =
568       "There are {{{0}} items in the tuple, and {{{1}} tuple(s) in the array.";
569   const char *Header =
570       "{0,6}|{1,8}|{2,=10}|{3,=10}|{4,=13}|{5,7}|{6,7}|{7,10}|{8,"
571       "-7}|{9,10}|{10,16}|{11,17}|{12,6}|{13,4}";
572   const char *Line =
573       "{0,6}|{1,8:X}|{2,=10}|{3,=10:5}|{4,=13}|{5,7:3}|{6,7:P2}|{7,"
574       "10:X8}|{8,-7:N}|{9,10:E4}|{10,16:N}|{11,17:D}|{12,6}|{13,"
575       "4:X}";
576 
577   std::string S;
578   llvm::raw_string_ostream Stream(S);
579   Stream << formatv(Intro, std::tuple_size<Tuple>::value, std::size(Ts))
580          << "\n";
581   Stream << formatv(Header, "Char", "HexInt", "Str", "Ref", "std::str",
582                     "double", "float", "pointer", "comma", "exp", "bigint",
583                     "bigint2", "limit", "byte")
584          << "\n";
585   for (auto &Item : Ts) {
586     Stream << std::apply(format_tuple(Line), Item) << "\n";
587   }
588   const char *Expected =
589       R"foo(There are {14} items in the tuple, and {2} tuple(s) in the array.
590   Char|  HexInt|   Str    |   Ref    |  std::str   | double|  float|   pointer|comma  |       exp|          bigint|          bigint2| limit|byte
591      a|     0x1|   Str    |          |             |  3.142|-17.53%|0x00000000|123,456|6.0200E+23|-908,234,908,423|  908234908422234|   nan|0xAB
592      x| 0xDDB5B|LongerStr |  Strin   | std::string | -2.700|  8.21%|0x00000000|0      |6.6200E-34|-908,234,908,423|  908234908422234|   INF| 0x0
593 )foo";
594 
595   EXPECT_EQ(Expected, S);
596 }
597 
598 TEST(FormatVariadicTest, Range) {
599   std::vector<int> IntRange = {1, 1, 2, 3, 5, 8, 13};
600 
601   // 1. Simple range with default separator and element style.
602   EXPECT_EQ("1, 1, 2, 3, 5, 8, 13",
603             formatv("{0}", make_range(IntRange.begin(), IntRange.end())).str());
604   EXPECT_EQ("1, 2, 3, 5, 8",
605             formatv("{0}", make_range(IntRange.begin() + 1, IntRange.end() - 1))
606                 .str());
607 
608   // 2. Non-default separator
609   EXPECT_EQ(
610       "1/1/2/3/5/8/13",
611       formatv("{0:$[/]}", make_range(IntRange.begin(), IntRange.end())).str());
612 
613   // 3. Default separator, non-default element style.
614   EXPECT_EQ(
615       "0x1, 0x1, 0x2, 0x3, 0x5, 0x8, 0xd",
616       formatv("{0:@[x]}", make_range(IntRange.begin(), IntRange.end())).str());
617 
618   // 4. Non-default separator and element style.
619   EXPECT_EQ(
620       "0x1 + 0x1 + 0x2 + 0x3 + 0x5 + 0x8 + 0xd",
621       formatv("{0:$[ + ]@[x]}", make_range(IntRange.begin(), IntRange.end()))
622           .str());
623 
624   // 5. Element style and/or separator using alternate delimeters to allow using
625   // delimeter characters as part of the separator.
626   EXPECT_EQ(
627       "<0x1><0x1><0x2><0x3><0x5><0x8><0xd>",
628       formatv("<{0:$[><]@(x)}>", make_range(IntRange.begin(), IntRange.end()))
629           .str());
630   EXPECT_EQ(
631       "[0x1][0x1][0x2][0x3][0x5][0x8][0xd]",
632       formatv("[{0:$(][)@[x]}]", make_range(IntRange.begin(), IntRange.end()))
633           .str());
634   EXPECT_EQ(
635       "(0x1)(0x1)(0x2)(0x3)(0x5)(0x8)(0xd)",
636       formatv("({0:$<)(>@<x>})", make_range(IntRange.begin(), IntRange.end()))
637           .str());
638 
639   // 5. Empty range.
640   EXPECT_EQ("", formatv("{0:$[+]@[x]}",
641                         make_range(IntRange.begin(), IntRange.begin()))
642                     .str());
643 
644   // 6. Empty separator and style.
645   EXPECT_EQ("11235813",
646             formatv("{0:$[]@<>}", make_range(IntRange.begin(), IntRange.end()))
647                 .str());
648 }
649 
650 TEST(FormatVariadicTest, Adapter) {
651   class Negative : public FormatAdapter<int> {
652   public:
653     explicit Negative(int N) : FormatAdapter<int>(std::move(N)) {}
654     void format(raw_ostream &S, StringRef Options) override { S << -Item; }
655   };
656 
657   EXPECT_EQ("-7", formatv("{0}", Negative(7)).str());
658 
659   int N = 171;
660 
661   EXPECT_EQ("  171  ",
662             formatv("{0}", fmt_align(N, AlignStyle::Center, 7)).str());
663   EXPECT_EQ("--171--",
664             formatv("{0}", fmt_align(N, AlignStyle::Center, 7, '-')).str());
665   EXPECT_EQ(" 171   ", formatv("{0}", fmt_pad(N, 1, 3)).str());
666   EXPECT_EQ("171171171171171", formatv("{0}", fmt_repeat(N, 5)).str());
667 
668   EXPECT_EQ(" ABABABABAB   ",
669             formatv("{0:X-}", fmt_pad(fmt_repeat(N, 5), 1, 3)).str());
670   EXPECT_EQ("   AB    AB    AB    AB    AB     ",
671             formatv("{0,=34:X-}", fmt_repeat(fmt_pad(N, 1, 3), 5)).str());
672 }
673 
674 TEST(FormatVariadicTest, MoveConstructor) {
675   auto fmt = formatv("{0} {1}", 1, 2);
676   auto fmt2 = std::move(fmt);
677   std::string S = std::string(fmt2);
678   EXPECT_EQ("1 2", S);
679 }
680 TEST(FormatVariadicTest, ImplicitConversions) {
681   std::string S = std::string(formatv("{0} {1}", 1, 2));
682   EXPECT_EQ("1 2", S);
683 
684   SmallString<4> S2 = formatv("{0} {1}", 1, 2);
685   EXPECT_EQ("1 2", S2);
686 }
687 
688 TEST(FormatVariadicTest, FormatAdapter) {
689   EXPECT_EQ("Format", formatv("{0}", Format(1)).str());
690 
691   Format var(1);
692   EXPECT_EQ("Format", formatv("{0}", var).str());
693   EXPECT_EQ("Format", formatv("{0}", std::move(var)).str());
694 
695   // Not supposed to compile
696   // const Format cvar(1);
697   // EXPECT_EQ("Format", formatv("{0}", cvar).str());
698 }
699 
700 TEST(FormatVariadicTest, FormatFormatvObject) {
701   EXPECT_EQ("Format", formatv("F{0}t", formatv("o{0}a", "rm")).str());
702   EXPECT_EQ("[   ! ]", formatv("[{0,+5}]", formatv("{0,-2}", "!")).str());
703 }
704 
705 namespace {
706 struct Recorder {
707   int Copied = 0, Moved = 0;
708   Recorder() = default;
709   Recorder(const Recorder &Copy) : Copied(1 + Copy.Copied), Moved(Copy.Moved) {}
710   Recorder(const Recorder &&Move)
711       : Copied(Move.Copied), Moved(1 + Move.Moved) {}
712 };
713 } // namespace
714 namespace llvm {
715 template <> struct format_provider<Recorder> {
716   static void format(const Recorder &R, raw_ostream &OS, StringRef style) {
717     OS << R.Copied << "C " << R.Moved << "M";
718   }
719 };
720 } // namespace
721 
722 TEST(FormatVariadicTest, CopiesAndMoves) {
723   Recorder R;
724   EXPECT_EQ("0C 0M", formatv("{0}", R).str());
725   EXPECT_EQ("0C 3M", formatv("{0}", std::move(R)).str());
726   EXPECT_EQ("0C 3M", formatv("{0}", Recorder()).str());
727   EXPECT_EQ(0, R.Copied);
728   EXPECT_EQ(0, R.Moved);
729 }
730 
731 namespace adl {
732 struct X {};
733 raw_ostream &operator<<(raw_ostream &OS, const X &) { return OS << "X"; }
734 } // namespace adl
735 TEST(FormatVariadicTest, FormatStreamable) {
736   adl::X X;
737   EXPECT_EQ("X", formatv("{0}", X).str());
738 }
739 
740 TEST(FormatVariadicTest, FormatError) {
741   auto E1 = make_error<StringError>("X", inconvertibleErrorCode());
742   EXPECT_EQ("X", formatv("{0}", E1).str());
743   EXPECT_TRUE(E1.isA<StringError>()); // not consumed
744   EXPECT_EQ("X", formatv("{0}", fmt_consume(std::move(E1))).str());
745   EXPECT_FALSE(E1.isA<StringError>()); // consumed
746 }
747 
748 TEST(FormatVariadicTest, FormatFilterRange) {
749   std::vector<int> Vec{0, 1, 2};
750   auto Range = map_range(Vec, [](int V) { return V + 1; });
751   EXPECT_EQ("1, 2, 3", formatv("{0}", Range).str());
752 }
753 
754 TEST(FormatVariadicTest, Validate) {
755 #ifndef NDEBUG
756 #if GTEST_HAS_DEATH_TEST
757   // If asserts are enabled, verify that invalid formatv calls cause assertions.
758   EXPECT_DEATH(formatv("{0}", 1, 2).str(), "Expected 1 Args, but got 2");
759   EXPECT_DEATH(formatv("{0} {2}", 1, 2, 3).str(),
760                "Replacement field indices cannot have holes");
761   EXPECT_DEATH(formatv("{}{1}", 0, 1).str(),
762                "Cannot mix automatic and explicit indices");
763 #else  // GTEST_HAS_DEATH_TEST
764   GTEST_SKIP() << "No support for EXPECT_DEATH";
765 #endif // GTEST_HAS_DEATH_TEST
766 #else  // NDEBUG
767   // If asserts are disabled, verify that validation is disabled.
768   EXPECT_EQ(formatv("{0}", 1, 2).str(), "1");
769   EXPECT_EQ(formatv("{0} {2}", 1, 2, 3).str(), "1 3");
770   EXPECT_EQ(formatv("{}{1}", 0, 1).str(), "01");
771 #endif // NDEBUG
772 }
773 
774 namespace {
775 
776 enum class Base { First };
777 
778 class IntegerValuesRange final
779     : public indexed_accessor_range<IntegerValuesRange, Base, int, int *, int> {
780 public:
781   using indexed_accessor_range<IntegerValuesRange, Base, int, int *,
782                                int>::indexed_accessor_range;
783 
784   static int dereference(const Base &, ptrdiff_t Index) {
785     return static_cast<int>(Index);
786   }
787 };
788 
789 TEST(FormatVariadicTest, FormatRangeNonRef) {
790   IntegerValuesRange Range(Base(), 0, 3);
791   EXPECT_EQ("0, 1, 2",
792             formatv("{0}", make_range(Range.begin(), Range.end())).str());
793 }
794 
795 } // namespace
796