2 * Copyright 2016 Facebook, Inc.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
17 #include <folly/Format.h>
19 #include <folly/portability/GTest.h>
23 using namespace folly;
26 void compareOctal(Uint u) {
27 char buf1[detail::kMaxOctalLength + 1];
28 buf1[detail::kMaxOctalLength] = '\0';
29 char* p = buf1 + detail::uintToOctal(buf1, detail::kMaxOctalLength, u);
31 char buf2[detail::kMaxOctalLength + 1];
32 EXPECT_LT(snprintf(buf2, sizeof(buf2), "%jo", static_cast<uintmax_t>(u)),
35 EXPECT_EQ(std::string(buf2), std::string(p));
39 void compareHex(Uint u) {
40 char buf1[detail::kMaxHexLength + 1];
41 buf1[detail::kMaxHexLength] = '\0';
42 char* p = buf1 + detail::uintToHexLower(buf1, detail::kMaxHexLength, u);
44 char buf2[detail::kMaxHexLength + 1];
45 EXPECT_LT(snprintf(buf2, sizeof(buf2), "%jx", static_cast<uintmax_t>(u)),
48 EXPECT_EQ(std::string(buf2), std::string(p));
52 void compareBinary(Uint u) {
53 char buf[detail::kMaxBinaryLength + 1];
54 buf[detail::kMaxBinaryLength] = '\0';
55 char* p = buf + detail::uintToBinary(buf, detail::kMaxBinaryLength, u);
63 tmp.push_back(u & 1 ? '1' : '0');
65 repr.assign(tmp.rbegin(), tmp.rend());
68 EXPECT_EQ(repr, std::string(p));
71 TEST(Format, uintToOctal) {
72 for (unsigned i = 0; i < (1u << 16) + 2; i++) {
77 TEST(Format, uintToHex) {
78 for (unsigned i = 0; i < (1u << 16) + 2; i++) {
83 TEST(Format, uintToBinary) {
84 for (unsigned i = 0; i < (1u << 16) + 2; i++) {
89 TEST(Format, Simple) {
90 EXPECT_EQ("hello", sformat("hello"));
91 EXPECT_EQ("42", sformat("{}", 42));
92 EXPECT_EQ("42 42", sformat("{0} {0}", 42));
93 EXPECT_EQ("00042 23 42", sformat("{0:05} {1:3} {0:4}", 42, 23));
94 EXPECT_EQ("hello world hello 42",
95 sformat("{0} {1} {0} {2}", "hello", "world", 42));
96 EXPECT_EQ("XXhelloXX", sformat("{:X^9}", "hello"));
97 EXPECT_EQ("XXX42XXXX", sformat("{:X^9}", 42));
98 EXPECT_EQ("-0xYYYY2a", sformat("{:Y=#9x}", -42));
99 EXPECT_EQ("*", sformat("{}", '*'));
100 EXPECT_EQ("42", sformat("{}", 42));
101 EXPECT_EQ("0042", sformat("{:04}", 42));
103 EXPECT_EQ("hello ", sformat("{:7}", "hello"));
104 EXPECT_EQ("hello ", sformat("{:<7}", "hello"));
105 EXPECT_EQ(" hello", sformat("{:>7}", "hello"));
107 EXPECT_EQ(" hi", sformat("{:>*}", 4, "hi"));
108 EXPECT_EQ(" hi!", sformat("{:*}{}", 3, "", "hi!"));
109 EXPECT_EQ(" 123", sformat("{:*}", 7, 123));
110 EXPECT_EQ("123 ", sformat("{:<*}", 7, 123));
111 EXPECT_EQ("----<=>----", sformat("{:-^*}", 11, "<=>"));
112 EXPECT_EQ("+++456+++", sformat("{2:+^*0}", 9, "unused", 456));
114 std::vector<int> v1 {10, 20, 30};
115 EXPECT_EQ("0020", sformat("{0[1]:04}", v1));
116 EXPECT_EQ("0020", svformat("{1:04}", v1));
117 EXPECT_EQ("10 20", svformat("{} {}", v1));
119 const std::vector<int> v2 = v1;
120 EXPECT_EQ("0020", sformat("{0[1]:04}", v2));
121 EXPECT_EQ("0020", svformat("{1:04}", v2));
122 EXPECT_THROW(sformat("{0[3]:04}", v2), std::out_of_range);
123 EXPECT_THROW(svformat("{3:04}", v2), std::out_of_range);
124 EXPECT_EQ("0020", sformat("{0[1]:04}", defaulted(v2, 42)));
125 EXPECT_EQ("0020", svformat("{1:04}", defaulted(v2, 42)));
126 EXPECT_EQ("0042", sformat("{0[3]:04}", defaulted(v2, 42)));
127 EXPECT_EQ("0042", svformat("{3:04}", defaulted(v2, 42)));
129 const int p[] = {10, 20, 30};
131 EXPECT_EQ("0020", sformat("{0[1]:04}", p));
132 EXPECT_EQ("0020", svformat("{1:04}", p));
133 EXPECT_EQ("0020", sformat("{0[1]:04}", q));
134 EXPECT_EQ("0020", svformat("{1:04}", q));
135 EXPECT_NE("", sformat("{}", q));
137 EXPECT_EQ("0x", sformat("{}", p).substr(0, 2));
138 EXPECT_EQ("10", svformat("{}", p));
139 EXPECT_EQ("0x", sformat("{}", q).substr(0, 2));
140 EXPECT_EQ("10", svformat("{}", q));
142 EXPECT_EQ("(null)", sformat("{}", q));
144 std::map<int, std::string> m { {10, "hello"}, {20, "world"} };
145 EXPECT_EQ("worldXX", sformat("{[20]:X<7}", m));
146 EXPECT_EQ("worldXX", svformat("{20:X<7}", m));
147 EXPECT_THROW(sformat("{[42]:X<7}", m), std::out_of_range);
148 EXPECT_THROW(svformat("{42:X<7}", m), std::out_of_range);
149 EXPECT_EQ("worldXX", sformat("{[20]:X<7}", defaulted(m, "meow")));
150 EXPECT_EQ("worldXX", svformat("{20:X<7}", defaulted(m, "meow")));
151 EXPECT_EQ("meowXXX", sformat("{[42]:X<7}", defaulted(m, "meow")));
152 EXPECT_EQ("meowXXX", svformat("{42:X<7}", defaulted(m, "meow")));
154 std::map<std::string, std::string> m2 { {"hello", "world"} };
155 EXPECT_EQ("worldXX", sformat("{[hello]:X<7}", m2));
156 EXPECT_EQ("worldXX", svformat("{hello:X<7}", m2));
157 EXPECT_THROW(sformat("{[none]:X<7}", m2), std::out_of_range);
158 EXPECT_THROW(svformat("{none:X<7}", m2), std::out_of_range);
159 EXPECT_EQ("worldXX", sformat("{[hello]:X<7}", defaulted(m2, "meow")));
160 EXPECT_EQ("worldXX", svformat("{hello:X<7}", defaulted(m2, "meow")));
161 EXPECT_EQ("meowXXX", sformat("{[none]:X<7}", defaulted(m2, "meow")));
162 EXPECT_EQ("meowXXX", svformat("{none:X<7}", defaulted(m2, "meow")));
164 // Test indexing in strings
165 EXPECT_EQ("61 62", sformat("{0[0]:x} {0[1]:x}", "abcde"));
166 EXPECT_EQ("61 62", svformat("{0:x} {1:x}", "abcde"));
167 EXPECT_EQ("61 62", sformat("{0[0]:x} {0[1]:x}", std::string("abcde")));
168 EXPECT_EQ("61 62", svformat("{0:x} {1:x}", std::string("abcde")));
171 EXPECT_EQ("true", sformat("{}", true));
172 EXPECT_EQ("1", sformat("{:d}", true));
173 EXPECT_EQ("false", sformat("{}", false));
174 EXPECT_EQ("0", sformat("{:d}", false));
178 std::pair<int, std::string> p {42, "hello"};
179 EXPECT_EQ(" 42 hello ", sformat("{0[0]:6} {0[1]:6}", p));
180 EXPECT_EQ(" 42 hello ", svformat("{:6} {:6}", p));
185 std::tuple<int, std::string, int> t { 42, "hello", 23 };
186 EXPECT_EQ(" 42 hello 23", sformat("{0[0]:6} {0[1]:6} {0[2]:6}", t));
187 EXPECT_EQ(" 42 hello 23", svformat("{:6} {:6} {:6}", t));
190 // Test writing to stream
191 std::ostringstream os;
192 os << format("{} {}", 42, 23);
193 EXPECT_EQ("42 23", os.str());
195 // Test appending to string
197 format(&s, "{} {}", 42, 23);
198 format(&s, " hello {:X<7}", "world");
199 EXPECT_EQ("42 23 hello worldXX", s);
202 TEST(Format, Float) {
203 EXPECT_EQ("1", sformat("{}", 1.0));
204 EXPECT_EQ("0.1", sformat("{}", 0.1));
205 EXPECT_EQ("0.01", sformat("{}", 0.01));
206 EXPECT_EQ("0.001", sformat("{}", 0.001));
207 EXPECT_EQ("0.0001", sformat("{}", 0.0001));
208 EXPECT_EQ("1e-5", sformat("{}", 0.00001));
209 EXPECT_EQ("1e-6", sformat("{}", 0.000001));
211 EXPECT_EQ("10", sformat("{}", 10.0));
212 EXPECT_EQ("100", sformat("{}", 100.0));
213 EXPECT_EQ("1000", sformat("{}", 1000.0));
214 EXPECT_EQ("10000", sformat("{}", 10000.0));
215 EXPECT_EQ("100000", sformat("{}", 100000.0));
216 EXPECT_EQ("1e+6", sformat("{}", 1000000.0));
217 EXPECT_EQ("1e+7", sformat("{}", 10000000.0));
219 EXPECT_EQ("1.00", sformat("{:.2f}", 1.0));
220 EXPECT_EQ("0.10", sformat("{:.2f}", 0.1));
221 EXPECT_EQ("0.01", sformat("{:.2f}", 0.01));
222 EXPECT_EQ("0.00", sformat("{:.2f}", 0.001));
224 EXPECT_EQ("100000. !== 100000", sformat("{:.} !== {:.}", 100000.0, 100000));
225 EXPECT_EQ("100000.", sformat("{:.}", 100000.0));
226 EXPECT_EQ("1e+6", sformat("{:.}", 1000000.0));
227 EXPECT_EQ(" 100000.", sformat("{:8.}", 100000.0));
228 EXPECT_EQ("100000.", sformat("{:4.}", 100000.0));
229 EXPECT_EQ(" 100000", sformat("{:8.8}", 100000.0));
230 EXPECT_EQ(" 100000.", sformat("{:8.8.}", 100000.0));
233 TEST(Format, MultiLevel) {
234 std::vector<std::map<std::string, std::string>> v = {
240 EXPECT_EQ("world", sformat("{[0.hello]}", v));
243 TEST(Format, separatorDecimalInteger) {
244 EXPECT_EQ("0", sformat("{:,d}", 0));
245 EXPECT_EQ("1", sformat("{:d}", 1));
246 EXPECT_EQ("1", sformat("{:,d}", 1));
247 EXPECT_EQ("1", sformat("{:,}", 1));
248 EXPECT_EQ("123", sformat("{:d}", 123));
249 EXPECT_EQ("123", sformat("{:,d}", 123));
250 EXPECT_EQ("123", sformat("{:,}", 123));
251 EXPECT_EQ("1234", sformat("{:d}", 1234));
252 EXPECT_EQ("1,234", sformat("{:,d}", 1234));
253 EXPECT_EQ("1,234", sformat("{:,}", 1234));
254 EXPECT_EQ("12345678", sformat("{:d}", 12345678));
255 EXPECT_EQ("12,345,678", sformat("{:,d}", 12345678));
256 EXPECT_EQ("12,345,678", sformat("{:,}", 12345678));
257 EXPECT_EQ("-1234", sformat("{:d}", -1234));
258 EXPECT_EQ("-1,234", sformat("{:,d}", -1234));
259 EXPECT_EQ("-1,234", sformat("{:,}", -1234));
261 int64_t max_int64_t = std::numeric_limits<int64_t>::max();
262 int64_t min_int64_t = std::numeric_limits<int64_t>::min();
263 uint64_t max_uint64_t = std::numeric_limits<uint64_t>::max();
264 EXPECT_EQ("9223372036854775807", sformat("{:d}", max_int64_t));
265 EXPECT_EQ("9,223,372,036,854,775,807", sformat("{:,d}", max_int64_t));
266 EXPECT_EQ("9,223,372,036,854,775,807", sformat("{:,}", max_int64_t));
267 EXPECT_EQ("-9223372036854775808", sformat("{:d}", min_int64_t));
268 EXPECT_EQ("-9,223,372,036,854,775,808", sformat("{:,d}", min_int64_t));
269 EXPECT_EQ("-9,223,372,036,854,775,808", sformat("{:,}", min_int64_t));
270 EXPECT_EQ("18446744073709551615", sformat("{:d}", max_uint64_t));
271 EXPECT_EQ("18,446,744,073,709,551,615", sformat("{:,d}", max_uint64_t));
272 EXPECT_EQ("18,446,744,073,709,551,615", sformat("{:,}", max_uint64_t));
274 EXPECT_EQ(" -1,234", sformat("{: 8,}", -1234));
275 EXPECT_EQ("-001,234", sformat("{:08,d}", -1234));
276 EXPECT_EQ("-00001,234", sformat("{:010,d}", -1234));
277 EXPECT_EQ(" -1,234 ", sformat("{:^ 8,d}", -1234));
280 // Note that sformat("{:n}", ...) uses the current locale setting to insert the
281 // appropriate number separator characters.
282 TEST(Format, separatorNumber) {
283 EXPECT_EQ("0", sformat("{:n}", 0));
284 EXPECT_EQ("1", sformat("{:n}", 1));
285 EXPECT_EQ("123", sformat("{:n}", 123));
286 EXPECT_EQ("1234", sformat("{:n}", 1234));
287 EXPECT_EQ("12345678", sformat("{:n}", 12345678));
288 EXPECT_EQ("-1234", sformat("{:n}", -1234));
290 int64_t max_int64_t = std::numeric_limits<int64_t>::max();
291 int64_t min_int64_t = std::numeric_limits<int64_t>::min();
292 uint64_t max_uint64_t = std::numeric_limits<uint64_t>::max();
293 EXPECT_EQ("9223372036854775807", sformat("{:n}", max_int64_t));
294 EXPECT_EQ("-9223372036854775808", sformat("{:n}", min_int64_t));
295 EXPECT_EQ("18446744073709551615", sformat("{:n}", max_uint64_t));
297 EXPECT_EQ(" -1234", sformat("{: 8n}", -1234));
298 EXPECT_EQ("-0001234", sformat("{:08n}", -1234));
299 EXPECT_EQ("-000001234", sformat("{:010n}", -1234));
300 EXPECT_EQ(" -1234 ", sformat("{:^ 8n}", -1234));
303 // insertThousandsGroupingUnsafe requires non-const params
304 static void testGrouping(const char* a_str, const char* expected) {
306 char* end_ptr = str + snprintf(str, sizeof(str), "%s", a_str);
307 ASSERT_LT(end_ptr, str + sizeof(str));
308 folly::detail::insertThousandsGroupingUnsafe(str, &end_ptr);
309 ASSERT_STREQ(expected, str);
312 TEST(Format, separatorUnit) {
313 testGrouping("0", "0");
314 testGrouping("1", "1");
315 testGrouping("12", "12");
316 testGrouping("123", "123");
317 testGrouping("1234", "1,234");
318 testGrouping("12345", "12,345");
319 testGrouping("123456", "123,456");
320 testGrouping("1234567", "1,234,567");
321 testGrouping("1234567890", "1,234,567,890");
322 testGrouping("9223372036854775807", "9,223,372,036,854,775,807");
323 testGrouping("18446744073709551615", "18,446,744,073,709,551,615");
338 template <> class FormatValue<KeyValue> {
340 explicit FormatValue(const KeyValue& kv) : kv_(kv) { }
342 template <class FormatCallback>
343 void format(FormatArg& arg, FormatCallback& cb) const {
344 format_value::formatFormatter(
345 folly::format("<key={}, value={}>", kv_.key, kv_.value),
355 TEST(Format, Custom) {
356 KeyValue kv { "hello", 42 };
358 EXPECT_EQ("<key=hello, value=42>", sformat("{}", kv));
359 EXPECT_EQ("<key=hello, value=42>", sformat("{:10}", kv));
360 EXPECT_EQ("<key=hello", sformat("{:.10}", kv));
361 EXPECT_EQ("<key=hello, value=42>XX", sformat("{:X<23}", kv));
362 EXPECT_EQ("XX<key=hello, value=42>", sformat("{:X>23}", kv));
363 EXPECT_EQ("<key=hello, value=42>", sformat("{0[0]}", &kv));
364 EXPECT_NE("", sformat("{}", &kv));
375 #define EXPECT_THROW_STR(code, type, str) \
377 bool caught = false; \
380 } catch (const type& e) { \
382 EXPECT_TRUE(strstr(e.what(), (str)) != nullptr) << \
383 "Expected message [" << (str) << "], actual message [" << \
385 } catch (const std::exception& e) { \
387 ADD_FAILURE() << "Caught different exception type; expected " #type \
388 ", caught " << folly::demangle(typeid(e)); \
391 ADD_FAILURE() << "Caught unknown exception type; expected " #type; \
394 ADD_FAILURE() << "Expected exception " #type ", caught nothing"; \
398 #define EXPECT_FORMAT_ERROR(code, str) \
399 EXPECT_THROW_STR(code, folly::BadFormatArg, (str))
401 TEST(Format, Unformatted) {
403 EXPECT_NE("", sformat("{}", &o));
404 EXPECT_FORMAT_ERROR(sformat("{0[0]}", &o),
405 "No formatter available for this type");
408 TEST(Format, Nested) {
409 EXPECT_EQ("1 2 3 4", sformat("{} {} {}", 1, 2, format("{} {}", 3, 4)));
411 // not copyable, must hold temporary in scope instead.
412 auto&& saved = format("{} {}", 3, 4);
413 EXPECT_EQ("1 2 3 4", sformat("{} {} {}", 1, 2, saved));
416 TEST(Format, OutOfBounds) {
417 std::vector<int> ints{1, 2, 3, 4, 5};
418 EXPECT_EQ("1 3 5", sformat("{0[0]} {0[2]} {0[4]}", ints));
419 EXPECT_THROW(sformat("{[5]}", ints), std::out_of_range);
421 std::map<std::string, int> map{{"hello", 0}, {"world", 1}};
422 EXPECT_EQ("hello = 0", sformat("hello = {[hello]}", map));
423 EXPECT_THROW(sformat("{[nope]}", map), std::out_of_range);
424 EXPECT_THROW(svformat("{nope}", map), std::out_of_range);
427 TEST(Format, BogusFormatString) {
428 EXPECT_FORMAT_ERROR(sformat("}"), "single '}' in format string");
429 EXPECT_FORMAT_ERROR(sformat("foo}bar"), "single '}' in format string");
430 EXPECT_FORMAT_ERROR(sformat("foo{bar"), "missing ending '}'");
431 EXPECT_FORMAT_ERROR(sformat("{[test]"), "missing ending '}'");
432 EXPECT_FORMAT_ERROR(sformat("{-1.3}"), "argument index must be non-negative");
433 EXPECT_FORMAT_ERROR(sformat("{1.3}", 0, 1, 2), "index not allowed");
434 EXPECT_FORMAT_ERROR(sformat("{0} {} {1}", 0, 1, 2),
435 "may not have both default and explicit arg indexes");
436 EXPECT_FORMAT_ERROR(sformat("{:*}", 1.2),
437 "dynamic field width argument must be integral");
438 EXPECT_FORMAT_ERROR(sformat("{} {:*}", "hi"),
439 "argument index out of range, max=1");
441 sformat("{:*0}", 12, "ok"),
442 "cannot provide width arg index without value arg index"
445 sformat("{0:*}", 12, "ok"),
446 "cannot provide value arg index without width arg index"
449 std::vector<int> v{1, 2, 3};
450 EXPECT_FORMAT_ERROR(svformat("{:*}", v),
451 "dynamic field width not supported in vformat()");
453 // This one fails in detail::enforceWhitespace(), which throws
455 EXPECT_THROW_STR(sformat("{0[test}"), std::range_error, "Non-whitespace");
458 template <bool containerMode, class... Args>
459 class TestExtendingFormatter;
461 template <bool containerMode, class... Args>
462 class TestExtendingFormatter
463 : public BaseFormatter<TestExtendingFormatter<containerMode, Args...>,
467 explicit TestExtendingFormatter(StringPiece& str, Args&&... args)
468 : BaseFormatter<TestExtendingFormatter<containerMode, Args...>,
470 Args...>(str, std::forward<Args>(args)...) {}
472 template <size_t K, class Callback>
473 void doFormatArg(FormatArg& arg, Callback& cb) const {
475 auto appender = [&result](StringPiece s) {
476 result.append(s.data(), s.size());
478 std::get<K>(this->values_).format(arg, appender);
479 result = sformat("{{{}}}", result);
480 cb(StringPiece(result));
483 friend class BaseFormatter<TestExtendingFormatter<containerMode, Args...>,
487 template <class... A>
488 friend std::string texsformat(StringPiece fmt, A&&... arg);
491 template <class... Args>
492 std::string texsformat(StringPiece fmt, Args&&... args) {
493 return TestExtendingFormatter<false, Args...>(
494 fmt, std::forward<Args>(args)...).str();
497 TEST(Format, Extending) {
498 EXPECT_EQ(texsformat("I {} brackets", "love"), "I {love} brackets");
499 EXPECT_EQ(texsformat("I {} nesting", sformat("really {}", "love")),
500 "I {really love} nesting");
502 sformat("I also {} nesting", texsformat("have an {} for", "affinity")),
503 "I also have an {affinity} for nesting");
504 EXPECT_EQ(texsformat("Extending {} in {}",
505 texsformat("a {}", "formatter"),
506 "another formatter"),
507 "Extending {a {formatter}} in {another formatter}");