WPILibC++ 2027.0.0-alpha-3
Loading...
Searching...
No Matches
base.h
Go to the documentation of this file.
1// Formatting library for C++ - the base API for char/UTF-8
2//
3// Copyright (c) 2012 - present, Victor Zverovich
4// All rights reserved.
5//
6// For the license information refer to format.h.
7
8#ifndef FMT_BASE_H_
9#define FMT_BASE_H_
10
11#if defined(FMT_IMPORT_STD) && !defined(FMT_MODULE)
12# define FMT_MODULE
13#endif
14
15#ifndef FMT_MODULE
16# include <limits.h> // CHAR_BIT
17# include <stdio.h> // FILE
18# include <string.h> // memcmp
19
20# include <type_traits> // std::enable_if
21#endif
22
23// The fmt library version in the form major * 10000 + minor * 100 + patch.
24#define FMT_VERSION 120000
25
26// Detect compiler versions.
27#if defined(__clang__) && !defined(__ibmxl__)
28# define FMT_CLANG_VERSION (__clang_major__ * 100 + __clang_minor__)
29#else
30# define FMT_CLANG_VERSION 0
31#endif
32#if defined(__GNUC__) && !defined(__clang__) && !defined(__INTEL_COMPILER)
33# define FMT_GCC_VERSION (__GNUC__ * 100 + __GNUC_MINOR__)
34#else
35# define FMT_GCC_VERSION 0
36#endif
37#if defined(__ICL)
38# define FMT_ICC_VERSION __ICL
39#elif defined(__INTEL_COMPILER)
40# define FMT_ICC_VERSION __INTEL_COMPILER
41#else
42# define FMT_ICC_VERSION 0
43#endif
44#if defined(_MSC_VER)
45# define FMT_MSC_VERSION _MSC_VER
46#else
47# define FMT_MSC_VERSION 0
48#endif
49
50// Detect standard library versions.
51#ifdef _GLIBCXX_RELEASE
52# define FMT_GLIBCXX_RELEASE _GLIBCXX_RELEASE
53#else
54# define FMT_GLIBCXX_RELEASE 0
55#endif
56#ifdef _LIBCPP_VERSION
57# define FMT_LIBCPP_VERSION _LIBCPP_VERSION
58#else
59# define FMT_LIBCPP_VERSION 0
60#endif
61
62#ifdef _MSVC_LANG
63# define FMT_CPLUSPLUS _MSVC_LANG
64#else
65# define FMT_CPLUSPLUS __cplusplus
66#endif
67
68// Detect __has_*.
69#ifdef __has_feature
70# define FMT_HAS_FEATURE(x) __has_feature(x)
71#else
72# define FMT_HAS_FEATURE(x) 0
73#endif
74#ifdef __has_include
75# define FMT_HAS_INCLUDE(x) __has_include(x)
76#else
77# define FMT_HAS_INCLUDE(x) 0
78#endif
79#ifdef __has_builtin
80# define FMT_HAS_BUILTIN(x) __has_builtin(x)
81#else
82# define FMT_HAS_BUILTIN(x) 0
83#endif
84#ifdef __has_cpp_attribute
85# define FMT_HAS_CPP_ATTRIBUTE(x) __has_cpp_attribute(x)
86#else
87# define FMT_HAS_CPP_ATTRIBUTE(x) 0
88#endif
89
90#define FMT_HAS_CPP14_ATTRIBUTE(attribute) \
91 (FMT_CPLUSPLUS >= 201402L && FMT_HAS_CPP_ATTRIBUTE(attribute))
92
93#define FMT_HAS_CPP17_ATTRIBUTE(attribute) \
94 (FMT_CPLUSPLUS >= 201703L && FMT_HAS_CPP_ATTRIBUTE(attribute))
95
96// Detect C++14 relaxed constexpr.
97#ifdef FMT_USE_CONSTEXPR
98// Use the provided definition.
99#elif FMT_GCC_VERSION >= 702 && FMT_CPLUSPLUS >= 201402L
100// GCC only allows constexpr member functions in non-literal types since 7.2:
101// https://gcc.gnu.org/bugzilla/show_bug.cgi?id=66297.
102# define FMT_USE_CONSTEXPR 1
103#elif FMT_ICC_VERSION
104# define FMT_USE_CONSTEXPR 0 // https://github.com/fmtlib/fmt/issues/1628
105#elif FMT_HAS_FEATURE(cxx_relaxed_constexpr) || FMT_MSC_VERSION >= 1912
106# define FMT_USE_CONSTEXPR 1
107#else
108# define FMT_USE_CONSTEXPR 0
109#endif
110#if FMT_USE_CONSTEXPR
111# define FMT_CONSTEXPR constexpr
112#else
113# define FMT_CONSTEXPR
114#endif
115
116// Detect consteval, C++20 constexpr extensions and std::is_constant_evaluated.
117#if !defined(__cpp_lib_is_constant_evaluated)
118# define FMT_USE_CONSTEVAL 0
119#elif FMT_CPLUSPLUS < 201709L
120# define FMT_USE_CONSTEVAL 0
121#elif FMT_GLIBCXX_RELEASE && FMT_GLIBCXX_RELEASE < 10
122# define FMT_USE_CONSTEVAL 0
123#elif FMT_LIBCPP_VERSION && FMT_LIBCPP_VERSION < 10000
124# define FMT_USE_CONSTEVAL 0
125#elif defined(__apple_build_version__) && __apple_build_version__ < 14000029L
126# define FMT_USE_CONSTEVAL 0 // consteval is broken in Apple clang < 14.
127#elif FMT_MSC_VERSION && FMT_MSC_VERSION < 1929
128# define FMT_USE_CONSTEVAL 0 // consteval is broken in MSVC VS2019 < 16.10.
129#elif defined(__cpp_consteval)
130# define FMT_USE_CONSTEVAL 1
131#elif FMT_GCC_VERSION >= 1002 || FMT_CLANG_VERSION >= 1101
132# define FMT_USE_CONSTEVAL 1
133#else
134# define FMT_USE_CONSTEVAL 0
135#endif
136#if FMT_USE_CONSTEVAL
137# define FMT_CONSTEVAL consteval
138# define FMT_CONSTEXPR20 constexpr
139#else
140# define FMT_CONSTEVAL
141# define FMT_CONSTEXPR20
142#endif
143
144// Check if exceptions are disabled.
145#ifdef FMT_USE_EXCEPTIONS
146// Use the provided definition.
147#elif defined(__GNUC__) && !defined(__EXCEPTIONS)
148# define FMT_USE_EXCEPTIONS 0
149#elif defined(__clang__) && !defined(__cpp_exceptions)
150# define FMT_USE_EXCEPTIONS 0
151#elif FMT_MSC_VERSION && !_HAS_EXCEPTIONS
152# define FMT_USE_EXCEPTIONS 0
153#else
154# define FMT_USE_EXCEPTIONS 1
155#endif
156#if FMT_USE_EXCEPTIONS
157# define FMT_TRY try
158# define FMT_CATCH(x) catch (x)
159#else
160# define FMT_TRY if (true)
161# define FMT_CATCH(x) if (false)
162#endif
163
164#ifdef FMT_NO_UNIQUE_ADDRESS
165// Use the provided definition.
166#elif FMT_CPLUSPLUS < 202002L
167// Not supported.
168#elif FMT_HAS_CPP_ATTRIBUTE(no_unique_address)
169# define FMT_NO_UNIQUE_ADDRESS [[no_unique_address]]
170// VS2019 v16.10 and later except clang-cl (https://reviews.llvm.org/D110485).
171#elif FMT_MSC_VERSION >= 1929 && !FMT_CLANG_VERSION
172# define FMT_NO_UNIQUE_ADDRESS [[msvc::no_unique_address]]
173#endif
174#ifndef FMT_NO_UNIQUE_ADDRESS
175# define FMT_NO_UNIQUE_ADDRESS
176#endif
177
178#if FMT_HAS_CPP17_ATTRIBUTE(fallthrough)
179# define FMT_FALLTHROUGH [[fallthrough]]
180#elif defined(__clang__)
181# define FMT_FALLTHROUGH [[clang::fallthrough]]
182#elif FMT_GCC_VERSION >= 700 && \
183 (!defined(__EDG_VERSION__) || __EDG_VERSION__ >= 520)
184# define FMT_FALLTHROUGH [[gnu::fallthrough]]
185#else
186# define FMT_FALLTHROUGH
187#endif
188
189// Disable [[noreturn]] on MSVC/NVCC because of bogus unreachable code warnings.
190#if FMT_HAS_CPP_ATTRIBUTE(noreturn) && !FMT_MSC_VERSION && !defined(__NVCC__)
191# define FMT_NORETURN [[noreturn]]
192#else
193# define FMT_NORETURN
194#endif
195
196#ifdef FMT_NODISCARD
197// Use the provided definition.
198#elif FMT_HAS_CPP17_ATTRIBUTE(nodiscard)
199# define FMT_NODISCARD [[nodiscard]]
200#else
201# define FMT_NODISCARD
202#endif
203
204#if FMT_GCC_VERSION || FMT_CLANG_VERSION
205# define FMT_VISIBILITY(value) __attribute__((visibility(value)))
206#else
207# define FMT_VISIBILITY(value)
208#endif
209
210// Detect pragmas.
211#define FMT_PRAGMA_IMPL(x) _Pragma(#x)
212#if FMT_GCC_VERSION >= 504 && !defined(__NVCOMPILER)
213// Workaround a _Pragma bug https://gcc.gnu.org/bugzilla/show_bug.cgi?id=59884
214// and an nvhpc warning: https://github.com/fmtlib/fmt/pull/2582.
215# define FMT_PRAGMA_GCC(x) FMT_PRAGMA_IMPL(GCC x)
216#else
217# define FMT_PRAGMA_GCC(x)
218#endif
219#if FMT_CLANG_VERSION
220# define FMT_PRAGMA_CLANG(x) FMT_PRAGMA_IMPL(clang x)
221#else
222# define FMT_PRAGMA_CLANG(x)
223#endif
224#if FMT_MSC_VERSION
225# define FMT_MSC_WARNING(...) __pragma(warning(__VA_ARGS__))
226#else
227# define FMT_MSC_WARNING(...)
228#endif
229
230// Enable minimal optimizations for more compact code in debug mode.
231FMT_PRAGMA_GCC(push_options)
232#if !defined(__OPTIMIZE__) && !defined(__CUDACC__) && !defined(FMT_MODULE)
233FMT_PRAGMA_GCC(optimize("Og"))
234# define FMT_GCC_OPTIMIZED
235#endif
236FMT_PRAGMA_CLANG(diagnostic push)
237
238#ifdef FMT_ALWAYS_INLINE
239// Use the provided definition.
240#elif FMT_GCC_VERSION || FMT_CLANG_VERSION
241# define FMT_ALWAYS_INLINE inline __attribute__((always_inline))
242#else
243# define FMT_ALWAYS_INLINE inline
244#endif
245// A version of FMT_ALWAYS_INLINE to prevent code bloat in debug mode.
246#if defined(NDEBUG) || defined(FMT_GCC_OPTIMIZED)
247# define FMT_INLINE FMT_ALWAYS_INLINE
248#else
249# define FMT_INLINE inline
250#endif
251
252#ifndef FMT_BEGIN_NAMESPACE
253# define FMT_BEGIN_NAMESPACE \
254 namespace fmt { \
255 inline namespace v12 {
256# define FMT_END_NAMESPACE \
257 } \
258 }
259#endif
260
261#ifndef FMT_EXPORT
262# define FMT_EXPORT
263# define FMT_BEGIN_EXPORT
264# define FMT_END_EXPORT
265#endif
266
267#ifdef _WIN32
268# define FMT_WIN32 1
269#else
270# define FMT_WIN32 0
271#endif
272
273#if !defined(FMT_HEADER_ONLY) && FMT_WIN32
274# if defined(FMT_LIB_EXPORT)
275# define FMT_API __declspec(dllexport)
276# elif defined(FMT_SHARED)
277# define FMT_API __declspec(dllimport)
278# endif
279#elif defined(FMT_LIB_EXPORT) || defined(FMT_SHARED)
280# define FMT_API FMT_VISIBILITY("default")
281#endif
282#ifndef FMT_API
283# define FMT_API
284#endif
285
286#ifndef FMT_OPTIMIZE_SIZE
287# define FMT_OPTIMIZE_SIZE 0
288#endif
289
290// FMT_BUILTIN_TYPE=0 may result in smaller library size at the cost of higher
291// per-call binary size by passing built-in types through the extension API.
292#ifndef FMT_BUILTIN_TYPES
293# define FMT_BUILTIN_TYPES 1
294#endif
295
296#define FMT_APPLY_VARIADIC(expr) \
297 using unused = int[]; \
298 (void)unused { 0, (expr, 0)... }
299
301
302// Implementations of enable_if_t and other metafunctions for older systems.
303template <bool B, typename T = void>
304using enable_if_t = typename std::enable_if<B, T>::type;
305template <bool B, typename T, typename F>
306using conditional_t = typename std::conditional<B, T, F>::type;
307template <bool B> using bool_constant = std::integral_constant<bool, B>;
308template <typename T>
309using remove_reference_t = typename std::remove_reference<T>::type;
310template <typename T>
311using remove_const_t = typename std::remove_const<T>::type;
312template <typename T>
313using remove_cvref_t = typename std::remove_cv<remove_reference_t<T>>::type;
314template <typename T>
315using make_unsigned_t = typename std::make_unsigned<T>::type;
316template <typename T>
317using underlying_t = typename std::underlying_type<T>::type;
318template <typename T> using decay_t = typename std::decay<T>::type;
319using nullptr_t = decltype(nullptr);
320
321#if (FMT_GCC_VERSION && FMT_GCC_VERSION < 500) || FMT_MSC_VERSION
322// A workaround for gcc 4.9 & MSVC v141 to make void_t work in a SFINAE context.
323template <typename...> struct void_t_impl {
324 using type = void;
325};
326template <typename... T> using void_t = typename void_t_impl<T...>::type;
327#else
328template <typename...> using void_t = void;
329#endif
330
331struct monostate {
332 constexpr monostate() {}
333};
334
335// An enable_if helper to be used in template parameters which results in much
336// shorter symbols: https://godbolt.org/z/sWw4vP. Extra parentheses are needed
337// to workaround a bug in MSVC 2019 (see #1140 and #1186).
338#ifdef FMT_DOC
339# define FMT_ENABLE_IF(...)
340#else
341# define FMT_ENABLE_IF(...) fmt::enable_if_t<(__VA_ARGS__), int> = 0
342#endif
343
344template <typename T> constexpr auto min_of(T a, T b) -> T {
345 return a < b ? a : b;
346}
347template <typename T> constexpr auto max_of(T a, T b) -> T {
348 return a > b ? a : b;
349}
350
351FMT_NORETURN FMT_API void assert_fail(const char* file, int line,
352 const char* message);
353
354namespace detail {
355// Suppresses "unused variable" warnings with the method described in
356// https://herbsutter.com/2009/10/18/mailbag-shutting-up-compiler-warnings/.
357// (void)var does not work on many Intel compilers.
358template <typename... T> FMT_CONSTEXPR void ignore_unused(const T&...) {}
359
360constexpr auto is_constant_evaluated(bool default_value = false) noexcept
361 -> bool {
362// Workaround for incompatibility between clang 14 and libstdc++ consteval-based
363// std::is_constant_evaluated: https://github.com/fmtlib/fmt/issues/3247.
364#if FMT_CPLUSPLUS >= 202002L && FMT_GLIBCXX_RELEASE >= 12 && \
365 (FMT_CLANG_VERSION >= 1400 && FMT_CLANG_VERSION < 1500)
366 ignore_unused(default_value);
367 return __builtin_is_constant_evaluated();
368#elif defined(__cpp_lib_is_constant_evaluated)
369 ignore_unused(default_value);
370 return std::is_constant_evaluated();
371#else
372 return default_value;
373#endif
374}
375
376// Suppresses "conditional expression is constant" warnings.
377template <typename T> FMT_ALWAYS_INLINE constexpr auto const_check(T val) -> T {
378 return val;
379}
380
381FMT_NORETURN FMT_API void assert_fail(const char* file, int line,
382 const char* message);
383
384#if defined(FMT_ASSERT)
385// Use the provided definition.
386#elif defined(NDEBUG)
387// FMT_ASSERT is not empty to avoid -Wempty-body.
388# define FMT_ASSERT(condition, message) \
389 fmt::detail::ignore_unused((condition), (message))
390#else
391# define FMT_ASSERT(condition, message) \
392 ((condition) /* void() fails with -Winvalid-constexpr on clang 4.0.1 */ \
393 ? (void)0 \
394 : ::fmt::assert_fail(__FILE__, __LINE__, (message)))
395#endif
396
397#ifdef FMT_USE_INT128
398// Use the provided definition.
399#elif defined(__SIZEOF_INT128__) && !defined(__NVCC__) && \
400 !(FMT_CLANG_VERSION && FMT_MSC_VERSION)
401# define FMT_USE_INT128 1
402using int128_opt = __int128_t; // An optional native 128-bit integer.
403using uint128_opt = __uint128_t;
404inline auto map(int128_opt x) -> int128_opt { return x; }
405inline auto map(uint128_opt x) -> uint128_opt { return x; }
406#else
407# define FMT_USE_INT128 0
408#endif
409#if !FMT_USE_INT128
410enum class int128_opt {};
411enum class uint128_opt {};
412// Reduce template instantiations.
413inline auto map(int128_opt) -> monostate { return {}; }
414inline auto map(uint128_opt) -> monostate { return {}; }
415#endif
416
417#ifndef FMT_USE_BITINT
418# define FMT_USE_BITINT (FMT_CLANG_VERSION >= 1500)
419#endif
420
421#if FMT_USE_BITINT
422FMT_PRAGMA_CLANG(diagnostic ignored "-Wbit-int-extension")
423template <int N> using bitint = _BitInt(N);
424template <int N> using ubitint = unsigned _BitInt(N);
425#else
426template <int N> struct bitint {};
427template <int N> struct ubitint {};
428#endif // FMT_USE_BITINT
429
430// Casts a nonnegative integer to unsigned.
431template <typename Int>
433 FMT_ASSERT(std::is_unsigned<Int>::value || value >= 0, "negative value");
434 return static_cast<make_unsigned_t<Int>>(value);
435}
436
437template <typename Char>
438using unsigned_char = conditional_t<sizeof(Char) == 1, unsigned char, unsigned>;
439
440// A heuristic to detect std::string and std::[experimental::]string_view.
441// It is mainly used to avoid dependency on <[experimental/]string_view>.
442template <typename T, typename Enable = void>
443struct is_std_string_like : std::false_type {};
444template <typename T>
445struct is_std_string_like<T, void_t<decltype(std::declval<T>().find_first_of(
446 typename T::value_type(), 0))>>
447 : std::is_convertible<decltype(std::declval<T>().data()),
448 const typename T::value_type*> {};
449
450// Check if the literal encoding is UTF-8.
451enum { is_utf8_enabled = "\u00A7"[1] == '\xA7' };
453
454#ifndef FMT_UNICODE
455# define FMT_UNICODE 1
456#endif
457
458static_assert(!FMT_UNICODE || use_utf8,
459 "Unicode support requires compiling with /utf-8");
460
461template <typename T> constexpr auto narrow(T*) -> char* { return nullptr; }
462constexpr FMT_ALWAYS_INLINE auto narrow(const char* s) -> const char* {
463 return s;
464}
465
466template <typename Char>
467FMT_CONSTEXPR auto compare(const Char* s1, const Char* s2, size_t n) -> int {
468 if (!is_constant_evaluated() && sizeof(Char) == 1) return memcmp(s1, s2, n);
469 for (; n != 0; ++s1, ++s2, --n) {
470 if (*s1 < *s2) return -1;
471 if (*s1 > *s2) return 1;
472 }
473 return 0;
474}
475
476namespace adl {
477using namespace std;
478
479template <typename Container>
481 -> decltype(back_inserter(std::declval<Container&>()));
482} // namespace adl
483
484template <typename It, typename Enable = std::true_type>
485struct is_back_insert_iterator : std::false_type {};
486
487template <typename It>
489 It, bool_constant<std::is_same<
490 decltype(adl::invoke_back_inserter<typename It::container_type>()),
491 It>::value>> : std::true_type {};
492
493// Extracts a reference to the container from *insert_iterator.
494template <typename OutputIt>
495inline FMT_CONSTEXPR20 auto get_container(OutputIt it) ->
496 typename OutputIt::container_type& {
497 struct accessor : OutputIt {
498 FMT_CONSTEXPR20 accessor(OutputIt base) : OutputIt(base) {}
499 using OutputIt::container;
500 };
501 return *accessor(it).container;
502}
503} // namespace detail
504
505// Parsing-related public API and forward declarations.
507
508/**
509 * An implementation of `std::basic_string_view` for pre-C++17. It provides a
510 * subset of the API. `fmt::basic_string_view` is used for format strings even
511 * if `std::basic_string_view` is available to prevent issues when a library is
512 * compiled with a different `-std` option than the client code (which is not
513 * recommended).
514 */
515template <typename Char> class basic_string_view {
516 private:
517 const Char* data_;
518 size_t size_;
519
520 public:
521 using value_type = Char;
522 using iterator = const Char*;
523
524 constexpr basic_string_view() noexcept : data_(nullptr), size_(0) {}
525
526 /// Constructs a string view object from a C string and a size.
527 constexpr basic_string_view(const Char* s, size_t count) noexcept
528 : data_(s), size_(count) {}
529
530 constexpr basic_string_view(nullptr_t) = delete;
531
532 /// Constructs a string view object from a C string.
533#if FMT_GCC_VERSION
535#endif
536 FMT_CONSTEXPR20 basic_string_view(const Char* s) : data_(s) {
537#if FMT_HAS_BUILTIN(__builtin_strlen) || FMT_GCC_VERSION || FMT_CLANG_VERSION
538 if (std::is_same<Char, char>::value && !detail::is_constant_evaluated()) {
539 size_ = __builtin_strlen(detail::narrow(s)); // strlen is not constexpr.
540 return;
541 }
542#endif
543 size_t len = 0;
544 while (*s++) ++len;
545 size_ = len;
546 }
547
548 /// Constructs a string view from a `std::basic_string` or a
549 /// `std::basic_string_view` object.
550 template <typename S,
552 typename S::value_type, Char>::value)>
554 : data_(s.data()), size_(s.size()) {}
555
556 /// Returns a pointer to the string data.
557 constexpr auto data() const noexcept -> const Char* { return data_; }
558
559 /// Returns the string size.
560 constexpr auto size() const noexcept -> size_t { return size_; }
561
562 constexpr auto begin() const noexcept -> iterator { return data_; }
563 constexpr auto end() const noexcept -> iterator { return data_ + size_; }
564
565 constexpr auto operator[](size_t pos) const noexcept -> const Char& {
566 return data_[pos];
567 }
568
569 FMT_CONSTEXPR void remove_prefix(size_t n) noexcept {
570 data_ += n;
571 size_ -= n;
572 }
573
575 -> bool {
576 return size_ >= sv.size_ && detail::compare(data_, sv.data_, sv.size_) == 0;
577 }
578 FMT_CONSTEXPR auto starts_with(Char c) const noexcept -> bool {
579 return size_ >= 1 && *data_ == c;
580 }
581 FMT_CONSTEXPR auto starts_with(const Char* s) const -> bool {
583 }
584
585 FMT_CONSTEXPR auto compare(basic_string_view other) const -> int {
586 int result =
587 detail::compare(data_, other.data_, min_of(size_, other.size_));
588 if (result != 0) return result;
589 return size_ == other.size_ ? 0 : (size_ < other.size_ ? -1 : 1);
590 }
591
593 basic_string_view rhs) -> bool {
594 return lhs.compare(rhs) == 0;
595 }
596 friend auto operator!=(basic_string_view lhs, basic_string_view rhs) -> bool {
597 return lhs.compare(rhs) != 0;
598 }
599 friend auto operator<(basic_string_view lhs, basic_string_view rhs) -> bool {
600 return lhs.compare(rhs) < 0;
601 }
602 friend auto operator<=(basic_string_view lhs, basic_string_view rhs) -> bool {
603 return lhs.compare(rhs) <= 0;
604 }
605 friend auto operator>(basic_string_view lhs, basic_string_view rhs) -> bool {
606 return lhs.compare(rhs) > 0;
607 }
608 friend auto operator>=(basic_string_view lhs, basic_string_view rhs) -> bool {
609 return lhs.compare(rhs) >= 0;
610 }
611};
612
614
615template <typename T> class basic_appender;
617
618// Checks whether T is a container with contiguous storage.
619template <typename T> struct is_contiguous : std::false_type {};
620
621class context;
622template <typename OutputIt, typename Char> class generic_context;
623template <typename Char> class parse_context;
624
625// Longer aliases for C++20 compatibility.
626template <typename Char> using basic_format_parse_context = parse_context<Char>;
628template <typename OutputIt, typename Char>
633
634template <typename Char>
638
639template <typename Context> class basic_format_arg;
640template <typename Context> class basic_format_args;
641
642// A separate type would result in shorter symbols but break ABI compatibility
643// between clang and gcc on ARM (#1919).
645
646// A formatter for objects of type T.
647template <typename T, typename Char = char, typename Enable = void>
648struct formatter {
649 // A deleted default constructor indicates a disabled formatter.
650 formatter() = delete;
651};
652
653/// Reports a format error at compile time or, via a `format_error` exception,
654/// at runtime.
655// This function is intentionally not constexpr to give a compile-time error.
656FMT_NORETURN FMT_API void report_error(const char* message);
657
658enum class presentation_type : unsigned char {
659 // Common specifiers:
660 none = 0,
661 debug = 1, // '?'
662 string = 2, // 's' (string, bool)
663
664 // Integral, bool and character specifiers:
665 dec = 3, // 'd'
666 hex, // 'x' or 'X'
667 oct, // 'o'
668 bin, // 'b' or 'B'
669 chr, // 'c'
670
671 // String and pointer specifiers:
672 pointer = 3, // 'p'
673
674 // Floating-point specifiers:
675 exp = 1, // 'e' or 'E' (1 since there is no FP debug presentation)
676 fixed, // 'f' or 'F'
677 general, // 'g' or 'G'
678 hexfloat // 'a' or 'A'
679};
680
681enum class align { none, left, right, center, numeric };
682enum class sign { none, minus, plus, space };
683enum class arg_id_kind { none, index, name };
684
685// Basic format specifiers for built-in and string types.
687 private:
688 // Data is arranged as follows:
689 //
690 // 0 1 2 3
691 // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
692 // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
693 // |type |align| w | p | s |u|#|L| f | unused |
694 // +-----+-----+---+---+---+-+-+-+-----+---------------------------+
695 //
696 // w - dynamic width info
697 // p - dynamic precision info
698 // s - sign
699 // u - uppercase (e.g. 'X' for 'x')
700 // # - alternate form ('#')
701 // L - localized
702 // f - fill size
703 //
704 // Bitfields are not used because of compiler bugs such as gcc bug 61414.
705 enum : unsigned {
706 type_mask = 0x00007,
707 align_mask = 0x00038,
708 width_mask = 0x000C0,
709 precision_mask = 0x00300,
710 sign_mask = 0x00C00,
711 uppercase_mask = 0x01000,
712 alternate_mask = 0x02000,
713 localized_mask = 0x04000,
714 fill_size_mask = 0x38000,
715
716 align_shift = 3,
717 width_shift = 6,
718 precision_shift = 8,
719 sign_shift = 10,
720 fill_size_shift = 15,
721
722 max_fill_size = 4
723 };
724
725 unsigned data_ = 1 << fill_size_shift;
726 static_assert(sizeof(basic_specs::data_) * CHAR_BIT >= 18, "");
727
728 // Character (code unit) type is erased to prevent template bloat.
729 char fill_data_[max_fill_size] = {' '};
730
731 FMT_CONSTEXPR void set_fill_size(size_t size) {
732 data_ = (data_ & ~fill_size_mask) |
733 (static_cast<unsigned>(size) << fill_size_shift);
734 }
735
736 public:
737 constexpr auto type() const -> presentation_type {
738 return static_cast<presentation_type>(data_ & type_mask);
739 }
741 data_ = (data_ & ~type_mask) | static_cast<unsigned>(t);
742 }
743
744 constexpr auto align() const -> align {
745 return static_cast<fmt::align>((data_ & align_mask) >> align_shift);
746 }
747 FMT_CONSTEXPR void set_align(fmt::align a) {
748 data_ = (data_ & ~align_mask) | (static_cast<unsigned>(a) << align_shift);
749 }
750
751 constexpr auto dynamic_width() const -> arg_id_kind {
752 return static_cast<arg_id_kind>((data_ & width_mask) >> width_shift);
753 }
755 data_ = (data_ & ~width_mask) | (static_cast<unsigned>(w) << width_shift);
756 }
757
759 return static_cast<arg_id_kind>((data_ & precision_mask) >>
760 precision_shift);
761 }
763 data_ = (data_ & ~precision_mask) |
764 (static_cast<unsigned>(p) << precision_shift);
765 }
766
767 constexpr auto dynamic() const -> bool {
768 return (data_ & (width_mask | precision_mask)) != 0;
769 }
770
771 constexpr auto sign() const -> sign {
772 return static_cast<fmt::sign>((data_ & sign_mask) >> sign_shift);
773 }
774 FMT_CONSTEXPR void set_sign(fmt::sign s) {
775 data_ = (data_ & ~sign_mask) | (static_cast<unsigned>(s) << sign_shift);
776 }
777
778 constexpr auto upper() const -> bool { return (data_ & uppercase_mask) != 0; }
779 FMT_CONSTEXPR void set_upper() { data_ |= uppercase_mask; }
780
781 constexpr auto alt() const -> bool { return (data_ & alternate_mask) != 0; }
782 FMT_CONSTEXPR void set_alt() { data_ |= alternate_mask; }
783 FMT_CONSTEXPR void clear_alt() { data_ &= ~alternate_mask; }
784
785 constexpr auto localized() const -> bool {
786 return (data_ & localized_mask) != 0;
787 }
788 FMT_CONSTEXPR void set_localized() { data_ |= localized_mask; }
789
790 constexpr auto fill_size() const -> size_t {
791 return (data_ & fill_size_mask) >> fill_size_shift;
792 }
793
794 template <typename Char, FMT_ENABLE_IF(std::is_same<Char, char>::value)>
795 constexpr auto fill() const -> const Char* {
796 return fill_data_;
797 }
798 template <typename Char, FMT_ENABLE_IF(!std::is_same<Char, char>::value)>
799 constexpr auto fill() const -> const Char* {
800 return nullptr;
801 }
802
803 template <typename Char> constexpr auto fill_unit() const -> Char {
804 using uchar = unsigned char;
805 return static_cast<Char>(static_cast<uchar>(fill_data_[0]) |
806 (static_cast<uchar>(fill_data_[1]) << 8) |
807 (static_cast<uchar>(fill_data_[2]) << 16));
808 }
809
810 FMT_CONSTEXPR void set_fill(char c) {
811 fill_data_[0] = c;
812 set_fill_size(1);
813 }
814
815 template <typename Char>
817 auto size = s.size();
818 set_fill_size(size);
819 if (size == 1) {
820 unsigned uchar = static_cast<detail::unsigned_char<Char>>(s[0]);
821 fill_data_[0] = static_cast<char>(uchar);
822 fill_data_[1] = static_cast<char>(uchar >> 8);
823 fill_data_[2] = static_cast<char>(uchar >> 16);
824 return;
825 }
826 FMT_ASSERT(size <= max_fill_size, "invalid fill");
827 for (size_t i = 0; i < size; ++i)
828 fill_data_[i & 3] = static_cast<char>(s[i]);
829 }
830
832 set_fill_size(specs.fill_size());
833 for (size_t i = 0; i < max_fill_size; ++i)
834 fill_data_[i] = specs.fill_data_[i];
835 }
836};
837
838// Format specifiers for built-in and string types.
840 int width;
842
843 constexpr format_specs() : width(0), precision(-1) {}
844};
845
846/**
847 * Parsing context consisting of a format string range being parsed and an
848 * argument counter for automatic indexing.
849 */
850template <typename Char = char> class parse_context {
851 private:
853 int next_arg_id_;
854
855 enum { use_constexpr_cast = !FMT_GCC_VERSION || FMT_GCC_VERSION >= 1200 };
856
857 FMT_CONSTEXPR void do_check_arg_id(int arg_id);
858
859 public:
860 using char_type = Char;
861 using iterator = const Char*;
862
864 int next_arg_id = 0)
865 : fmt_(fmt), next_arg_id_(next_arg_id) {}
866
867 /// Returns an iterator to the beginning of the format string range being
868 /// parsed.
869 constexpr auto begin() const noexcept -> iterator { return fmt_.begin(); }
870
871 /// Returns an iterator past the end of the format string range being parsed.
872 constexpr auto end() const noexcept -> iterator { return fmt_.end(); }
873
874 /// Advances the begin iterator to `it`.
878
879 /// Reports an error if using the manual argument indexing; otherwise returns
880 /// the next argument index and switches to the automatic indexing.
882 if (next_arg_id_ < 0) {
883 report_error("cannot switch from manual to automatic argument indexing");
884 return 0;
885 }
886 int id = next_arg_id_++;
887 do_check_arg_id(id);
888 return id;
889 }
890
891 /// Reports an error if using the automatic argument indexing; otherwise
892 /// switches to the manual indexing.
894 if (next_arg_id_ > 0) {
895 report_error("cannot switch from automatic to manual argument indexing");
896 return;
897 }
898 next_arg_id_ = -1;
899 do_check_arg_id(id);
900 }
902 next_arg_id_ = -1;
903 }
905};
906
907#ifndef FMT_USE_LOCALE
908# define FMT_USE_LOCALE (FMT_OPTIMIZE_SIZE <= 1)
909#endif
910
911// A type-erased reference to std::locale to avoid the heavy <locale> include.
913#if FMT_USE_LOCALE
914 private:
915 const void* locale_; // A type-erased pointer to std::locale.
916
917 public:
918 constexpr locale_ref() : locale_(nullptr) {}
919
920 template <typename Locale, FMT_ENABLE_IF(sizeof(Locale::collate) != 0)>
921 locale_ref(const Locale& loc);
922
923 inline explicit operator bool() const noexcept { return locale_ != nullptr; }
924#endif // FMT_USE_LOCALE
925
926 public:
927 template <typename Locale> auto get() const -> Locale;
928};
929
931
932namespace detail {
933
934// Specifies if `T` is a code unit type.
935template <typename T> struct is_code_unit : std::false_type {};
936template <> struct is_code_unit<char> : std::true_type {};
937template <> struct is_code_unit<wchar_t> : std::true_type {};
938template <> struct is_code_unit<char16_t> : std::true_type {};
939template <> struct is_code_unit<char32_t> : std::true_type {};
940#ifdef __cpp_char8_t
941template <> struct is_code_unit<char8_t> : bool_constant<is_utf8_enabled> {};
942#endif
943
944// Constructs fmt::basic_string_view<Char> from types implicitly convertible
945// to it, deducing Char. Explicitly convertible types such as the ones returned
946// from FMT_STRING are intentionally excluded.
947template <typename Char, FMT_ENABLE_IF(is_code_unit<Char>::value)>
948constexpr auto to_string_view(const Char* s) -> basic_string_view<Char> {
949 return s;
950}
951template <typename T, FMT_ENABLE_IF(is_std_string_like<T>::value)>
952constexpr auto to_string_view(const T& s)
954 return s;
955}
956template <typename Char>
959 return s;
960}
961
962template <typename T, typename Enable = void>
963struct has_to_string_view : std::false_type {};
964// detail:: is intentional since to_string_view is not an extension point.
965template <typename T>
967 T, void_t<decltype(detail::to_string_view(std::declval<T>()))>>
968 : std::true_type {};
969
970/// String's character (code unit) type. detail:: is intentional to prevent ADL.
971template <typename S,
972 typename V = decltype(detail::to_string_view(std::declval<S>()))>
973using char_t = typename V::value_type;
974
975enum class type {
976 none_type,
977 // Integer types should go first,
978 int_type,
979 uint_type,
984 bool_type,
985 char_type,
987 // followed by floating-point types.
996};
997
998// Maps core type T to the corresponding type enum constant.
999template <typename T, typename Char>
1000struct type_constant : std::integral_constant<type, type::custom_type> {};
1001
1002#define FMT_TYPE_CONSTANT(Type, constant) \
1003 template <typename Char> \
1004 struct type_constant<Type, Char> \
1005 : std::integral_constant<type, type::constant> {}
1006
1021
1022constexpr auto is_integral_type(type t) -> bool {
1023 return t > type::none_type && t <= type::last_integer_type;
1024}
1025constexpr auto is_arithmetic_type(type t) -> bool {
1026 return t > type::none_type && t <= type::last_numeric_type;
1027}
1028
1029constexpr auto set(type rhs) -> int { return 1 << static_cast<int>(rhs); }
1030constexpr auto in(type t, int set) -> bool {
1031 return ((set >> static_cast<int>(t)) & 1) != 0;
1032}
1033
1034// Bitsets of types.
1035enum {
1036 sint_set =
1048
1049struct view {};
1050
1051template <typename T, typename Enable = std::true_type>
1052struct is_view : std::false_type {};
1053template <typename T>
1054struct is_view<T, bool_constant<sizeof(T) != 0>> : std::is_base_of<view, T> {};
1055
1056template <typename Char, typename T> struct named_arg;
1057template <typename T> struct is_named_arg : std::false_type {};
1058template <typename T> struct is_static_named_arg : std::false_type {};
1059
1060template <typename Char, typename T>
1061struct is_named_arg<named_arg<Char, T>> : std::true_type {};
1062
1063template <typename Char, typename T> struct named_arg : view {
1064 const Char* name;
1065 const T& value;
1066
1067 named_arg(const Char* n, const T& v) : name(n), value(v) {}
1068 static_assert(!is_named_arg<T>::value, "nested named arguments");
1069};
1070
1071template <bool B = false> constexpr auto count() -> int { return B ? 1 : 0; }
1072template <bool B1, bool B2, bool... Tail> constexpr auto count() -> int {
1073 return (B1 ? 1 : 0) + count<B2, Tail...>();
1074}
1075
1076template <typename... T> constexpr auto count_named_args() -> int {
1077 return count<is_named_arg<T>::value...>();
1078}
1079template <typename... T> constexpr auto count_static_named_args() -> int {
1080 return count<is_static_named_arg<T>::value...>();
1081}
1082
1083template <typename Char> struct named_arg_info {
1084 const Char* name;
1085 int id;
1086};
1087
1088// named_args is non-const to suppress a bogus -Wmaybe-uninitialized in gcc 13.
1089template <typename Char>
1091 int named_arg_index,
1092 basic_string_view<Char> arg_name) {
1093 for (int i = 0; i < named_arg_index; ++i) {
1094 if (named_args[i].name == arg_name) report_error("duplicate named arg");
1095 }
1096}
1097
1098template <typename Char, typename T, FMT_ENABLE_IF(!is_named_arg<T>::value)>
1099void init_named_arg(named_arg_info<Char>*, int& arg_index, int&, const T&) {
1100 ++arg_index;
1101}
1102template <typename Char, typename T, FMT_ENABLE_IF(is_named_arg<T>::value)>
1103void init_named_arg(named_arg_info<Char>* named_args, int& arg_index,
1104 int& named_arg_index, const T& arg) {
1105 check_for_duplicate<Char>(named_args, named_arg_index, arg.name);
1106 named_args[named_arg_index++] = {arg.name, arg_index++};
1107}
1108
1109template <typename T, typename Char,
1110 FMT_ENABLE_IF(!is_static_named_arg<T>::value)>
1112 int&) {
1113 ++arg_index;
1114}
1115template <typename T, typename Char,
1116 FMT_ENABLE_IF(is_static_named_arg<T>::value)>
1117FMT_CONSTEXPR void init_static_named_arg(named_arg_info<Char>* named_args,
1118 int& arg_index, int& named_arg_index) {
1119 check_for_duplicate<Char>(named_args, named_arg_index, T::name);
1120 named_args[named_arg_index++] = {T::name, arg_index++};
1121}
1122
1123// To minimize the number of types we need to deal with, long is translated
1124// either to int or to long long depending on its size.
1125enum { long_short = sizeof(long) == sizeof(int) && FMT_BUILTIN_TYPES };
1128
1129template <typename T>
1132template <typename T>
1134 remove_cvref_t<decltype(formatter<T>::format_as(std::declval<const T&>()))>;
1135
1136template <typename T, typename Enable = std::true_type>
1137struct use_format_as : std::false_type {};
1138// format_as member is only used to avoid injection into the std namespace.
1139template <typename T, typename Enable = std::true_type>
1140struct use_format_as_member : std::false_type {};
1141
1142// Only map owning types because mapping views can be unsafe.
1143template <typename T>
1145 T, bool_constant<std::is_arithmetic<format_as_result<T>>::value>>
1146 : std::true_type {};
1147template <typename T>
1149 T, bool_constant<std::is_arithmetic<format_as_member_result<T>>::value>>
1150 : std::true_type {};
1151
1152template <typename T, typename U = remove_const_t<T>>
1154 bool_constant<(std::is_class<T>::value || std::is_enum<T>::value ||
1155 std::is_union<T>::value || std::is_array<T>::value) &&
1158
1159template <typename Char, typename T, typename U = remove_const_t<T>>
1161 -> decltype(formatter<U, Char>().format(*p, *ctx), std::true_type());
1162template <typename Char> auto has_formatter_impl(...) -> std::false_type;
1163
1164// T can be const-qualified to check if it is const-formattable.
1165template <typename T, typename Char> constexpr auto has_formatter() -> bool {
1166 return decltype(has_formatter_impl<Char>(static_cast<T*>(nullptr)))::value;
1167}
1168
1169// Maps formatting argument types to natively supported types or user-defined
1170// types with formatters. Returns void on errors to be SFINAE-friendly.
1171template <typename Char> struct type_mapper {
1172 static auto map(signed char) -> int;
1173 static auto map(unsigned char) -> unsigned;
1174 static auto map(short) -> int;
1175 static auto map(unsigned short) -> unsigned;
1176 static auto map(int) -> int;
1177 static auto map(unsigned) -> unsigned;
1178 static auto map(long) -> long_type;
1179 static auto map(unsigned long) -> ulong_type;
1180 static auto map(long long) -> long long;
1181 static auto map(unsigned long long) -> unsigned long long;
1182 static auto map(int128_opt) -> int128_opt;
1183 static auto map(uint128_opt) -> uint128_opt;
1184 static auto map(bool) -> bool;
1185
1186 template <int N>
1188 template <int N>
1189 static auto map(ubitint<N>)
1191
1192 template <typename T, FMT_ENABLE_IF(is_code_unit<T>::value)>
1193 static auto map(T) -> conditional_t<
1194 std::is_same<T, char>::value || std::is_same<T, Char>::value, Char, void>;
1195
1196 static auto map(float) -> float;
1197 static auto map(double) -> double;
1198 static auto map(long double) -> long double;
1199
1200 static auto map(Char*) -> const Char*;
1201 static auto map(const Char*) -> const Char*;
1202 template <typename T, typename C = char_t<T>,
1203 FMT_ENABLE_IF(!std::is_pointer<T>::value)>
1205 basic_string_view<C>, void>;
1206
1207 static auto map(void*) -> const void*;
1208 static auto map(const void*) -> const void*;
1209 static auto map(volatile void*) -> const void*;
1210 static auto map(const volatile void*) -> const void*;
1211 static auto map(nullptr_t) -> const void*;
1212 template <typename T, FMT_ENABLE_IF(std::is_pointer<T>::value ||
1213 std::is_member_pointer<T>::value)>
1214 static auto map(const T&) -> void;
1215
1216 template <typename T, FMT_ENABLE_IF(use_format_as<T>::value)>
1217 static auto map(const T& x) -> decltype(map(format_as(x)));
1218 template <typename T, FMT_ENABLE_IF(use_format_as_member<T>::value)>
1219 static auto map(const T& x) -> decltype(map(formatter<T>::format_as(x)));
1220
1221 template <typename T, FMT_ENABLE_IF(use_formatter<T>::value)>
1222 static auto map(T&) -> conditional_t<has_formatter<T, Char>(), T&, void>;
1223
1224 template <typename T, FMT_ENABLE_IF(is_named_arg<T>::value)>
1225 static auto map(const T& named_arg) -> decltype(map(named_arg.value));
1226};
1227
1228// detail:: is used to workaround a bug in MSVC 2017.
1229template <typename T, typename Char>
1230using mapped_t = decltype(detail::type_mapper<Char>::map(std::declval<T&>()));
1231
1232// A type constant after applying type_mapper.
1233template <typename T, typename Char = char>
1235
1236template <typename T, typename Context,
1237 type TYPE =
1239using stored_type_constant = std::integral_constant<
1240 type, Context::builtin_types || TYPE == type::int_type ? TYPE
1242// A parse context with extra data used only in compile-time checks.
1243template <typename Char>
1245 private:
1246 int num_args_;
1247 const type* types_;
1248 using base = parse_context<Char>;
1249
1250 public:
1252 int num_args, const type* types,
1253 int next_arg_id = 0)
1254 : base(fmt, next_arg_id), num_args_(num_args), types_(types) {}
1255
1256 constexpr auto num_args() const -> int { return num_args_; }
1257 constexpr auto arg_type(int id) const -> type { return types_[id]; }
1258
1260 int id = base::next_arg_id();
1261 if (id >= num_args_) report_error("argument not found");
1262 return id;
1263 }
1264
1267 if (id >= num_args_) report_error("argument not found");
1268 }
1269 using base::check_arg_id;
1270
1272 ignore_unused(arg_id);
1273 if (arg_id < num_args_ && types_ && !is_integral_type(types_[arg_id]))
1274 report_error("width/precision is not integer");
1275 }
1276};
1277
1278// An argument reference.
1279template <typename Char> union arg_ref {
1280 FMT_CONSTEXPR arg_ref(int idx = 0) : index(idx) {}
1282
1285};
1286
1287// Format specifiers with width and precision resolved at formatting rather
1288// than parsing time to allow reusing the same parsed specifiers with
1289// different sets of arguments (precompilation of format strings).
1294
1295// Converts a character to ASCII. Returns '\0' on conversion failure.
1296template <typename Char, FMT_ENABLE_IF(std::is_integral<Char>::value)>
1297constexpr auto to_ascii(Char c) -> char {
1298 return c <= 0xff ? static_cast<char>(c) : '\0';
1299}
1300
1301// Returns the number of code units in a code point or 1 on error.
1302template <typename Char>
1303FMT_CONSTEXPR auto code_point_length(const Char* begin) -> int {
1304 if (const_check(sizeof(Char) != 1)) return 1;
1305 auto c = static_cast<unsigned char>(*begin);
1306 return static_cast<int>((0x3a55000000000000ull >> (2 * (c >> 3))) & 3) + 1;
1307}
1308
1309// Parses the range [begin, end) as an unsigned integer. This function assumes
1310// that the range is non-empty and the first character is a digit.
1311template <typename Char>
1312FMT_CONSTEXPR auto parse_nonnegative_int(const Char*& begin, const Char* end,
1313 int error_value) noexcept -> int {
1314 FMT_ASSERT(begin != end && '0' <= *begin && *begin <= '9', "");
1315 unsigned value = 0, prev = 0;
1316 auto p = begin;
1317 do {
1318 prev = value;
1319 value = value * 10 + unsigned(*p - '0');
1320 ++p;
1321 } while (p != end && '0' <= *p && *p <= '9');
1322 auto num_digits = p - begin;
1323 begin = p;
1324 int digits10 = static_cast<int>(sizeof(int) * CHAR_BIT * 3 / 10);
1325 if (num_digits <= digits10) return static_cast<int>(value);
1326 // Check for overflow.
1327 unsigned max = INT_MAX;
1328 return num_digits == digits10 + 1 &&
1329 prev * 10ull + unsigned(p[-1] - '0') <= max
1330 ? static_cast<int>(value)
1331 : error_value;
1332}
1333
1334FMT_CONSTEXPR inline auto parse_align(char c) -> align {
1335 switch (c) {
1336 case '<': return align::left;
1337 case '>': return align::right;
1338 case '^': return align::center;
1339 }
1340 return align::none;
1341}
1342
1343template <typename Char> constexpr auto is_name_start(Char c) -> bool {
1344 return ('a' <= c && c <= 'z') || ('A' <= c && c <= 'Z') || c == '_';
1345}
1346
1347template <typename Char, typename Handler>
1348FMT_CONSTEXPR auto parse_arg_id(const Char* begin, const Char* end,
1349 Handler&& handler) -> const Char* {
1350 Char c = *begin;
1351 if (c >= '0' && c <= '9') {
1352 int index = 0;
1353 if (c != '0')
1354 index = parse_nonnegative_int(begin, end, INT_MAX);
1355 else
1356 ++begin;
1357 if (begin == end || (*begin != '}' && *begin != ':'))
1358 report_error("invalid format string");
1359 else
1360 handler.on_index(index);
1361 return begin;
1362 }
1363 if (FMT_OPTIMIZE_SIZE > 1 || !is_name_start(c)) {
1364 report_error("invalid format string");
1365 return begin;
1366 }
1367 auto it = begin;
1368 do {
1369 ++it;
1370 } while (it != end && (is_name_start(*it) || ('0' <= *it && *it <= '9')));
1371 handler.on_name({begin, to_unsigned(it - begin)});
1372 return it;
1373}
1374
1375template <typename Char> struct dynamic_spec_handler {
1379
1381 ref = id;
1383 ctx.check_arg_id(id);
1385 }
1391};
1392
1393template <typename Char> struct parse_dynamic_spec_result {
1394 const Char* end;
1396};
1397
1398// Parses integer | "{" [arg_id] "}".
1399template <typename Char>
1400FMT_CONSTEXPR auto parse_dynamic_spec(const Char* begin, const Char* end,
1401 int& value, arg_ref<Char>& ref,
1404 FMT_ASSERT(begin != end, "");
1405 auto kind = arg_id_kind::none;
1406 if ('0' <= *begin && *begin <= '9') {
1407 int val = parse_nonnegative_int(begin, end, -1);
1408 if (val == -1) report_error("number is too big");
1409 value = val;
1410 } else {
1411 if (*begin == '{') {
1412 ++begin;
1413 if (begin != end) {
1414 Char c = *begin;
1415 if (c == '}' || c == ':') {
1416 int id = ctx.next_arg_id();
1417 ref = id;
1418 kind = arg_id_kind::index;
1419 ctx.check_dynamic_spec(id);
1420 } else {
1421 begin = parse_arg_id(begin, end,
1422 dynamic_spec_handler<Char>{ctx, ref, kind});
1423 }
1424 }
1425 if (begin != end && *begin == '}') return {++begin, kind};
1426 }
1427 report_error("invalid format string");
1428 }
1429 return {begin, kind};
1430}
1431
1432template <typename Char>
1433FMT_CONSTEXPR auto parse_width(const Char* begin, const Char* end,
1434 format_specs& specs, arg_ref<Char>& width_ref,
1435 parse_context<Char>& ctx) -> const Char* {
1436 auto result = parse_dynamic_spec(begin, end, specs.width, width_ref, ctx);
1437 specs.set_dynamic_width(result.kind);
1438 return result.end;
1439}
1440
1441template <typename Char>
1442FMT_CONSTEXPR auto parse_precision(const Char* begin, const Char* end,
1443 format_specs& specs,
1444 arg_ref<Char>& precision_ref,
1445 parse_context<Char>& ctx) -> const Char* {
1446 ++begin;
1447 if (begin == end) {
1448 report_error("invalid precision");
1449 return begin;
1450 }
1451 auto result =
1452 parse_dynamic_spec(begin, end, specs.precision, precision_ref, ctx);
1453 specs.set_dynamic_precision(result.kind);
1454 return result.end;
1455}
1456
1458
1459// Parses standard format specifiers.
1460template <typename Char>
1461FMT_CONSTEXPR auto parse_format_specs(const Char* begin, const Char* end,
1463 parse_context<Char>& ctx, type arg_type)
1464 -> const Char* {
1465 auto c = '\0';
1466 if (end - begin > 1) {
1467 auto next = to_ascii(begin[1]);
1468 c = parse_align(next) == align::none ? to_ascii(*begin) : '\0';
1469 } else {
1470 if (begin == end) return begin;
1471 c = to_ascii(*begin);
1472 }
1473
1474 struct {
1475 state current_state = state::start;
1476 FMT_CONSTEXPR void operator()(state s, bool valid = true) {
1477 if (current_state >= s || !valid)
1478 report_error("invalid format specifier");
1479 current_state = s;
1480 }
1481 } enter_state;
1482
1483 using pres = presentation_type;
1484 constexpr auto integral_set = sint_set | uint_set | bool_set | char_set;
1485 struct {
1486 const Char*& begin;
1487 format_specs& specs;
1488 type arg_type;
1489
1490 FMT_CONSTEXPR auto operator()(pres pres_type, int set) -> const Char* {
1491 if (!in(arg_type, set)) report_error("invalid format specifier");
1492 specs.set_type(pres_type);
1493 return begin + 1;
1494 }
1495 } parse_presentation_type{begin, specs, arg_type};
1496
1497 for (;;) {
1498 switch (c) {
1499 case '<':
1500 case '>':
1501 case '^':
1502 enter_state(state::align);
1503 specs.set_align(parse_align(c));
1504 ++begin;
1505 break;
1506 case '+':
1507 case ' ':
1508 specs.set_sign(c == ' ' ? sign::space : sign::plus);
1510 case '-':
1511 enter_state(state::sign, in(arg_type, sint_set | float_set));
1512 ++begin;
1513 break;
1514 case '#':
1515 enter_state(state::hash, is_arithmetic_type(arg_type));
1516 specs.set_alt();
1517 ++begin;
1518 break;
1519 case '0':
1520 enter_state(state::zero);
1521 if (!is_arithmetic_type(arg_type))
1522 report_error("format specifier requires numeric argument");
1523 if (specs.align() == align::none) {
1524 // Ignore 0 if align is specified for compatibility with std::format.
1525 specs.set_align(align::numeric);
1526 specs.set_fill('0');
1527 }
1528 ++begin;
1529 break;
1530 // clang-format off
1531 case '1': case '2': case '3': case '4': case '5':
1532 case '6': case '7': case '8': case '9': case '{':
1533 // clang-format on
1534 enter_state(state::width);
1535 begin = parse_width(begin, end, specs, specs.width_ref, ctx);
1536 break;
1537 case '.':
1538 enter_state(state::precision,
1539 in(arg_type, float_set | string_set | cstring_set));
1540 begin = parse_precision(begin, end, specs, specs.precision_ref, ctx);
1541 break;
1542 case 'L':
1543 enter_state(state::locale, is_arithmetic_type(arg_type));
1544 specs.set_localized();
1545 ++begin;
1546 break;
1547 case 'd': return parse_presentation_type(pres::dec, integral_set);
1548 case 'X': specs.set_upper(); FMT_FALLTHROUGH;
1549 case 'x': return parse_presentation_type(pres::hex, integral_set);
1550 case 'o': return parse_presentation_type(pres::oct, integral_set);
1551 case 'B': specs.set_upper(); FMT_FALLTHROUGH;
1552 case 'b': return parse_presentation_type(pres::bin, integral_set);
1553 case 'E': specs.set_upper(); FMT_FALLTHROUGH;
1554 case 'e': return parse_presentation_type(pres::exp, float_set);
1555 case 'F': specs.set_upper(); FMT_FALLTHROUGH;
1556 case 'f': return parse_presentation_type(pres::fixed, float_set);
1557 case 'G': specs.set_upper(); FMT_FALLTHROUGH;
1558 case 'g': return parse_presentation_type(pres::general, float_set);
1559 case 'A': specs.set_upper(); FMT_FALLTHROUGH;
1560 case 'a': return parse_presentation_type(pres::hexfloat, float_set);
1561 case 'c':
1562 if (arg_type == type::bool_type) report_error("invalid format specifier");
1563 return parse_presentation_type(pres::chr, integral_set);
1564 case 's':
1565 return parse_presentation_type(pres::string,
1567 case 'p':
1568 return parse_presentation_type(pres::pointer, pointer_set | cstring_set);
1569 case '?':
1570 return parse_presentation_type(pres::debug,
1572 case '}': return begin;
1573 default: {
1574 if (*begin == '}') return begin;
1575 // Parse fill and alignment.
1576 auto fill_end = begin + code_point_length(begin);
1577 if (end - fill_end <= 0) {
1578 report_error("invalid format specifier");
1579 return begin;
1580 }
1581 if (*begin == '{') {
1582 report_error("invalid fill character '{'");
1583 return begin;
1584 }
1585 auto alignment = parse_align(to_ascii(*fill_end));
1586 enter_state(state::align, alignment != align::none);
1587 specs.set_fill(
1588 basic_string_view<Char>(begin, to_unsigned(fill_end - begin)));
1589 specs.set_align(alignment);
1590 begin = fill_end + 1;
1591 }
1592 }
1593 if (begin == end) return begin;
1594 c = to_ascii(*begin);
1595 }
1596}
1597
1598template <typename Char, typename Handler>
1600 const Char* end,
1601 Handler&& handler)
1602 -> const Char* {
1603 ++begin;
1604 if (begin == end) {
1605 handler.on_error("invalid format string");
1606 return end;
1607 }
1608 int arg_id = 0;
1609 switch (*begin) {
1610 case '}':
1611 handler.on_replacement_field(handler.on_arg_id(), begin);
1612 return begin + 1;
1613 case '{': handler.on_text(begin, begin + 1); return begin + 1;
1614 case ':': arg_id = handler.on_arg_id(); break;
1615 default: {
1616 struct id_adapter {
1617 Handler& handler;
1618 int arg_id;
1619
1620 FMT_CONSTEXPR void on_index(int id) { arg_id = handler.on_arg_id(id); }
1621 FMT_CONSTEXPR void on_name(basic_string_view<Char> id) {
1622 arg_id = handler.on_arg_id(id);
1623 }
1624 } adapter = {handler, 0};
1625 begin = parse_arg_id(begin, end, adapter);
1626 arg_id = adapter.arg_id;
1627 Char c = begin != end ? *begin : Char();
1628 if (c == '}') {
1629 handler.on_replacement_field(arg_id, begin);
1630 return begin + 1;
1631 }
1632 if (c != ':') {
1633 handler.on_error("missing '}' in format string");
1634 return end;
1635 }
1636 break;
1637 }
1638 }
1639 begin = handler.on_format_specs(arg_id, begin + 1, end);
1640 if (begin == end || *begin != '}')
1641 return handler.on_error("unknown format specifier"), end;
1642 return begin + 1;
1643}
1644
1645template <typename Char, typename Handler>
1647 Handler&& handler) {
1648 auto begin = fmt.data(), end = begin + fmt.size();
1649 auto p = begin;
1650 while (p != end) {
1651 auto c = *p++;
1652 if (c == '{') {
1653 handler.on_text(begin, p - 1);
1654 begin = p = parse_replacement_field(p - 1, end, handler);
1655 } else if (c == '}') {
1656 if (p == end || *p != '}')
1657 return handler.on_error("unmatched '}' in format string");
1658 handler.on_text(begin, p);
1659 begin = ++p;
1660 }
1661 }
1662 handler.on_text(begin, end);
1663}
1664
1665// Checks char specs and returns true iff the presentation type is char-like.
1666FMT_CONSTEXPR inline auto check_char_specs(const format_specs& specs) -> bool {
1667 auto type = specs.type();
1670 return false;
1671 }
1672 if (specs.align() == align::numeric || specs.sign() != sign::none ||
1673 specs.alt()) {
1674 report_error("invalid format specifier for char");
1675 }
1676 return true;
1677}
1678
1679// A base class for compile-time strings.
1681
1682template <typename T, typename Char>
1683FMT_VISIBILITY("hidden") // Suppress an ld warning on macOS (#3769).
1684FMT_CONSTEXPR auto invoke_parse(parse_context<Char>& ctx) -> const Char* {
1685 using mapped_type = remove_cvref_t<mapped_t<T, Char>>;
1686 constexpr bool formattable =
1687 std::is_constructible<formatter<mapped_type, Char>>::value;
1688 if (!formattable) return ctx.begin(); // Error is reported in the value ctor.
1689 using formatted_type = conditional_t<formattable, mapped_type, int>;
1690 return formatter<formatted_type, Char>().parse(ctx);
1691}
1692
1693template <typename... T> struct arg_pack {};
1694
1695template <typename Char, int NUM_ARGS, int NUM_NAMED_ARGS, bool DYNAMIC_NAMES>
1697 private:
1698 type types_[max_of<size_t>(1, NUM_ARGS)];
1699 named_arg_info<Char> named_args_[max_of<size_t>(1, NUM_NAMED_ARGS)];
1701
1702 using parse_func = auto (*)(parse_context<Char>&) -> const Char*;
1703 parse_func parse_funcs_[max_of<size_t>(1, NUM_ARGS)];
1704
1705 public:
1706 template <typename... T>
1709 : types_{mapped_type_constant<T, Char>::value...},
1710 named_args_{},
1711 context_(fmt, NUM_ARGS, types_),
1712 parse_funcs_{&invoke_parse<T, Char>...} {
1713 int arg_index = 0, named_arg_index = 0;
1715 init_static_named_arg<T>(named_args_, arg_index, named_arg_index));
1716 ignore_unused(arg_index, named_arg_index);
1717 }
1718
1719 FMT_CONSTEXPR void on_text(const Char*, const Char*) {}
1720
1721 FMT_CONSTEXPR auto on_arg_id() -> int { return context_.next_arg_id(); }
1722 FMT_CONSTEXPR auto on_arg_id(int id) -> int {
1723 context_.check_arg_id(id);
1724 return id;
1725 }
1727 for (int i = 0; i < NUM_NAMED_ARGS; ++i) {
1728 if (named_args_[i].name == id) return named_args_[i].id;
1729 }
1730 if (!DYNAMIC_NAMES) on_error("argument not found");
1731 return -1;
1732 }
1733
1734 FMT_CONSTEXPR void on_replacement_field(int id, const Char* begin) {
1735 on_format_specs(id, begin, begin); // Call parse() on empty specs.
1736 }
1737
1738 FMT_CONSTEXPR auto on_format_specs(int id, const Char* begin, const Char* end)
1739 -> const Char* {
1740 context_.advance_to(begin);
1741 if (id >= 0 && id < NUM_ARGS) return parse_funcs_[id](context_);
1742
1743 // If id is out of range, it means we do not know the type and cannot parse
1744 // the format at compile time. Instead, skip over content until we finish
1745 // the format spec, accounting for any nested replacements.
1746 for (int bracket_count = 0;
1747 begin != end && (bracket_count > 0 || *begin != '}'); ++begin) {
1748 if (*begin == '{')
1749 ++bracket_count;
1750 else if (*begin == '}')
1751 --bracket_count;
1752 }
1753 return begin;
1754 }
1755
1756 FMT_NORETURN FMT_CONSTEXPR void on_error(const char* message) {
1757 report_error(message);
1758 }
1759};
1760
1761/// A contiguous memory buffer with an optional growing ability. It is an
1762/// internal class and shouldn't be used directly, only via `memory_buffer`.
1763template <typename T> class buffer {
1764 private:
1765 T* ptr_;
1766 size_t size_;
1767 size_t capacity_;
1768
1769 using grow_fun = void (*)(buffer& buf, size_t capacity);
1770 grow_fun grow_;
1771
1772 protected:
1773 // Don't initialize ptr_ since it is not accessed to save a few cycles.
1774 FMT_MSC_WARNING(suppress : 26495)
1775 FMT_CONSTEXPR buffer(grow_fun grow, size_t sz) noexcept
1776 : size_(sz), capacity_(sz), grow_(grow) {}
1777
1778 constexpr buffer(grow_fun grow, T* p = nullptr, size_t sz = 0,
1779 size_t cap = 0) noexcept
1780 : ptr_(p), size_(sz), capacity_(cap), grow_(grow) {}
1781
1783 buffer(buffer&&) = default;
1784
1785 /// Sets the buffer data and capacity.
1786 FMT_CONSTEXPR void set(T* buf_data, size_t buf_capacity) noexcept {
1787 ptr_ = buf_data;
1788 capacity_ = buf_capacity;
1789 }
1790
1791 public:
1792 using value_type = T;
1793 using const_reference = const T&;
1794
1795 buffer(const buffer&) = delete;
1796 void operator=(const buffer&) = delete;
1797
1798 auto begin() noexcept -> T* { return ptr_; }
1799 auto end() noexcept -> T* { return ptr_ + size_; }
1800
1801 auto begin() const noexcept -> const T* { return ptr_; }
1802 auto end() const noexcept -> const T* { return ptr_ + size_; }
1803
1804 /// Returns the size of this buffer.
1805 constexpr auto size() const noexcept -> size_t { return size_; }
1806
1807 /// Returns the capacity of this buffer.
1808 constexpr auto capacity() const noexcept -> size_t { return capacity_; }
1809
1810 /// Returns a pointer to the buffer data (not null-terminated).
1811 FMT_CONSTEXPR auto data() noexcept -> T* { return ptr_; }
1812 FMT_CONSTEXPR auto data() const noexcept -> const T* { return ptr_; }
1813
1814 /// Clears this buffer.
1815 FMT_CONSTEXPR void clear() { size_ = 0; }
1816
1817 // Tries resizing the buffer to contain `count` elements. If T is a POD type
1818 // the new elements may not be initialized.
1821 size_ = min_of(count, capacity_);
1822 }
1823
1824 // Tries increasing the buffer capacity to `new_capacity`. It can increase the
1825 // capacity by a smaller amount than requested but guarantees there is space
1826 // for at least one additional element either by increasing the capacity or by
1827 // flushing the buffer if it is full.
1828 FMT_CONSTEXPR void try_reserve(size_t new_capacity) {
1829 if (new_capacity > capacity_) grow_(*this, new_capacity);
1830 }
1831
1833 try_reserve(size_ + 1);
1834 ptr_[size_++] = value;
1835 }
1836
1837 /// Appends data to the end of the buffer.
1838 template <typename U>
1839// Workaround for MSVC2019 to fix error C2893: Failed to specialize function
1840// template 'void fmt::v11::detail::buffer<T>::append(const U *,const U *)'.
1841#if !FMT_MSC_VERSION || FMT_MSC_VERSION >= 1940
1843#endif
1844 void
1845 append(const U* begin, const U* end) {
1846 while (begin != end) {
1847 auto count = to_unsigned(end - begin);
1848 try_reserve(size_ + count);
1849 auto free_cap = capacity_ - size_;
1850 if (free_cap < count) count = free_cap;
1851 // A loop is faster than memcpy on small sizes.
1852 T* out = ptr_ + size_;
1853 for (size_t i = 0; i < count; ++i) out[i] = begin[i];
1854 size_ += count;
1855 begin += count;
1856 }
1857 }
1858
1859 template <typename Idx> FMT_CONSTEXPR auto operator[](Idx index) -> T& {
1860 return ptr_[index];
1861 }
1862 template <typename Idx>
1863 FMT_CONSTEXPR auto operator[](Idx index) const -> const T& {
1864 return ptr_[index];
1865 }
1866};
1867
1869 constexpr explicit buffer_traits(size_t) {}
1870 constexpr auto count() const -> size_t { return 0; }
1871 constexpr auto limit(size_t size) const -> size_t { return size; }
1872};
1873
1875 private:
1876 size_t count_ = 0;
1877 size_t limit_;
1878
1879 public:
1880 constexpr explicit fixed_buffer_traits(size_t limit) : limit_(limit) {}
1881 constexpr auto count() const -> size_t { return count_; }
1882 FMT_CONSTEXPR auto limit(size_t size) -> size_t {
1883 size_t n = limit_ > count_ ? limit_ - count_ : 0;
1884 count_ += size;
1885 return min_of(size, n);
1886 }
1887};
1888
1889// A buffer that writes to an output iterator when flushed.
1890template <typename OutputIt, typename T, typename Traits = buffer_traits>
1891class iterator_buffer : public Traits, public buffer<T> {
1892 private:
1893 OutputIt out_;
1894 enum { buffer_size = 256 };
1895 T data_[buffer_size];
1896
1897 static FMT_CONSTEXPR void grow(buffer<T>& buf, size_t) {
1898 if (buf.size() == buffer_size) static_cast<iterator_buffer&>(buf).flush();
1899 }
1900
1901 void flush() {
1902 auto size = this->size();
1903 this->clear();
1904 const T* begin = data_;
1905 const T* end = begin + this->limit(size);
1906 while (begin != end) *out_++ = *begin++;
1907 }
1908
1909 public:
1910 explicit iterator_buffer(OutputIt out, size_t n = buffer_size)
1911 : Traits(n), buffer<T>(grow, data_, 0, buffer_size), out_(out) {}
1913 : Traits(other),
1914 buffer<T>(grow, data_, 0, buffer_size),
1915 out_(other.out_) {}
1917 // Don't crash if flush fails during unwinding.
1918 FMT_TRY { flush(); }
1919 FMT_CATCH(...) {}
1920 }
1921
1922 auto out() -> OutputIt {
1923 flush();
1924 return out_;
1925 }
1926 auto count() const -> size_t { return Traits::count() + this->size(); }
1927};
1928
1929template <typename T>
1931 public buffer<T> {
1932 private:
1933 T* out_;
1934 enum { buffer_size = 256 };
1935 T data_[buffer_size];
1936
1937 static FMT_CONSTEXPR void grow(buffer<T>& buf, size_t) {
1938 if (buf.size() == buf.capacity())
1939 static_cast<iterator_buffer&>(buf).flush();
1940 }
1941
1942 void flush() {
1943 size_t n = this->limit(this->size());
1944 if (this->data() == out_) {
1945 out_ += n;
1946 this->set(data_, buffer_size);
1947 }
1948 this->clear();
1949 }
1950
1951 public:
1952 explicit iterator_buffer(T* out, size_t n = buffer_size)
1953 : fixed_buffer_traits(n), buffer<T>(grow, out, 0, n), out_(out) {}
1955 : fixed_buffer_traits(other),
1956 buffer<T>(static_cast<iterator_buffer&&>(other)),
1957 out_(other.out_) {
1958 if (this->data() != out_) {
1959 this->set(data_, buffer_size);
1960 this->clear();
1961 }
1962 }
1963 ~iterator_buffer() { flush(); }
1964
1965 auto out() -> T* {
1966 flush();
1967 return out_;
1968 }
1969 auto count() const -> size_t {
1970 return fixed_buffer_traits::count() + this->size();
1971 }
1972};
1973
1974template <typename T> class iterator_buffer<T*, T> : public buffer<T> {
1975 public:
1976 explicit iterator_buffer(T* out, size_t = 0)
1977 : buffer<T>([](buffer<T>&, size_t) {}, out, 0, ~size_t()) {}
1978
1979 auto out() -> T* { return &*this->end(); }
1980};
1981
1982template <typename Container>
1983class container_buffer : public buffer<typename Container::value_type> {
1984 private:
1985 using value_type = typename Container::value_type;
1986
1987 static FMT_CONSTEXPR void grow(buffer<value_type>& buf, size_t capacity) {
1988 auto& self = static_cast<container_buffer&>(buf);
1989 self.container.resize(capacity);
1990 self.set(&self.container[0], capacity);
1991 }
1992
1993 public:
1994 Container& container;
1995
1996 explicit container_buffer(Container& c)
1997 : buffer<value_type>(grow, c.size()), container(c) {}
1998};
1999
2000// A buffer that writes to a container with the contiguous storage.
2001template <typename OutputIt>
2003 OutputIt,
2005 is_contiguous<typename OutputIt::container_type>::value,
2006 typename OutputIt::container_type::value_type>>
2007 : public container_buffer<typename OutputIt::container_type> {
2008 private:
2010
2011 public:
2012 explicit iterator_buffer(typename OutputIt::container_type& c) : base(c) {}
2013 explicit iterator_buffer(OutputIt out, size_t = 0)
2014 : base(get_container(out)) {}
2015
2016 auto out() -> OutputIt { return OutputIt(this->container); }
2017};
2018
2019// A buffer that counts the number of code units written discarding the output.
2020template <typename T = char> class counting_buffer : public buffer<T> {
2021 private:
2022 enum { buffer_size = 256 };
2023 T data_[buffer_size];
2024 size_t count_ = 0;
2025
2026 static FMT_CONSTEXPR void grow(buffer<T>& buf, size_t) {
2027 if (buf.size() != buffer_size) return;
2028 static_cast<counting_buffer&>(buf).count_ += buf.size();
2029 buf.clear();
2030 }
2031
2032 public:
2033 FMT_CONSTEXPR counting_buffer() : buffer<T>(grow, data_, 0, buffer_size) {}
2034
2035 constexpr auto count() const noexcept -> size_t {
2036 return count_ + this->size();
2037 }
2038};
2039
2040template <typename T>
2041struct is_back_insert_iterator<basic_appender<T>> : std::true_type {};
2042
2043template <typename OutputIt, typename InputIt, typename = void>
2045template <typename OutputIt, typename InputIt>
2047 OutputIt, InputIt,
2048 void_t<decltype(get_container(std::declval<OutputIt>())
2049 .append(std::declval<InputIt>(),
2050 std::declval<InputIt>()))>> : std::true_type {};
2051
2052template <typename OutputIt, typename InputIt, typename = void>
2054
2055template <typename OutputIt, typename InputIt>
2057 OutputIt, InputIt,
2058 void_t<decltype(get_container(std::declval<OutputIt>())
2059 .insert(get_container(std::declval<OutputIt>()).end(),
2060 std::declval<InputIt>(),
2061 std::declval<InputIt>()))>> : std::true_type {};
2062
2063// An optimized version of std::copy with the output value type (T).
2064template <typename T, typename InputIt, typename OutputIt,
2067 OutputIt, InputIt>::value)>
2068FMT_CONSTEXPR20 auto copy(InputIt begin, InputIt end, OutputIt out)
2069 -> OutputIt {
2070 get_container(out).append(begin, end);
2071 return out;
2072}
2073
2074template <typename T, typename InputIt, typename OutputIt,
2075 FMT_ENABLE_IF(is_back_insert_iterator<OutputIt>::value &&
2076 !has_back_insert_iterator_container_append<
2077 OutputIt, InputIt>::value &&
2078 has_back_insert_iterator_container_insert_at_end<
2079 OutputIt, InputIt>::value)>
2080FMT_CONSTEXPR20 auto copy(InputIt begin, InputIt end, OutputIt out)
2081 -> OutputIt {
2082 auto& c = get_container(out);
2083 c.insert(c.end(), begin, end);
2084 return out;
2085}
2086
2087template <typename T, typename InputIt, typename OutputIt,
2088 FMT_ENABLE_IF(!(is_back_insert_iterator<OutputIt>::value &&
2089 (has_back_insert_iterator_container_append<
2090 OutputIt, InputIt>::value ||
2091 has_back_insert_iterator_container_insert_at_end<
2092 OutputIt, InputIt>::value)))>
2093FMT_CONSTEXPR auto copy(InputIt begin, InputIt end, OutputIt out) -> OutputIt {
2094 while (begin != end) *out++ = static_cast<T>(*begin++);
2095 return out;
2096}
2097
2098template <typename T, typename V, typename OutputIt>
2099FMT_CONSTEXPR auto copy(basic_string_view<V> s, OutputIt out) -> OutputIt {
2100 return copy<T>(s.begin(), s.end(), out);
2101}
2102
2103template <typename It, typename Enable = std::true_type>
2104struct is_buffer_appender : std::false_type {};
2105template <typename It>
2107 It, bool_constant<
2109 std::is_base_of<buffer<typename It::container_type::value_type>,
2110 typename It::container_type>::value>>
2111 : std::true_type {};
2112
2113// Maps an output iterator to a buffer.
2114template <typename T, typename OutputIt,
2117 return iterator_buffer<OutputIt, T>(out);
2118}
2119template <typename T, typename OutputIt,
2120 FMT_ENABLE_IF(is_buffer_appender<OutputIt>::value)>
2121auto get_buffer(OutputIt out) -> buffer<T>& {
2122 return get_container(out);
2123}
2124
2125template <typename Buf, typename OutputIt>
2126auto get_iterator(Buf& buf, OutputIt) -> decltype(buf.out()) {
2127 return buf.out();
2128}
2129template <typename T, typename OutputIt>
2130auto get_iterator(buffer<T>&, OutputIt out) -> OutputIt {
2131 return out;
2132}
2133
2134// This type is intentionally undefined, only used for errors.
2135template <typename T, typename Char> struct type_is_unformattable_for;
2136
2137template <typename Char> struct string_value {
2138 const Char* data;
2139 size_t size;
2140 auto str() const -> basic_string_view<Char> { return {data, size}; }
2141};
2142
2143template <typename Context> struct custom_value {
2144 using char_type = typename Context::char_type;
2145 void* value;
2146 void (*format)(void* arg, parse_context<char_type>& parse_ctx, Context& ctx);
2147};
2148
2149template <typename Char> struct named_arg_value {
2151 size_t size;
2152};
2153
2154struct custom_tag {};
2155
2156#if !FMT_BUILTIN_TYPES
2157# define FMT_BUILTIN , monostate
2158#else
2159# define FMT_BUILTIN
2160#endif
2161
2162// A formatting argument value.
2163template <typename Context> class value {
2164 public:
2165 using char_type = typename Context::char_type;
2166
2167 union {
2170 unsigned uint_value;
2172 unsigned long long ulong_long_value;
2180 const void* pointer;
2184 };
2185
2186 constexpr FMT_INLINE value() : no_value() {}
2187 constexpr FMT_INLINE value(signed char x) : int_value(x) {}
2188 constexpr FMT_INLINE value(unsigned char x FMT_BUILTIN) : uint_value(x) {}
2189 constexpr FMT_INLINE value(signed short x) : int_value(x) {}
2190 constexpr FMT_INLINE value(unsigned short x FMT_BUILTIN) : uint_value(x) {}
2191 constexpr FMT_INLINE value(int x) : int_value(x) {}
2192 constexpr FMT_INLINE value(unsigned x FMT_BUILTIN) : uint_value(x) {}
2196 constexpr FMT_INLINE value(long long x FMT_BUILTIN) : long_long_value(x) {}
2197 constexpr FMT_INLINE value(unsigned long long x FMT_BUILTIN)
2198 : ulong_long_value(x) {}
2201 constexpr FMT_INLINE value(bool x FMT_BUILTIN) : bool_value(x) {}
2202
2203 template <int N>
2205 static_assert(N <= 64, "unsupported _BitInt");
2206 }
2207 template <int N>
2209 static_assert(N <= 64, "unsupported _BitInt");
2210 }
2211
2212 template <typename T, FMT_ENABLE_IF(is_code_unit<T>::value)>
2214 static_assert(
2215 std::is_same<T, char>::value || std::is_same<T, char_type>::value,
2216 "mixing character types is disallowed");
2217 }
2218
2219 constexpr FMT_INLINE value(float x FMT_BUILTIN) : float_value(x) {}
2220 constexpr FMT_INLINE value(double x FMT_BUILTIN) : double_value(x) {}
2222
2224 string.data = x;
2225 if (is_constant_evaluated()) string.size = 0;
2226 }
2228 string.data = x;
2229 if (is_constant_evaluated()) string.size = 0;
2230 }
2231 template <typename T, typename C = char_t<T>,
2232 FMT_ENABLE_IF(!std::is_pointer<T>::value)>
2234 static_assert(std::is_same<C, char_type>::value,
2235 "mixing character types is disallowed");
2236 auto sv = to_string_view(x);
2237 string.data = sv.data();
2238 string.size = sv.size();
2239 }
2241 FMT_INLINE value(const void* x FMT_BUILTIN) : pointer(x) {}
2242 FMT_INLINE value(volatile void* x FMT_BUILTIN)
2243 : pointer(const_cast<const void*>(x)) {}
2244 FMT_INLINE value(const volatile void* x FMT_BUILTIN)
2245 : pointer(const_cast<const void*>(x)) {}
2247
2248 template <typename T, FMT_ENABLE_IF(std::is_pointer<T>::value ||
2249 std::is_member_pointer<T>::value)>
2250 value(const T&) {
2251 // Formatting of arbitrary pointers is disallowed. If you want to format a
2252 // pointer cast it to `void*` or `const void*`. In particular, this forbids
2253 // formatting of `[const] volatile char*` printed as bool by iostreams.
2254 static_assert(sizeof(T) == 0,
2255 "formatting of non-void pointers is disallowed");
2256 }
2257
2258 template <typename T, FMT_ENABLE_IF(use_format_as<T>::value)>
2259 value(const T& x) : value(format_as(x)) {}
2260 template <typename T, FMT_ENABLE_IF(use_format_as_member<T>::value)>
2261 value(const T& x) : value(formatter<T>::format_as(x)) {}
2262
2263 template <typename T, FMT_ENABLE_IF(is_named_arg<T>::value)>
2265
2266 template <typename T,
2269
2271 : named_args{args, size} {}
2272
2273 private:
2274 template <typename T, FMT_ENABLE_IF(has_formatter<T, char_type>())>
2276 using value_type = remove_const_t<T>;
2277 // T may overload operator& e.g. std::vector<bool>::reference in libc++.
2278 if (!is_constant_evaluated()) {
2279 custom.value =
2280 const_cast<char*>(&reinterpret_cast<const volatile char&>(x));
2281 } else {
2282 custom.value = nullptr;
2283#if defined(__cpp_if_constexpr)
2284 if constexpr (std::is_same<decltype(&x), remove_reference_t<T>*>::value)
2285 custom.value = const_cast<value_type*>(&x);
2286#endif
2287 }
2288 custom.format = format_custom<value_type>;
2289 }
2290
2291 template <typename T, FMT_ENABLE_IF(!has_formatter<T, char_type>())>
2292 FMT_CONSTEXPR value(const T&, custom_tag) {
2293 // Cannot format an argument; to make type T formattable provide a
2294 // formatter<T> specialization: https://fmt.dev/latest/api.html#udt.
2295 type_is_unformattable_for<T, char_type> _;
2296 }
2297
2298 // Formats an argument of a custom type, such as a user-defined class.
2299 template <typename T>
2300 static void format_custom(void* arg, parse_context<char_type>& parse_ctx,
2301 Context& ctx) {
2302 auto f = formatter<T, char_type>();
2303 parse_ctx.advance_to(f.parse(parse_ctx));
2304 using qualified_type =
2306 // format must be const for compatibility with std::format and compilation.
2307 const auto& cf = f;
2308 ctx.advance_to(cf.format(*static_cast<qualified_type*>(arg), ctx));
2309 }
2310};
2311
2312enum { packed_arg_bits = 4 };
2313// Maximum number of arguments with packed types.
2315enum : unsigned long long { is_unpacked_bit = 1ULL << 63 };
2316enum : unsigned long long { has_named_args_bit = 1ULL << 62 };
2317
2318template <typename It, typename T, typename Enable = void>
2319struct is_output_iterator : std::false_type {};
2320
2321template <> struct is_output_iterator<appender, char> : std::true_type {};
2322
2323template <typename It, typename T>
2325 It, T,
2326 enable_if_t<std::is_assignable<decltype(*std::declval<decay_t<It>&>()++),
2327 T>::value>> : std::true_type {};
2328
2329template <typename> constexpr auto encode_types() -> unsigned long long {
2330 return 0;
2331}
2332
2333template <typename Context, typename First, typename... T>
2334constexpr auto encode_types() -> unsigned long long {
2335 return static_cast<unsigned>(stored_type_constant<First, Context>::value) |
2337}
2338
2339template <typename Context, typename... T, size_t NUM_ARGS = sizeof...(T)>
2340constexpr auto make_descriptor() -> unsigned long long {
2341 return NUM_ARGS <= max_packed_args ? encode_types<Context, T...>()
2342 : is_unpacked_bit | NUM_ARGS;
2343}
2344
2345template <typename Context, int NUM_ARGS>
2348
2349template <typename Context, int NUM_ARGS, int NUM_NAMED_ARGS,
2350 unsigned long long DESC>
2352 // args_[0].named_args points to named_args to avoid bloating format_args.
2355 named_args[static_cast<size_t>(NUM_NAMED_ARGS)];
2356
2357 template <typename... T>
2359 : args{{named_args, NUM_NAMED_ARGS}, values...} {
2360 int arg_index = 0, named_arg_index = 0;
2362 init_named_arg(named_args, arg_index, named_arg_index, values));
2363 }
2364
2366 args[0] = {named_args, NUM_NAMED_ARGS};
2367 for (size_t i = 1; i < sizeof(args) / sizeof(*args); ++i)
2368 args[i] = rhs.args[i];
2369 for (size_t i = 0; i < NUM_NAMED_ARGS; ++i)
2370 named_args[i] = rhs.named_args[i];
2371 }
2372
2373 named_arg_store(const named_arg_store& rhs) = delete;
2374 auto operator=(const named_arg_store& rhs) -> named_arg_store& = delete;
2376 operator const arg_t<Context, NUM_ARGS>*() const { return args + 1; }
2377};
2378
2379// An array of references to arguments. It can be implicitly converted to
2380// `basic_format_args` for passing into type-erased formatting functions
2381// such as `vformat`. It is a plain struct to reduce binary size in debug mode.
2382template <typename Context, int NUM_ARGS, int NUM_NAMED_ARGS,
2383 unsigned long long DESC>
2385 // +1 to workaround a bug in gcc 7.5 that causes duplicated-branches warning.
2386 using type =
2387 conditional_t<NUM_NAMED_ARGS == 0,
2391};
2392
2393// TYPE can be different from type_constant<T>, e.g. for __float128.
2394template <typename T, typename Char, type TYPE> struct native_formatter {
2395 private:
2397
2398 public:
2399 using nonlocking = void;
2400
2401 FMT_CONSTEXPR auto parse(parse_context<Char>& ctx) -> const Char* {
2402 if (ctx.begin() == ctx.end() || *ctx.begin() == '}') return ctx.begin();
2403 auto end = parse_format_specs(ctx.begin(), ctx.end(), specs_, ctx, TYPE);
2404 if (const_check(TYPE == type::char_type)) check_char_specs(specs_);
2405 return end;
2406 }
2407
2408 template <type U = TYPE,
2409 FMT_ENABLE_IF(U == type::string_type || U == type::cstring_type ||
2410 U == type::char_type)>
2414
2415 FMT_PRAGMA_CLANG(diagnostic ignored "-Wundefined-inline")
2416 template <typename FormatContext>
2417 FMT_CONSTEXPR auto format(const T& val, FormatContext& ctx) const
2418 -> decltype(ctx.out());
2419};
2420
2421template <typename T, typename Enable = void>
2423 : bool_constant<mapped_type_constant<T>::value == type::custom_type> {};
2424template <typename T>
2425struct locking<T, void_t<typename formatter<remove_cvref_t<T>>::nonlocking>>
2426 : std::false_type {};
2427
2428template <typename T = int> FMT_CONSTEXPR inline auto is_locking() -> bool {
2429 return locking<T>::value;
2430}
2431template <typename T1, typename T2, typename... Tail>
2432FMT_CONSTEXPR inline auto is_locking() -> bool {
2433 return locking<T1>::value || is_locking<T2, Tail...>();
2434}
2435
2436FMT_API void vformat_to(buffer<char>& buf, string_view fmt, format_args args,
2437 locale_ref loc = {});
2438
2439#if FMT_WIN32
2441#else // format_args is passed by reference since it is defined later.
2442inline void vprint_mojibake(FILE*, string_view, const format_args&, bool) {}
2443#endif
2444} // namespace detail
2445
2446// The main public API.
2447
2448template <typename Char>
2450 // Argument id is only checked at compile time during parsing because
2451 // formatting has its own validation.
2452 if (detail::is_constant_evaluated() && use_constexpr_cast) {
2453 auto ctx = static_cast<detail::compile_parse_context<Char>*>(this);
2454 if (arg_id >= ctx->num_args()) report_error("argument not found");
2455 }
2456}
2457
2458template <typename Char>
2461 if (detail::is_constant_evaluated() && use_constexpr_cast)
2462 static_cast<compile_parse_context<Char>*>(this)->check_dynamic_spec(arg_id);
2463}
2464
2466
2467// An output iterator that appends to a buffer. It is used instead of
2468// back_insert_iterator to reduce symbol sizes and avoid <iterator> dependency.
2469template <typename T> class basic_appender {
2470 protected:
2472
2473 public:
2475
2477
2479 container->push_back(c);
2480 return *this;
2481 }
2482 FMT_CONSTEXPR20 auto operator*() -> basic_appender& { return *this; }
2483 FMT_CONSTEXPR20 auto operator++() -> basic_appender& { return *this; }
2484 FMT_CONSTEXPR20 auto operator++(int) -> basic_appender { return *this; }
2485};
2486
2487// A formatting argument. Context is a template parameter for the compiled API
2488// where output can be unbuffered.
2489template <typename Context> class basic_format_arg {
2490 private:
2493
2494 friend class basic_format_args<Context>;
2495
2496 using char_type = typename Context::char_type;
2497
2498 public:
2499 class handle {
2500 private:
2502
2503 public:
2504 explicit handle(detail::custom_value<Context> custom) : custom_(custom) {}
2505
2506 void format(parse_context<char_type>& parse_ctx, Context& ctx) const {
2507 custom_.format(custom_.value, parse_ctx, ctx);
2508 }
2509 };
2510
2511 constexpr basic_format_arg() : type_(detail::type::none_type) {}
2513 : value_(args, size) {}
2514 template <typename T>
2516 : value_(val), type_(detail::stored_type_constant<T, Context>::value) {}
2517
2518 constexpr explicit operator bool() const noexcept {
2519 return type_ != detail::type::none_type;
2520 }
2521 auto type() const -> detail::type { return type_; }
2522
2523 /**
2524 * Visits an argument dispatching to the appropriate visit method based on
2525 * the argument type. For example, if the argument type is `double` then
2526 * `vis(value)` will be called with the value of type `double`.
2527 */
2528 template <typename Visitor>
2529 FMT_CONSTEXPR FMT_INLINE auto visit(Visitor&& vis) const -> decltype(vis(0)) {
2530 using detail::map;
2531 switch (type_) {
2532 case detail::type::none_type: break;
2533 case detail::type::int_type: return vis(value_.int_value);
2534 case detail::type::uint_type: return vis(value_.uint_value);
2535 case detail::type::long_long_type: return vis(value_.long_long_value);
2536 case detail::type::ulong_long_type: return vis(value_.ulong_long_value);
2537 case detail::type::int128_type: return vis(map(value_.int128_value));
2538 case detail::type::uint128_type: return vis(map(value_.uint128_value));
2539 case detail::type::bool_type: return vis(value_.bool_value);
2540 case detail::type::char_type: return vis(value_.char_value);
2541 case detail::type::float_type: return vis(value_.float_value);
2542 case detail::type::double_type: return vis(value_.double_value);
2543 case detail::type::long_double_type: return vis(value_.long_double_value);
2544 case detail::type::cstring_type: return vis(value_.string.data);
2545 case detail::type::string_type: return vis(value_.string.str());
2546 case detail::type::pointer_type: return vis(value_.pointer);
2547 case detail::type::custom_type: return vis(handle(value_.custom));
2548 }
2549 return vis(monostate());
2550 }
2551
2552 auto format_custom(const char_type* parse_begin,
2553 parse_context<char_type>& parse_ctx, Context& ctx)
2554 -> bool {
2555 if (type_ != detail::type::custom_type) return false;
2556 parse_ctx.advance_to(parse_begin);
2557 value_.custom.format(value_.custom.value, parse_ctx, ctx);
2558 return true;
2559 }
2560};
2561
2562/**
2563 * A view of a collection of formatting arguments. To avoid lifetime issues it
2564 * should only be used as a parameter type in type-erased functions such as
2565 * `vformat`:
2566 *
2567 * void vlog(fmt::string_view fmt, fmt::format_args args); // OK
2568 * fmt::format_args args = fmt::make_format_args(); // Dangling reference
2569 */
2570template <typename Context> class basic_format_args {
2571 private:
2572 // A descriptor that contains information about formatting arguments.
2573 // If the number of arguments is less or equal to max_packed_args then
2574 // argument types are passed in the descriptor. This reduces binary code size
2575 // per formatting function call.
2576 unsigned long long desc_;
2577 union {
2578 // If is_packed() returns true then argument values are stored in values_;
2579 // otherwise they are stored in args_. This is done to improve cache
2580 // locality and reduce compiled code size since storing larger objects
2581 // may require more code (at least on x86-64) even if the same amount of
2582 // data is actually copied to stack. It saves ~10% on the bloat test.
2585 };
2586
2587 constexpr auto is_packed() const -> bool {
2588 return (desc_ & detail::is_unpacked_bit) == 0;
2589 }
2590 constexpr auto has_named_args() const -> bool {
2591 return (desc_ & detail::has_named_args_bit) != 0;
2592 }
2593
2594 FMT_CONSTEXPR auto type(int index) const -> detail::type {
2595 int shift = index * detail::packed_arg_bits;
2596 unsigned mask = (1 << detail::packed_arg_bits) - 1;
2597 return static_cast<detail::type>((desc_ >> shift) & mask);
2598 }
2599
2600 template <int NUM_ARGS, int NUM_NAMED_ARGS, unsigned long long DESC>
2601 using store =
2603
2604 public:
2606
2607 constexpr basic_format_args() : desc_(0), args_(nullptr) {}
2608
2609 /// Constructs a `basic_format_args` object from `format_arg_store`.
2610 template <int NUM_ARGS, int NUM_NAMED_ARGS, unsigned long long DESC,
2614 : desc_(DESC | (NUM_NAMED_ARGS != 0 ? +detail::has_named_args_bit : 0)),
2615 values_(s.args) {}
2616
2617 template <int NUM_ARGS, int NUM_NAMED_ARGS, unsigned long long DESC,
2620 : desc_(DESC | (NUM_NAMED_ARGS != 0 ? +detail::has_named_args_bit : 0)),
2621 args_(s.args) {}
2622
2623 /// Constructs a `basic_format_args` object from a dynamic list of arguments.
2624 constexpr basic_format_args(const format_arg* args, int count,
2625 bool has_named = false)
2626 : desc_(detail::is_unpacked_bit | detail::to_unsigned(count) |
2627 (has_named ? +detail::has_named_args_bit : 0)),
2628 args_(args) {}
2629
2630 /// Returns the argument with the specified id.
2631 FMT_CONSTEXPR auto get(int id) const -> format_arg {
2632 auto arg = format_arg();
2633 if (!is_packed()) {
2634 if (id < max_size()) arg = args_[id];
2635 return arg;
2636 }
2637 if (static_cast<unsigned>(id) >= detail::max_packed_args) return arg;
2638 arg.type_ = type(id);
2639 if (arg.type_ != detail::type::none_type) arg.value_ = values_[id];
2640 return arg;
2641 }
2642
2643 template <typename Char>
2645 int id = get_id(name);
2646 return id >= 0 ? get(id) : format_arg();
2647 }
2648
2649 template <typename Char>
2651 if (!has_named_args()) return -1;
2652 const auto& named_args =
2653 (is_packed() ? values_[-1] : args_[-1].value_).named_args;
2654 for (size_t i = 0; i < named_args.size; ++i) {
2655 if (named_args.data[i].name == name) return named_args.data[i].id;
2656 }
2657 return -1;
2658 }
2659
2660 auto max_size() const -> int {
2661 unsigned long long max_packed = detail::max_packed_args;
2662 return static_cast<int>(is_packed() ? max_packed
2663 : desc_ & ~detail::is_unpacked_bit);
2664 }
2665};
2666
2667// A formatting context.
2668class context {
2669 private:
2670 appender out_;
2671 format_args args_;
2673
2674 public:
2675 using char_type = char; ///< The character type for the output.
2679
2680 /// Constructs a `context` object. References to the arguments are stored
2681 /// in the object so make sure they have appropriate lifetimes.
2683 : out_(out), args_(args), loc_(loc) {}
2684 context(context&&) = default;
2685 context(const context&) = delete;
2686 void operator=(const context&) = delete;
2687
2688 FMT_CONSTEXPR auto arg(int id) const -> format_arg { return args_.get(id); }
2689 inline auto arg(string_view name) const -> format_arg {
2690 return args_.get(name);
2691 }
2692 FMT_CONSTEXPR auto arg_id(string_view name) const -> int {
2693 return args_.get_id(name);
2694 }
2695 auto args() const -> const format_args& { return args_; }
2696
2697 // Returns an iterator to the beginning of the output range.
2698 FMT_CONSTEXPR auto out() const -> iterator { return out_; }
2699
2700 // Advances the begin iterator to `it`.
2702
2703 FMT_CONSTEXPR auto locale() const -> locale_ref { return loc_; }
2704};
2705
2706template <typename Char = char> struct runtime_format_string {
2708};
2709
2710/**
2711 * Creates a runtime format string.
2712 *
2713 * **Example**:
2714 *
2715 * // Check format string at runtime instead of compile-time.
2716 * fmt::print(fmt::runtime("{:d}"), "I am not a number");
2717 */
2718inline auto runtime(string_view s) -> runtime_format_string<> { return {{s}}; }
2719
2720/// A compile-time format string. Use `format_string` in the public API to
2721/// prevent type deduction.
2722template <typename... T> struct fstring {
2723 private:
2724 static constexpr int num_static_named_args =
2726
2728 char, static_cast<int>(sizeof...(T)), num_static_named_args,
2729 num_static_named_args != detail::count_named_args<T...>()>;
2730
2731 using arg_pack = detail::arg_pack<T...>;
2732
2733 public:
2735 using t = fstring;
2736
2737 // Reports a compile-time error if S is not a valid format string for T.
2738 template <size_t N>
2739 FMT_CONSTEVAL FMT_ALWAYS_INLINE fstring(const char (&s)[N]) : str(s, N - 1) {
2740 using namespace detail;
2741 static_assert(count<(is_view<remove_cvref_t<T>>::value &&
2742 std::is_reference<T>::value)...>() == 0,
2743 "passing views as lvalues is disallowed");
2744 if (FMT_USE_CONSTEVAL) parse_format_string<char>(s, checker(s, arg_pack()));
2745#ifdef FMT_ENFORCE_COMPILE_STRING
2746 static_assert(
2747 FMT_USE_CONSTEVAL && sizeof(s) != 0,
2748 "FMT_ENFORCE_COMPILE_STRING requires format strings to use FMT_STRING");
2749#endif
2750 }
2751 template <typename S,
2752 FMT_ENABLE_IF(std::is_convertible<const S&, string_view>::value)>
2754 auto sv = string_view(str);
2757#ifdef FMT_ENFORCE_COMPILE_STRING
2758 static_assert(
2759 FMT_USE_CONSTEVAL && sizeof(s) != 0,
2760 "FMT_ENFORCE_COMPILE_STRING requires format strings to use FMT_STRING");
2761#endif
2762 }
2763 template <typename S,
2764 FMT_ENABLE_IF(std::is_base_of<detail::compile_string, S>::value&&
2765 std::is_same<typename S::char_type, char>::value)>
2767 FMT_CONSTEXPR auto sv = string_view(S());
2768 FMT_CONSTEXPR int unused =
2769 (parse_format_string(sv, checker(sv, arg_pack())), 0);
2770 detail::ignore_unused(unused);
2771 }
2773
2774 // Returning by reference generates better code in debug mode.
2775 FMT_ALWAYS_INLINE operator const string_view&() const { return str; }
2776 auto get() const -> string_view { return str; }
2777};
2778
2779template <typename... T> using format_string = typename fstring<T...>::t;
2780
2781template <typename T, typename Char = char>
2782using is_formattable = bool_constant<!std::is_same<
2784 void>::value>;
2785#ifdef __cpp_concepts
2786template <typename T, typename Char = char>
2787concept formattable = is_formattable<remove_reference_t<T>, Char>::value;
2788#endif
2789
2790// A formatter specialization for natively supported types.
2791template <typename T, typename Char>
2792struct formatter<T, Char,
2793 enable_if_t<detail::type_constant<T, Char>::value !=
2795 : detail::native_formatter<T, Char, detail::type_constant<T, Char>::value> {
2796};
2797
2798/**
2799 * Constructs an object that stores references to arguments and can be
2800 * implicitly converted to `format_args`. `Context` can be omitted in which case
2801 * it defaults to `context`. See `arg` for lifetime considerations.
2802 */
2803// Take arguments by lvalue references to avoid some lifetime issues, e.g.
2804// auto args = make_format_args(std::string());
2805template <typename Context = context, typename... T,
2806 int NUM_ARGS = sizeof...(T),
2807 int NUM_NAMED_ARGS = detail::count_named_args<T...>(),
2808 unsigned long long DESC = detail::make_descriptor<Context, T...>()>
2809constexpr FMT_ALWAYS_INLINE auto make_format_args(T&... args)
2811 // Suppress warnings for pathological types convertible to detail::value.
2812 FMT_PRAGMA_GCC(diagnostic ignored "-Wconversion")
2813 return {{args...}};
2814}
2815
2816template <typename... T>
2817using vargs =
2818 detail::format_arg_store<context, sizeof...(T),
2821
2822/**
2823 * Returns a named argument to be used in a formatting function.
2824 * It should only be used in a call to a formatting function.
2825 *
2826 * **Example**:
2827 *
2828 * fmt::print("The answer is {answer}.", fmt::arg("answer", 42));
2829 */
2830template <typename Char, typename T>
2831inline auto arg(const Char* name, const T& arg) -> detail::named_arg<Char, T> {
2832 return {name, arg};
2833}
2834
2835/// Formats a string and writes the output to `out`.
2836template <typename OutputIt,
2838 char>::value)>
2839auto vformat_to(OutputIt&& out, string_view fmt, format_args args)
2841 auto&& buf = detail::get_buffer<char>(out);
2842 detail::vformat_to(buf, fmt, args, {});
2843 return detail::get_iterator(buf, out);
2844}
2845
2846/**
2847 * Formats `args` according to specifications in `fmt`, writes the result to
2848 * the output iterator `out` and returns the iterator past the end of the output
2849 * range. `format_to` does not append a terminating null character.
2850 *
2851 * **Example**:
2852 *
2853 * auto out = std::vector<char>();
2854 * fmt::format_to(std::back_inserter(out), "{}", 42);
2855 */
2856template <typename OutputIt, typename... T,
2858 char>::value)>
2859FMT_INLINE auto format_to(OutputIt&& out, format_string<T...> fmt, T&&... args)
2861 return vformat_to(out, fmt.str, vargs<T...>{{args...}});
2862}
2863
2864template <typename OutputIt> struct format_to_n_result {
2865 /// Iterator past the end of the output range.
2866 OutputIt out;
2867 /// Total (not truncated) output size.
2868 size_t size;
2869};
2870
2871template <typename OutputIt, typename... T,
2873auto vformat_to_n(OutputIt out, size_t n, string_view fmt, format_args args)
2875 using traits = detail::fixed_buffer_traits;
2877 detail::vformat_to(buf, fmt, args, {});
2878 return {buf.out(), buf.count()};
2879}
2880
2881/**
2882 * Formats `args` according to specifications in `fmt`, writes up to `n`
2883 * characters of the result to the output iterator `out` and returns the total
2884 * (not truncated) output size and the iterator past the end of the output
2885 * range. `format_to_n` does not append a terminating null character.
2886 */
2887template <typename OutputIt, typename... T,
2889FMT_INLINE auto format_to_n(OutputIt out, size_t n, format_string<T...> fmt,
2890 T&&... args) -> format_to_n_result<OutputIt> {
2891 return vformat_to_n(out, n, fmt.str, vargs<T...>{{args...}});
2892}
2893
2895 /// Pointer to just after the last successful write in the array.
2896 char* out;
2897 /// Specifies if the output was truncated.
2899
2900 FMT_CONSTEXPR operator char*() const {
2901 // Report truncation to prevent silent data loss.
2902 if (truncated) report_error("output is truncated");
2903 return out;
2904 }
2905};
2906
2907template <size_t N>
2908auto vformat_to(char (&out)[N], string_view fmt, format_args args)
2909 -> format_to_result {
2910 auto result = vformat_to_n(out, N, fmt, args);
2911 return {result.out, result.size > N};
2912}
2913
2914template <size_t N, typename... T>
2915FMT_INLINE auto format_to(char (&out)[N], format_string<T...> fmt, T&&... args)
2916 -> format_to_result {
2917 auto result = vformat_to_n(out, N, fmt.str, vargs<T...>{{args...}});
2918 return {result.out, result.size > N};
2919}
2920
2921/// Returns the number of chars in the output of `format(fmt, args...)`.
2922template <typename... T>
2924 T&&... args) -> size_t {
2925 auto buf = detail::counting_buffer<>();
2926 detail::vformat_to(buf, fmt.str, vargs<T...>{{args...}}, {});
2927 return buf.count();
2928}
2929
2930FMT_API void vprint(string_view fmt, format_args args);
2931FMT_API void vprint(FILE* f, string_view fmt, format_args args);
2932FMT_API void vprintln(FILE* f, string_view fmt, format_args args);
2934
2935/**
2936 * Formats `args` according to specifications in `fmt` and writes the output
2937 * to `stdout`.
2938 *
2939 * **Example**:
2940 *
2941 * fmt::print("The answer is {}.", 42);
2942 */
2943template <typename... T>
2944FMT_INLINE void print(format_string<T...> fmt, T&&... args) {
2945 vargs<T...> va = {{args...}};
2947 return detail::vprint_mojibake(stdout, fmt.str, va, false);
2948 return detail::is_locking<T...>() ? vprint_buffered(stdout, fmt.str, va)
2949 : vprint(fmt.str, va);
2950}
2951
2952/**
2953 * Formats `args` according to specifications in `fmt` and writes the
2954 * output to the file `f`.
2955 *
2956 * **Example**:
2957 *
2958 * fmt::print(stderr, "Don't {}!", "panic");
2959 */
2960template <typename... T>
2961FMT_INLINE void print(FILE* f, format_string<T...> fmt, T&&... args) {
2962 vargs<T...> va = {{args...}};
2964 return detail::vprint_mojibake(f, fmt.str, va, false);
2965 return detail::is_locking<T...>() ? vprint_buffered(f, fmt.str, va)
2966 : vprint(f, fmt.str, va);
2967}
2968
2969/// Formats `args` according to specifications in `fmt` and writes the output
2970/// to the file `f` followed by a newline.
2971template <typename... T>
2972FMT_INLINE void println(FILE* f, format_string<T...> fmt, T&&... args) {
2973 vargs<T...> va = {{args...}};
2975 ? vprintln(f, fmt.str, va)
2976 : detail::vprint_mojibake(f, fmt.str, va, true);
2977}
2978
2979/// Formats `args` according to specifications in `fmt` and writes the output
2980/// to `stdout` followed by a newline.
2981template <typename... T>
2983 return fmt::println(stdout, fmt, static_cast<T&&>(args)...);
2984}
2985
2986FMT_PRAGMA_CLANG(diagnostic pop)
2987FMT_PRAGMA_GCC(pop_options)
2990
2991#ifdef FMT_HEADER_ONLY
2992# include "format.h"
2993#endif
2994#endif // FMT_BASE_H_
constexpr auto format_as(HAL_AddressableLEDColorOrder order)
Definition AddressableLEDTypes.h:33
typename std::enable_if< B, T >::type enable_if_t
Definition base.h:304
#define FMT_ASSERT(condition, message)
Definition base.h:391
#define FMT_END_EXPORT
Definition base.h:264
std::integral_constant< bool, B > bool_constant
Definition base.h:307
FMT_NODISCARD FMT_INLINE auto formatted_size(format_string< T... > fmt, T &&... args) -> size_t
Returns the number of chars in the output of format(fmt, args...).
Definition base.h:2923
#define FMT_BUILTIN_TYPES
Definition base.h:293
#define FMT_PRAGMA_CLANG(x)
Definition base.h:222
#define FMT_CONSTEVAL
Definition base.h:140
#define FMT_TYPE_CONSTANT(Type, constant)
Definition base.h:1002
basic_string_view< char > string_view
Definition base.h:613
#define FMT_UNICODE
Definition base.h:455
auto arg(const Char *name, const T &arg) -> detail::named_arg< Char, T >
Returns a named argument to be used in a formatting function.
Definition base.h:2831
constexpr auto min_of(T a, T b) -> T
Definition base.h:344
typename std::remove_const< T >::type remove_const_t
Definition base.h:311
FMT_API void vprintln(FILE *f, string_view fmt, format_args args)
#define FMT_FALLTHROUGH
Definition base.h:186
auto vformat_to(OutputIt &&out, string_view fmt, format_args args) -> remove_cvref_t< OutputIt >
Formats a string and writes the output to out.
Definition base.h:2839
#define FMT_NODISCARD
Definition base.h:201
typename std::remove_reference< T >::type remove_reference_t
Definition base.h:309
#define FMT_WIN32
Definition base.h:270
FMT_API void vprint(string_view fmt, format_args args)
Definition format-inl.h:1756
auto vformat_to_n(OutputIt out, size_t n, string_view fmt, format_args args) -> format_to_n_result< OutputIt >
Definition base.h:2873
FMT_INLINE auto format_to(OutputIt &&out, format_string< T... > fmt, T &&... args) -> remove_cvref_t< OutputIt >
Formats args according to specifications in fmt, writes the result to the output iterator out and ret...
Definition base.h:2859
typename fstring< T... >::t format_string
Definition base.h:2779
#define FMT_TRY
Definition base.h:160
#define FMT_VISIBILITY(value)
Definition base.h:207
#define FMT_GCC_VERSION
Definition base.h:35
typename std::make_unsigned< T >::type make_unsigned_t
Definition base.h:315
#define FMT_PRAGMA_GCC(x)
Definition base.h:217
#define FMT_OPTIMIZE_SIZE
Definition base.h:287
FMT_INLINE void print(format_string< T... > fmt, T &&... args)
Formats args according to specifications in fmt and writes the output to stdout.
Definition base.h:2944
basic_appender< char > appender
Definition base.h:616
typename std::remove_cv< remove_reference_t< T > >::type remove_cvref_t
Definition base.h:313
constexpr auto max_of(T a, T b) -> T
Definition base.h:347
#define FMT_CONSTEXPR
Definition base.h:113
align
Definition base.h:681
#define FMT_ALWAYS_INLINE
Definition base.h:243
FMT_INLINE void println(FILE *f, format_string< T... > fmt, T &&... args)
Formats args according to specifications in fmt and writes the output to the file f followed by a new...
Definition base.h:2972
arg_id_kind
Definition base.h:683
FMT_NORETURN FMT_API void assert_fail(const char *file, int line, const char *message)
Definition format-inl.h:36
FMT_NORETURN FMT_API void report_error(const char *message)
Reports a format error at compile time or, via a format_error exception, at runtime.
Definition format-inl.h:143
#define FMT_BEGIN_NAMESPACE
Definition base.h:253
sign
Definition base.h:682
auto runtime(string_view s) -> runtime_format_string<>
Creates a runtime format string.
Definition base.h:2718
#define FMT_BUILTIN
Definition base.h:2157
conditional_t< std::is_same< OutputIt, appender >::value, context, generic_context< OutputIt, Char > > basic_format_context
Definition base.h:629
#define FMT_API
Definition base.h:283
#define FMT_USE_CONSTEVAL
Definition base.h:118
#define FMT_APPLY_VARIADIC(expr)
Definition base.h:296
#define FMT_ENABLE_IF(...)
Definition base.h:341
#define FMT_BEGIN_EXPORT
Definition base.h:263
FMT_INLINE auto format_to_n(OutputIt out, size_t n, format_string< T... > fmt, T &&... args) -> format_to_n_result< OutputIt >
Formats args according to specifications in fmt, writes up to n characters of the result to the outpu...
Definition base.h:2889
void void_t
Definition base.h:328
#define FMT_CATCH(x)
Definition base.h:161
#define FMT_INLINE
Definition base.h:247
typename std::decay< T >::type decay_t
Definition base.h:318
#define FMT_NO_UNIQUE_ADDRESS
Definition base.h:175
#define FMT_NORETURN
Definition base.h:193
#define FMT_MSC_WARNING(...)
Definition base.h:227
typename std::conditional< B, T, F >::type conditional_t
Definition base.h:306
#define FMT_CONSTEXPR20
Definition base.h:141
typename std::underlying_type< T >::type underlying_t
Definition base.h:317
presentation_type
Definition base.h:658
#define FMT_END_NAMESPACE
Definition base.h:256
FMT_API void vprint_buffered(FILE *f, string_view fmt, format_args args)
conditional_t< std::is_same< Char, char >::value, context, generic_context< basic_appender< Char >, Char > > buffered_context
Definition base.h:635
decltype(nullptr) nullptr_t
Definition base.h:319
bool_constant<!std::is_same< detail::mapped_t< conditional_t< std::is_void< T >::value, int *, T >, Char >, void >::value > is_formattable
Definition base.h:2782
constexpr FMT_ALWAYS_INLINE auto make_format_args(T &... args) -> detail::format_arg_store< Context, NUM_ARGS, NUM_NAMED_ARGS, DESC >
Constructs an object that stores references to arguments and can be implicitly converted to format_ar...
Definition base.h:2809
Definition base.h:2469
FMT_CONSTEXPR20 auto operator=(T c) -> basic_appender &
Definition base.h:2478
FMT_CONSTEXPR20 auto operator++(int) -> basic_appender
Definition base.h:2484
detail::buffer< T > * container
Definition base.h:2471
FMT_CONSTEXPR20 auto operator++() -> basic_appender &
Definition base.h:2483
FMT_CONSTEXPR20 auto operator*() -> basic_appender &
Definition base.h:2482
FMT_CONSTEXPR basic_appender(detail::buffer< T > &buf)
Definition base.h:2476
Definition base.h:2499
handle(detail::custom_value< Context > custom)
Definition base.h:2504
void format(parse_context< char_type > &parse_ctx, Context &ctx) const
Definition base.h:2506
Definition base.h:2489
constexpr basic_format_arg()
Definition base.h:2511
auto type() const -> detail::type
Definition base.h:2521
auto format_custom(const char_type *parse_begin, parse_context< char_type > &parse_ctx, Context &ctx) -> bool
Definition base.h:2552
basic_format_arg(const detail::named_arg_info< char_type > *args, size_t size)
Definition base.h:2512
basic_format_arg(T &&val)
Definition base.h:2515
FMT_CONSTEXPR FMT_INLINE auto visit(Visitor &&vis) const -> decltype(vis(0))
Visits an argument dispatching to the appropriate visit method based on the argument type.
Definition base.h:2529
A view of a collection of formatting arguments.
Definition base.h:2570
constexpr basic_format_args()
Definition base.h:2607
FMT_CONSTEXPR auto get(int id) const -> format_arg
Returns the argument with the specified id.
Definition base.h:2631
const detail::value< Context > * values_
Definition base.h:2583
FMT_CONSTEXPR auto get_id(basic_string_view< Char > name) const -> int
Definition base.h:2650
constexpr basic_format_args(const store< NUM_ARGS, NUM_NAMED_ARGS, DESC > &s)
Definition base.h:2619
auto max_size() const -> int
Definition base.h:2660
constexpr FMT_ALWAYS_INLINE basic_format_args(const store< NUM_ARGS, NUM_NAMED_ARGS, DESC > &s)
Constructs a basic_format_args object from format_arg_store.
Definition base.h:2612
const basic_format_arg< Context > * args_
Definition base.h:2584
constexpr basic_format_args(const format_arg *args, int count, bool has_named=false)
Constructs a basic_format_args object from a dynamic list of arguments.
Definition base.h:2624
auto get(basic_string_view< Char > name) const -> format_arg
Definition base.h:2644
basic_format_arg< Context > format_arg
Definition base.h:2605
Definition base.h:686
FMT_CONSTEXPR void copy_fill_from(const basic_specs &specs)
Definition base.h:831
FMT_CONSTEXPR void set_fill(char c)
Definition base.h:810
constexpr auto align() const -> align
Definition base.h:744
FMT_CONSTEXPR void set_dynamic_precision(arg_id_kind p)
Definition base.h:762
FMT_CONSTEXPR auto dynamic_precision() const -> arg_id_kind
Definition base.h:758
FMT_CONSTEXPR void set_fill(basic_string_view< Char > s)
Definition base.h:816
constexpr auto sign() const -> sign
Definition base.h:771
FMT_CONSTEXPR void set_alt()
Definition base.h:782
constexpr auto localized() const -> bool
Definition base.h:785
FMT_CONSTEXPR void set_sign(fmt::sign s)
Definition base.h:774
constexpr auto dynamic() const -> bool
Definition base.h:767
constexpr auto upper() const -> bool
Definition base.h:778
FMT_CONSTEXPR void clear_alt()
Definition base.h:783
constexpr auto type() const -> presentation_type
Definition base.h:737
constexpr auto fill() const -> const Char *
Definition base.h:795
FMT_CONSTEXPR void set_upper()
Definition base.h:779
constexpr auto alt() const -> bool
Definition base.h:781
constexpr auto dynamic_width() const -> arg_id_kind
Definition base.h:751
constexpr auto fill_unit() const -> Char
Definition base.h:803
FMT_CONSTEXPR void set_align(fmt::align a)
Definition base.h:747
FMT_CONSTEXPR void set_type(presentation_type t)
Definition base.h:740
FMT_CONSTEXPR void set_dynamic_width(arg_id_kind w)
Definition base.h:754
constexpr auto fill_size() const -> size_t
Definition base.h:790
FMT_CONSTEXPR void set_localized()
Definition base.h:788
An implementation of std::basic_string_view for pre-C++17.
Definition base.h:515
constexpr auto end() const noexcept -> iterator
Definition base.h:563
const Char * iterator
Definition base.h:522
constexpr auto size() const noexcept -> size_t
Returns the string size.
Definition base.h:560
constexpr basic_string_view(nullptr_t)=delete
FMT_CONSTEXPR basic_string_view(const S &s) noexcept
Constructs a string view from a std::basic_string or a std::basic_string_view object.
Definition base.h:553
constexpr auto data() const noexcept -> const Char *
Returns a pointer to the string data.
Definition base.h:557
friend auto operator>(basic_string_view lhs, basic_string_view rhs) -> bool
Definition base.h:605
FMT_CONSTEXPR auto starts_with(Char c) const noexcept -> bool
Definition base.h:578
constexpr auto begin() const noexcept -> iterator
Definition base.h:562
friend auto operator<(basic_string_view lhs, basic_string_view rhs) -> bool
Definition base.h:599
Char value_type
Definition base.h:521
FMT_CONSTEXPR auto starts_with(const Char *s) const -> bool
Definition base.h:581
friend auto operator<=(basic_string_view lhs, basic_string_view rhs) -> bool
Definition base.h:602
FMT_CONSTEXPR void remove_prefix(size_t n) noexcept
Definition base.h:569
FMT_CONSTEXPR friend auto operator==(basic_string_view lhs, basic_string_view rhs) -> bool
Definition base.h:592
friend auto operator!=(basic_string_view lhs, basic_string_view rhs) -> bool
Definition base.h:596
constexpr auto operator[](size_t pos) const noexcept -> const Char &
Definition base.h:565
constexpr basic_string_view(const Char *s, size_t count) noexcept
Constructs a string view object from a C string and a size.
Definition base.h:527
FMT_CONSTEXPR20 basic_string_view(const Char *s)
Constructs a string view object from a C string.
Definition base.h:536
FMT_CONSTEXPR auto starts_with(basic_string_view< Char > sv) const noexcept -> bool
Definition base.h:574
constexpr basic_string_view() noexcept
Definition base.h:524
friend auto operator>=(basic_string_view lhs, basic_string_view rhs) -> bool
Definition base.h:608
FMT_CONSTEXPR auto compare(basic_string_view other) const -> int
Definition base.h:585
Definition base.h:2668
FMT_CONSTEXPR void advance_to(iterator)
Definition base.h:2701
@ builtin_types
Definition base.h:2678
FMT_CONSTEXPR context(iterator out, format_args args, locale_ref loc={})
Constructs a context object.
Definition base.h:2682
void operator=(const context &)=delete
FMT_CONSTEXPR auto locale() const -> locale_ref
Definition base.h:2703
FMT_CONSTEXPR auto arg_id(string_view name) const -> int
Definition base.h:2692
auto args() const -> const format_args &
Definition base.h:2695
context(context &&)=default
char char_type
The character type for the output.
Definition base.h:2675
FMT_CONSTEXPR auto out() const -> iterator
Definition base.h:2698
auto arg(string_view name) const -> format_arg
Definition base.h:2689
context(const context &)=delete
FMT_CONSTEXPR auto arg(int id) const -> format_arg
Definition base.h:2688
A contiguous memory buffer with an optional growing ability.
Definition base.h:1763
FMT_CONSTEXPR buffer(grow_fun grow, size_t sz) noexcept
Definition base.h:1775
auto end() const noexcept -> const T *
Definition base.h:1802
FMT_CONSTEXPR20 void append(const U *begin, const U *end)
Appends data to the end of the buffer.
Definition base.h:1845
auto begin() const noexcept -> const T *
Definition base.h:1801
FMT_CONSTEXPR void push_back(const T &value)
Definition base.h:1832
T value_type
Definition base.h:1792
FMT_CONSTEXPR void set(T *buf_data, size_t buf_capacity) noexcept
Sets the buffer data and capacity.
Definition base.h:1786
FMT_CONSTEXPR auto operator[](Idx index) const -> const T &
Definition base.h:1863
constexpr auto size() const noexcept -> size_t
Returns the size of this buffer.
Definition base.h:1805
FMT_CONSTEXPR void try_reserve(size_t new_capacity)
Definition base.h:1828
FMT_CONSTEXPR auto data() const noexcept -> const T *
Definition base.h:1812
constexpr buffer(grow_fun grow, T *p=nullptr, size_t sz=0, size_t cap=0) noexcept
Definition base.h:1778
buffer(const buffer &)=delete
auto end() noexcept -> T *
Definition base.h:1799
FMT_CONSTEXPR void try_resize(size_t count)
Definition base.h:1819
constexpr auto capacity() const noexcept -> size_t
Returns the capacity of this buffer.
Definition base.h:1808
FMT_CONSTEXPR20 ~buffer()=default
auto begin() noexcept -> T *
Definition base.h:1798
const T & const_reference
Definition base.h:1793
FMT_CONSTEXPR auto operator[](Idx index) -> T &
Definition base.h:1859
void operator=(const buffer &)=delete
FMT_CONSTEXPR auto data() noexcept -> T *
Returns a pointer to the buffer data (not null-terminated).
Definition base.h:1811
buffer(buffer &&)=default
FMT_CONSTEXPR void clear()
Clears this buffer.
Definition base.h:1815
Definition base.h:1244
constexpr auto num_args() const -> int
Definition base.h:1256
FMT_CONSTEXPR compile_parse_context(basic_string_view< Char > fmt, int num_args, const type *types, int next_arg_id=0)
Definition base.h:1251
FMT_CONSTEXPR auto next_arg_id() -> int
Definition base.h:1259
FMT_CONSTEXPR void check_arg_id(int id)
Definition base.h:1265
constexpr auto arg_type(int id) const -> type
Definition base.h:1257
FMT_CONSTEXPR void check_dynamic_spec(int arg_id)
Definition base.h:1271
Definition base.h:1983
Container & container
Definition base.h:1994
container_buffer(Container &c)
Definition base.h:1996
Definition base.h:2020
FMT_CONSTEXPR counting_buffer()
Definition base.h:2033
constexpr auto count() const noexcept -> size_t
Definition base.h:2035
Definition base.h:1874
constexpr auto count() const -> size_t
Definition base.h:1881
constexpr fixed_buffer_traits(size_t limit)
Definition base.h:1880
FMT_CONSTEXPR auto limit(size_t size) -> size_t
Definition base.h:1882
Definition base.h:1696
FMT_CONSTEXPR auto on_arg_id(basic_string_view< Char > id) -> int
Definition base.h:1726
FMT_CONSTEXPR format_string_checker(basic_string_view< Char > fmt, arg_pack< T... >)
Definition base.h:1707
FMT_CONSTEXPR void on_replacement_field(int id, const Char *begin)
Definition base.h:1734
FMT_CONSTEXPR auto on_format_specs(int id, const Char *begin, const Char *end) -> const Char *
Definition base.h:1738
FMT_CONSTEXPR auto on_arg_id() -> int
Definition base.h:1721
FMT_CONSTEXPR void on_text(const Char *, const Char *)
Definition base.h:1719
FMT_CONSTEXPR auto on_arg_id(int id) -> int
Definition base.h:1722
FMT_NORETURN FMT_CONSTEXPR void on_error(const char *message)
Definition base.h:1756
auto count() const -> size_t
Definition base.h:1969
iterator_buffer(T *out, size_t n=buffer_size)
Definition base.h:1952
iterator_buffer(iterator_buffer &&other) noexcept
Definition base.h:1954
auto out() -> T *
Definition base.h:1979
iterator_buffer(T *out, size_t=0)
Definition base.h:1976
Definition base.h:1891
iterator_buffer(iterator_buffer &&other) noexcept
Definition base.h:1912
iterator_buffer(OutputIt out, size_t n=buffer_size)
Definition base.h:1910
auto count() const -> size_t
Definition base.h:1926
~iterator_buffer()
Definition base.h:1916
auto out() -> OutputIt
Definition base.h:1922
Definition base.h:2163
int int_value
Definition base.h:2169
FMT_INLINE value(long double x FMT_BUILTIN)
Definition base.h:2221
value(const T &)
Definition base.h:2250
uint128_opt uint128_value
Definition base.h:2174
bool bool_value
Definition base.h:2175
FMT_INLINE value(uint128_opt x FMT_BUILTIN)
Definition base.h:2200
value(const T &named_arg)
Definition base.h:2264
constexpr FMT_INLINE value(bitint< N > x FMT_BUILTIN)
Definition base.h:2204
constexpr FMT_INLINE value(T x FMT_BUILTIN)
Definition base.h:2213
unsigned long long ulong_long_value
Definition base.h:2172
double double_value
Definition base.h:2178
FMT_CONSTEXPR FMT_INLINE value(unsigned long x FMT_BUILTIN)
Definition base.h:2194
constexpr FMT_INLINE value(int x)
Definition base.h:2191
long double long_double_value
Definition base.h:2179
FMT_CONSTEXPR FMT_INLINE value(const char_type *x FMT_BUILTIN)
Definition base.h:2227
constexpr FMT_INLINE value(double x FMT_BUILTIN)
Definition base.h:2220
FMT_INLINE value(const volatile void *x FMT_BUILTIN)
Definition base.h:2244
FMT_INLINE value(const void *x FMT_BUILTIN)
Definition base.h:2241
constexpr FMT_INLINE value(unsigned long long x FMT_BUILTIN)
Definition base.h:2197
FMT_CONSTEXPR20 FMT_INLINE value(T &x)
Definition base.h:2268
FMT_CONSTEXPR FMT_INLINE value(char_type *x FMT_BUILTIN)
Definition base.h:2223
FMT_CONSTEXPR value(const T &x FMT_BUILTIN)
Definition base.h:2233
float float_value
Definition base.h:2177
constexpr FMT_INLINE value()
Definition base.h:2186
constexpr FMT_INLINE value(float x FMT_BUILTIN)
Definition base.h:2219
int128_opt int128_value
Definition base.h:2173
FMT_CONSTEXPR FMT_INLINE value(long x FMT_BUILTIN)
Definition base.h:2193
constexpr FMT_INLINE value(unsigned char x FMT_BUILTIN)
Definition base.h:2188
FMT_INLINE value(volatile void *x FMT_BUILTIN)
Definition base.h:2242
custom_value< Context > custom
Definition base.h:2182
FMT_ALWAYS_INLINE value(const named_arg_info< char_type > *args, size_t size)
Definition base.h:2270
constexpr FMT_INLINE value(ubitint< N > x FMT_BUILTIN)
Definition base.h:2208
named_arg_value< char_type > named_args
Definition base.h:2183
constexpr FMT_INLINE value(signed char x)
Definition base.h:2187
constexpr FMT_INLINE value(unsigned x FMT_BUILTIN)
Definition base.h:2192
FMT_INLINE value(int128_opt x FMT_BUILTIN)
Definition base.h:2199
constexpr FMT_INLINE value(long long x FMT_BUILTIN)
Definition base.h:2196
char_type char_value
Definition base.h:2176
string_value< char_type > string
Definition base.h:2181
typename Context::char_type char_type
Definition base.h:2165
monostate no_value
Definition base.h:2168
FMT_INLINE value(void *x FMT_BUILTIN)
Definition base.h:2240
constexpr FMT_INLINE value(unsigned short x FMT_BUILTIN)
Definition base.h:2190
const void * pointer
Definition base.h:2180
value(const T &x)
Definition base.h:2259
unsigned uint_value
Definition base.h:2170
FMT_INLINE value(nullptr_t)
Definition base.h:2246
constexpr FMT_INLINE value(bool x FMT_BUILTIN)
Definition base.h:2201
long long long_long_value
Definition base.h:2171
constexpr FMT_INLINE value(signed short x)
Definition base.h:2189
Definition format.h:3823
Definition base.h:912
auto get() const -> Locale
Definition format-inl.h:67
Parsing context consisting of a format string range being parsed and an argument counter for automati...
Definition base.h:850
const Char * iterator
Definition base.h:861
constexpr auto begin() const noexcept -> iterator
Returns an iterator to the beginning of the format string range being parsed.
Definition base.h:869
FMT_CONSTEXPR void check_arg_id(basic_string_view< Char >)
Definition base.h:901
FMT_CONSTEXPR void check_dynamic_spec(int arg_id)
Definition base.h:2459
FMT_CONSTEXPR void check_arg_id(int id)
Reports an error if using the automatic argument indexing; otherwise switches to the manual indexing.
Definition base.h:893
FMT_CONSTEXPR auto next_arg_id() -> int
Reports an error if using the manual argument indexing; otherwise returns the next argument index and...
Definition base.h:881
constexpr parse_context(basic_string_view< Char > fmt, int next_arg_id=0)
Definition base.h:863
FMT_CONSTEXPR void advance_to(iterator it)
Advances the begin iterator to it.
Definition base.h:875
Char char_type
Definition base.h:860
constexpr auto end() const noexcept -> iterator
Returns an iterator past the end of the format string range being parsed.
Definition base.h:872
FMT_FUNC void report_error(const char *message)
Reports a format error at compile time or, via a format_error exception, at runtime.
Definition format-inl.h:143
T * p
Definition format.h:754
FMT_INLINE auto format(locale_ref loc, format_string< T... > fmt, T &&... args) -> std::string
Definition format.h:4293
auto invoke_back_inserter() -> decltype(back_inserter(std::declval< Container & >()))
Converts a string literal into a format string that will be parsed at compile time and converted into...
Definition printf.h:50
FMT_CONSTEXPR auto code_point_length(const Char *begin) -> int
Definition base.h:1303
auto get_iterator(Buf &buf, OutputIt) -> decltype(buf.out())
Definition base.h:2126
@ is_unpacked_bit
Definition base.h:2315
FMT_CONSTEXPR auto compare(const Char *s1, const Char *s2, size_t n) -> int
Definition base.h:467
conditional_t< long_short, int, long long > long_type
Definition base.h:1126
FMT_CONSTEXPR auto is_locking() -> bool
Definition base.h:2428
constexpr auto to_ascii(Char c) -> char
Definition base.h:1297
FMT_CONSTEXPR auto parse_dynamic_spec(const Char *begin, const Char *end, int &value, arg_ref< Char > &ref, parse_context< Char > &ctx) -> parse_dynamic_spec_result< Char >
Definition base.h:1400
FMT_CONSTEXPR void ignore_unused(const T &...)
Definition base.h:358
constexpr auto count_static_named_args() -> int
Definition base.h:1079
void vprint_mojibake(FILE *, string_view, const format_args &, bool)
Definition base.h:2442
FMT_CONSTEXPR auto parse_precision(const Char *begin, const Char *end, format_specs &specs, arg_ref< Char > &precision_ref, parse_context< Char > &ctx) -> const Char *
Definition base.h:1442
void init_named_arg(named_arg_info< Char > *, int &arg_index, int &, const T &)
Definition base.h:1099
uint128_opt
Definition base.h:411
constexpr auto is_integral_type(type t) -> bool
Definition base.h:1022
constexpr auto count_named_args() -> int
Definition base.h:1076
FMT_CONSTEXPR auto parse_nonnegative_int(const Char *&begin, const Char *end, int error_value) noexcept -> int
Definition base.h:1312
constexpr auto digits10() noexcept -> int
Definition format.h:1141
FMT_CONSTEXPR void init_static_named_arg(named_arg_info< Char > *, int &arg_index, int &)
Definition base.h:1111
FMT_CONSTEXPR auto invoke_parse(parse_context< Char > &ctx) -> const Char *
Definition base.h:1684
conditional_t< long_short, unsigned, unsigned long long > ulong_type
Definition base.h:1127
int128_opt
Definition base.h:410
FMT_CONSTEXPR auto to_unsigned(Int value) -> make_unsigned_t< Int >
Definition base.h:432
auto has_formatter_impl(T *p, buffered_context< Char > *ctx=nullptr) -> decltype(formatter< U, Char >().format(*p, *ctx), std::true_type())
constexpr auto is_name_start(Char c) -> bool
Definition base.h:1343
constexpr auto in(type t, int set) -> bool
Definition base.h:1030
FMT_CONSTEXPR auto check_char_specs(const format_specs &specs) -> bool
Definition base.h:1666
@ max_packed_args
Definition base.h:2314
FMT_CONSTEXPR void check_for_duplicate(named_arg_info< Char > *named_args, int named_arg_index, basic_string_view< Char > arg_name)
Definition base.h:1090
@ is_utf8_enabled
Definition base.h:451
auto map(int128_opt) -> monostate
Definition base.h:413
constexpr auto narrow(T *) -> char *
Definition base.h:461
constexpr auto is_constant_evaluated(bool default_value=false) noexcept -> bool
Definition base.h:360
constexpr auto is_arithmetic_type(type t) -> bool
Definition base.h:1025
@ long_short
Definition base.h:1125
FMT_ALWAYS_INLINE constexpr auto const_check(T val) -> T
Definition base.h:377
@ has_named_args_bit
Definition base.h:2316
FMT_CONSTEXPR void parse_format_string(basic_string_view< Char > fmt, Handler &&handler)
Definition base.h:1646
FMT_CONSTEXPR auto parse_width(const Char *begin, const Char *end, format_specs &specs, arg_ref< Char > &width_ref, parse_context< Char > &ctx) -> const Char *
Definition base.h:1433
FMT_CONSTEXPR20 auto copy(InputIt begin, InputIt end, OutputIt out) -> OutputIt
Definition base.h:2068
FMT_FUNC void vformat_to(buffer< char > &buf, string_view fmt, format_args args, locale_ref loc)
Definition format-inl.h:1456
decltype(detail::type_mapper< Char >::map(std::declval< T & >())) mapped_t
Definition base.h:1230
FMT_CONSTEXPR auto parse_align(const Char *begin, const Char *end, format_specs &specs) -> const Char *
Definition format.h:2300
bool_constant<(std::is_class< T >::value||std::is_enum< T >::value|| std::is_union< T >::value||std::is_array< T >::value) && !has_to_string_view< T >::value &&!is_named_arg< T >::value && !use_format_as< T >::value &&!use_format_as_member< U >::value > use_formatter
Definition base.h:1153
@ bool_set
Definition base.h:1040
@ uint_set
Definition base.h:1038
@ pointer_set
Definition base.h:1046
@ float_set
Definition base.h:1042
@ cstring_set
Definition base.h:1045
@ char_set
Definition base.h:1041
@ sint_set
Definition base.h:1036
@ string_set
Definition base.h:1044
remove_cvref_t< decltype(format_as(std::declval< const T & >()))> format_as_result
Definition base.h:1130
typename V::value_type char_t
String's character (code unit) type. detail:: is intentional to prevent ADL.
Definition base.h:973
constexpr auto to_string_view(const Char *s) -> basic_string_view< Char >
Definition base.h:948
FMT_CONSTEXPR auto parse_arg_id(const Char *begin, const Char *end, Handler &&handler) -> const Char *
Definition base.h:1348
state
Definition base.h:1457
@ use_utf8
Definition base.h:452
conditional_t< NUM_ARGS<=max_packed_args, value< Context >, basic_format_arg< Context > > arg_t
Definition base.h:2346
type
Definition base.h:975
auto get_buffer(OutputIt out) -> iterator_buffer< OutputIt, T >
Definition base.h:2116
FMT_CONSTEXPR FMT_INLINE auto parse_replacement_field(const Char *begin, const Char *end, Handler &&handler) -> const Char *
Definition base.h:1599
constexpr auto count() -> int
Definition base.h:1071
@ packed_arg_bits
Definition base.h:2312
constexpr auto has_formatter() -> bool
Definition base.h:1165
constexpr auto make_descriptor() -> unsigned long long
Definition base.h:2340
remove_cvref_t< decltype(formatter< T >::format_as(std::declval< const T & >()))> format_as_member_result
Definition base.h:1133
conditional_t< sizeof(Char)==1, unsigned char, unsigned > unsigned_char
Definition base.h:438
constexpr auto encode_types() -> unsigned long long
Definition base.h:2329
FMT_NORETURN FMT_API void assert_fail(const char *file, int line, const char *message)
std::integral_constant< type, Context::builtin_types||TYPE==type::int_type ? TYPE :type::custom_type > stored_type_constant
Definition base.h:1239
FMT_CONSTEXPR20 auto get_container(OutputIt it) -> typename OutputIt::container_type &
Definition base.h:495
FMT_CONSTEXPR auto parse_format_specs(const Char *begin, const Char *end, dynamic_format_specs< Char > &specs, parse_context< Char > &ctx, type arg_type) -> const Char *
Definition base.h:1461
Definition PointerIntPair.h:280
Definition base.h:1693
Definition base.h:426
Definition base.h:1868
constexpr buffer_traits(size_t)
Definition base.h:1869
constexpr auto limit(size_t size) const -> size_t
Definition base.h:1871
constexpr auto count() const -> size_t
Definition base.h:1870
Definition base.h:1680
Definition base.h:2154
Definition base.h:2143
void(* format)(void *arg, parse_context< char_type > &parse_ctx, Context &ctx)
Definition base.h:2146
typename Context::char_type char_type
Definition base.h:2144
void * value
Definition base.h:2145
Definition base.h:1290
arg_ref< Char > width_ref
Definition base.h:1291
arg_ref< Char > precision_ref
Definition base.h:1292
Definition base.h:1375
arg_ref< Char > & ref
Definition base.h:1377
FMT_CONSTEXPR void on_index(int id)
Definition base.h:1380
FMT_CONSTEXPR void on_name(basic_string_view< Char > id)
Definition base.h:1386
arg_id_kind & kind
Definition base.h:1378
parse_context< Char > & ctx
Definition base.h:1376
Definition base.h:2384
conditional_t< NUM_NAMED_ARGS==0, arg_t< Context, NUM_ARGS >[max_of< size_t >(1, NUM_ARGS)], named_arg_store< Context, NUM_ARGS, NUM_NAMED_ARGS, DESC > > type
Definition base.h:2386
type args
Definition base.h:2390
Definition base.h:963
Definition base.h:485
Definition base.h:2104
Definition base.h:935
Definition base.h:1057
Definition base.h:2319
Definition base.h:1058
Definition base.h:443
Definition base.h:1052
Definition format-inl.h:57
Definition base.h:2423
Definition base.h:1083
int id
Definition base.h:1085
const Char * name
Definition base.h:1084
Definition base.h:2351
FMT_CONSTEXPR FMT_ALWAYS_INLINE named_arg_store(T &... values)
Definition base.h:2358
named_arg_store(named_arg_store &&rhs)
Definition base.h:2365
named_arg_store(const named_arg_store &rhs)=delete
arg_t< Context, NUM_ARGS > args[1u+NUM_ARGS]
Definition base.h:2353
named_arg_info< typename Context::char_type > named_args[static_cast< size_t >(NUM_NAMED_ARGS)]
Definition base.h:2355
auto operator=(const named_arg_store &rhs) -> named_arg_store &=delete
auto operator=(named_arg_store &&rhs) -> named_arg_store &=delete
Definition base.h:2149
const named_arg_info< Char > * data
Definition base.h:2150
size_t size
Definition base.h:2151
Definition base.h:1063
const T & value
Definition base.h:1065
const Char * name
Definition base.h:1064
named_arg(const Char *n, const T &v)
Definition base.h:1067
Definition base.h:2394
FMT_CONSTEXPR auto parse(parse_context< Char > &ctx) -> const Char *
Definition base.h:2401
void nonlocking
Definition base.h:2399
FMT_CONSTEXPR void set_debug_format(bool set=true)
Definition base.h:2411
Definition base.h:1393
const Char * end
Definition base.h:1394
arg_id_kind kind
Definition base.h:1395
Definition base.h:2137
const Char * data
Definition base.h:2138
auto str() const -> basic_string_view< Char >
Definition base.h:2140
size_t size
Definition base.h:2139
Definition base.h:1000
Definition base.h:2135
Definition base.h:1171
static auto map(signed char) -> int
static auto map(unsigned short) -> unsigned
static auto map(Char *) -> const Char *
static auto map(const volatile void *) -> const void *
static auto map(unsigned char) -> unsigned
static auto map(const T &) -> conditional_t< std::is_same< C, Char >::value, basic_string_view< C >, void >
static auto map(const void *) -> const void *
static auto map(long long) -> long long
static auto map(T) -> conditional_t< std::is_same< T, char >::value||std::is_same< T, Char >::value, Char, void >
static auto map(const T &named_arg) -> decltype(map(named_arg.value))
static auto map(unsigned long long) -> unsigned long long
static auto map(void *) -> const void *
static auto map(float) -> float
static auto map(bool) -> bool
static auto map(T &) -> conditional_t< has_formatter< T, Char >(), T &, void >
static auto map(long double) -> long double
static auto map(unsigned) -> unsigned
static auto map(unsigned long) -> ulong_type
static auto map(nullptr_t) -> const void *
static auto map(double) -> double
static auto map(const T &) -> void
static auto map(const T &x) -> decltype(map(formatter< T >::format_as(x)))
static auto map(short) -> int
static auto map(int) -> int
static auto map(const T &x) -> decltype(map(format_as(x)))
static auto map(int128_opt) -> int128_opt
static auto map(const Char *) -> const Char *
static auto map(volatile void *) -> const void *
static auto map(uint128_opt) -> uint128_opt
static auto map(bitint< N >) -> conditional_t< N<=64, long long, void >
static auto map(ubitint< N >) -> conditional_t< N<=64, unsigned long long, void >
static auto map(long) -> long_type
Definition base.h:427
Definition base.h:1140
Definition base.h:1137
Definition base.h:1049
Definition base.h:839
int width
Definition base.h:840
constexpr format_specs()
Definition base.h:843
int precision
Definition base.h:841
Definition base.h:2864
OutputIt out
Iterator past the end of the output range.
Definition base.h:2866
size_t size
Total (not truncated) output size.
Definition base.h:2868
Definition base.h:2894
char * out
Pointer to just after the last successful write in the array.
Definition base.h:2896
bool truncated
Specifies if the output was truncated.
Definition base.h:2898
Definition base.h:648
formatter()=delete
A compile-time format string.
Definition base.h:2722
string_view str
Definition base.h:2734
auto get() const -> string_view
Definition base.h:2776
fstring(runtime_format_string<> fmt)
Definition base.h:2772
FMT_CONSTEVAL FMT_ALWAYS_INLINE fstring(const char(&s)[N])
Definition base.h:2739
FMT_ALWAYS_INLINE fstring(const S &)
Definition base.h:2766
FMT_CONSTEVAL FMT_ALWAYS_INLINE fstring(const S &s)
Definition base.h:2753
Definition base.h:619
Definition base.h:331
constexpr monostate()
Definition base.h:332
Definition base.h:2706
basic_string_view< Char > str
Definition base.h:2707
Definition base.h:1279
FMT_CONSTEXPR arg_ref(int idx=0)
Definition base.h:1280
int index
Definition base.h:1283
basic_string_view< Char > name
Definition base.h:1284
FMT_CONSTEXPR arg_ref(basic_string_view< Char > n)
Definition base.h:1281
#define S(label, offset, message)
Definition Errors.h:113