// Formatting library for C++ - the core API // // Copyright (c) 2012 - present, Victor Zverovich // All rights reserved. // // For the license information refer to format.h. #ifndef FMT_CORE_H_ #define FMT_CORE_H_ #include #include #include #include #include #include // The fmt library version in the form major * 10000 + minor * 100 + patch. #define FMT_VERSION 50000 #ifdef __has_feature # define FMT_HAS_FEATURE(x) __has_feature(x) #else # define FMT_HAS_FEATURE(x) 0 #endif #ifdef __has_include # define FMT_HAS_INCLUDE(x) __has_include(x) #else # define FMT_HAS_INCLUDE(x) 0 #endif #if defined(__GNUC__) && !defined(__clang__) # define FMT_GCC_VERSION (__GNUC__ * 100 + __GNUC_MINOR__) #else # define FMT_GCC_VERSION 0 #endif #if __cplusplus >= 201103L || defined(__GXX_EXPERIMENTAL_CXX0X__) # define FMT_HAS_GXX_CXX11 FMT_GCC_VERSION #else # define FMT_HAS_GXX_CXX11 0 #endif #ifdef _MSC_VER # define FMT_MSC_VER _MSC_VER #else # define FMT_MSC_VER 0 #endif // Check if relaxed c++14 constexpr is supported. // GCC doesn't allow throw in constexpr until version 6 (bug 67371). #ifndef FMT_USE_CONSTEXPR # define FMT_USE_CONSTEXPR \ (FMT_HAS_FEATURE(cxx_relaxed_constexpr) || FMT_GCC_VERSION >= 600 || \ FMT_MSC_VER >= 1910) #endif #if FMT_USE_CONSTEXPR # define FMT_CONSTEXPR constexpr # define FMT_CONSTEXPR_DECL constexpr #else # define FMT_CONSTEXPR inline # define FMT_CONSTEXPR_DECL #endif #ifndef FMT_OVERRIDE # if FMT_HAS_FEATURE(cxx_override) || \ (FMT_GCC_VERSION >= 408 && FMT_HAS_GXX_CXX11) || \ FMT_MSC_VER >= 1900 # define FMT_OVERRIDE override # else # define FMT_OVERRIDE # endif #endif #if FMT_HAS_FEATURE(cxx_explicit_conversions) # define FMT_EXPLICIT explicit #else # define FMT_EXPLICIT #endif #ifndef FMT_NULL # if FMT_HAS_FEATURE(cxx_nullptr) || \ (FMT_GCC_VERSION >= 408 && FMT_HAS_GXX_CXX11) || \ FMT_MSC_VER >= 1600 # define FMT_NULL nullptr # define FMT_USE_NULLPTR 1 # else # define FMT_NULL NULL # endif #endif #ifndef FMT_USE_NULLPTR # define FMT_USE_NULLPTR 0 #endif // Check if exceptions are disabled. #if defined(__GNUC__) && !defined(__EXCEPTIONS) # define FMT_EXCEPTIONS 0 #elif FMT_MSC_VER && !_HAS_EXCEPTIONS # define FMT_EXCEPTIONS 0 #endif #ifndef FMT_EXCEPTIONS # define FMT_EXCEPTIONS 1 #endif // Define FMT_USE_NOEXCEPT to make fmt use noexcept (C++11 feature). #ifndef FMT_USE_NOEXCEPT # define FMT_USE_NOEXCEPT 0 #endif #if FMT_USE_NOEXCEPT || FMT_HAS_FEATURE(cxx_noexcept) || \ (FMT_GCC_VERSION >= 408 && FMT_HAS_GXX_CXX11) || \ FMT_MSC_VER >= 1900 # define FMT_DETECTED_NOEXCEPT noexcept #else # define FMT_DETECTED_NOEXCEPT throw() #endif #ifndef FMT_NOEXCEPT # if FMT_EXCEPTIONS # define FMT_NOEXCEPT FMT_DETECTED_NOEXCEPT # else # define FMT_NOEXCEPT # endif #endif // This is needed because GCC still uses throw() in its headers when exceptions // are disabled. #if FMT_GCC_VERSION # define FMT_DTOR_NOEXCEPT FMT_DETECTED_NOEXCEPT #else # define FMT_DTOR_NOEXCEPT FMT_NOEXCEPT #endif #if !defined(FMT_HEADER_ONLY) && defined(_WIN32) # ifdef FMT_EXPORT # define FMT_API __declspec(dllexport) # elif defined(FMT_SHARED) # define FMT_API __declspec(dllimport) # endif #endif #ifndef FMT_API # define FMT_API #endif #ifndef FMT_ASSERT # define FMT_ASSERT(condition, message) assert((condition) && message) #endif #define FMT_DELETED = delete // A macro to disallow the copy construction and assignment. #define FMT_DISALLOW_COPY_AND_ASSIGN(Type) \ Type(const Type &) FMT_DELETED; \ void operator=(const Type &) FMT_DELETED // libc++ supports string_view in pre-c++17. #if (FMT_HAS_INCLUDE() && \ (__cplusplus > 201402L || _LIBCPP_VERSION)) || \ (defined(_MSVC_LANG) && _MSVC_LANG > 201402L && _MSC_VER >= 1910) # include # define FMT_USE_STD_STRING_VIEW // std::experimental::basic_string_view::remove_prefix isn't constexpr until // gcc 7.3. #elif (FMT_HAS_INCLUDE() && \ (FMT_GCC_VERSION == 0 || FMT_GCC_VERSION >= 730) && \ __cplusplus >= 201402L) # include # define FMT_USE_EXPERIMENTAL_STRING_VIEW #endif // std::result_of is defined in in gcc 4.4. #if FMT_GCC_VERSION && FMT_GCC_VERSION <= 404 # include #endif namespace fmt { // An implementation of declval for pre-C++11 compilers such as gcc 4. namespace internal { template typename std::add_rvalue_reference::type declval() FMT_NOEXCEPT; } /** \rst An implementation of ``std::basic_string_view`` for pre-C++17. It provides a subset of the API. ``fmt::basic_string_view`` is used for format strings even if ``std::string_view`` is available to prevent issues when a library is compiled with a different ``-std`` option than the client code (which is not recommended). \endrst */ template class basic_string_view { private: const Char *data_; size_t size_; public: typedef Char char_type; typedef const Char *iterator; // Standard basic_string_view type. #if defined(FMT_USE_STD_STRING_VIEW) typedef std::basic_string_view type; #elif defined(FMT_USE_EXPERIMENTAL_STRING_VIEW) typedef std::experimental::basic_string_view type; #else struct type { const char *data() const { return FMT_NULL; } size_t size() const { return 0; }; }; #endif FMT_CONSTEXPR basic_string_view() FMT_NOEXCEPT : data_(FMT_NULL), size_(0) {} /** Constructs a string reference object from a C string and a size. */ FMT_CONSTEXPR basic_string_view(const Char *s, size_t size) FMT_NOEXCEPT : data_(s), size_(size) {} /** \rst Constructs a string reference object from a C string computing the size with ``std::char_traits::length``. \endrst */ basic_string_view(const Char *s) : data_(s), size_(std::char_traits::length(s)) {} /** \rst Constructs a string reference from a ``std::basic_string`` object. \endrst */ template FMT_CONSTEXPR basic_string_view( const std::basic_string &s) FMT_NOEXCEPT : data_(s.c_str()), size_(s.size()) {} FMT_CONSTEXPR basic_string_view(type s) FMT_NOEXCEPT : data_(s.data()), size_(s.size()) {} /** Returns a pointer to the string data. */ const Char *data() const { return data_; } /** Returns the string size. */ FMT_CONSTEXPR size_t size() const { return size_; } FMT_CONSTEXPR iterator begin() const { return data_; } FMT_CONSTEXPR iterator end() const { return data_ + size_; } FMT_CONSTEXPR void remove_prefix(size_t n) { data_ += n; size_ -= n; } // Lexicographically compare this string reference to other. int compare(basic_string_view other) const { size_t size = size_ < other.size_ ? size_ : other.size_; int result = std::char_traits::compare(data_, other.data_, size); if (result == 0) result = size_ == other.size_ ? 0 : (size_ < other.size_ ? -1 : 1); return result; } friend bool operator==(basic_string_view lhs, basic_string_view rhs) { return lhs.compare(rhs) == 0; } friend bool operator!=(basic_string_view lhs, basic_string_view rhs) { return lhs.compare(rhs) != 0; } friend bool operator<(basic_string_view lhs, basic_string_view rhs) { return lhs.compare(rhs) < 0; } friend bool operator<=(basic_string_view lhs, basic_string_view rhs) { return lhs.compare(rhs) <= 0; } friend bool operator>(basic_string_view lhs, basic_string_view rhs) { return lhs.compare(rhs) > 0; } friend bool operator>=(basic_string_view lhs, basic_string_view rhs) { return lhs.compare(rhs) >= 0; } }; typedef basic_string_view string_view; typedef basic_string_view wstring_view; template class basic_format_arg; template class basic_format_args; // A formatter for objects of type T. template struct formatter; namespace internal { /** A contiguous memory buffer with an optional growing ability. */ template class basic_buffer { private: FMT_DISALLOW_COPY_AND_ASSIGN(basic_buffer); T *ptr_; std::size_t size_; std::size_t capacity_; protected: basic_buffer(T *p = FMT_NULL, std::size_t size = 0, std::size_t capacity = 0) FMT_NOEXCEPT: ptr_(p), size_(size), capacity_(capacity) {} /** Sets the buffer data and capacity. */ void set(T *data, std::size_t capacity) FMT_NOEXCEPT { ptr_ = data; capacity_ = capacity; } /** \rst Increases the buffer capacity to hold at least *capacity* elements. \endrst */ virtual void grow(std::size_t capacity) = 0; public: typedef T value_type; typedef const T &const_reference; virtual ~basic_buffer() {} T *begin() FMT_NOEXCEPT { return ptr_; } T *end() FMT_NOEXCEPT { return ptr_ + size_; } /** Returns the size of this buffer. */ std::size_t size() const FMT_NOEXCEPT { return size_; } /** Returns the capacity of this buffer. */ std::size_t capacity() const FMT_NOEXCEPT { return capacity_; } /** Returns a pointer to the buffer data. */ T *data() FMT_NOEXCEPT { return ptr_; } /** Returns a pointer to the buffer data. */ const T *data() const FMT_NOEXCEPT { return ptr_; } /** Resizes the buffer. If T is a POD type new elements may not be initialized. */ void resize(std::size_t new_size) { reserve(new_size); size_ = new_size; } /** \rst Reserves space to store at least *capacity* elements. \endrst */ void reserve(std::size_t capacity) { if (capacity > capacity_) grow(capacity); } void push_back(const T &value) { reserve(size_ + 1); ptr_[size_++] = value; } /** Appends data to the end of the buffer. */ template void append(const U *begin, const U *end); T &operator[](std::size_t index) { return ptr_[index]; } const T &operator[](std::size_t index) const { return ptr_[index]; } }; typedef basic_buffer buffer; typedef basic_buffer wbuffer; // A container-backed buffer. template class container_buffer : public basic_buffer { private: Container &container_; protected: void grow(std::size_t capacity) FMT_OVERRIDE { container_.resize(capacity); this->set(&container_[0], capacity); } public: explicit container_buffer(Container &c) : basic_buffer(&c[0], c.size(), c.size()), container_(c) {} }; struct error_handler { FMT_CONSTEXPR error_handler() {} FMT_CONSTEXPR error_handler(const error_handler &) {} // This function is intentionally not constexpr to give a compile-time error. FMT_API void on_error(const char *message); }; // Formatting of wide characters and strings into a narrow output is disallowed: // fmt::format("{}", L"test"); // error // To fix this, use a wide format string: // fmt::format(L"{}", L"test"); template inline void require_wchar() { static_assert( std::is_same::value, "formatting of wide characters into a narrow output is disallowed"); } template struct named_arg_base; template struct named_arg; template struct is_named_arg : std::false_type {}; template struct is_named_arg> : std::true_type {}; enum type { none_type, name_arg_type, // Integer types should go first, int_type, uint_type, long_long_type, ulong_long_type, bool_type, char_type, last_integer_type = char_type, // followed by floating-point types. double_type, long_double_type, last_numeric_type = long_double_type, cstring_type, string_type, pointer_type, custom_type }; FMT_CONSTEXPR bool is_integral(type t) { FMT_ASSERT(t != internal::name_arg_type, "invalid argument type"); return t > internal::none_type && t <= internal::last_integer_type; } FMT_CONSTEXPR bool is_arithmetic(type t) { FMT_ASSERT(t != internal::name_arg_type, "invalid argument type"); return t > internal::none_type && t <= internal::last_numeric_type; } template struct convert_to_int { enum { value = !std::is_arithmetic::value && std::is_convertible::value }; }; template struct string_value { const Char *value; std::size_t size; }; template struct custom_value { const void *value; void (*format)(const void *arg, Context &ctx); }; // A formatting argument value. template class value { public: typedef typename Context::char_type char_type; union { int int_value; unsigned uint_value; long long long_long_value; unsigned long long ulong_long_value; double double_value; long double long_double_value; const void *pointer; string_value string; string_value sstring; string_value ustring; custom_value custom; }; FMT_CONSTEXPR value(int val = 0) : int_value(val) {} value(unsigned val) { uint_value = val; } value(long long val) { long_long_value = val; } value(unsigned long long val) { ulong_long_value = val; } value(double val) { double_value = val; } value(long double val) { long_double_value = val; } value(const char_type *val) { string.value = val; } value(const signed char *val) { static_assert(std::is_same::value, "incompatible string types"); sstring.value = val; } value(const unsigned char *val) { static_assert(std::is_same::value, "incompatible string types"); ustring.value = val; } value(basic_string_view val) { string.value = val.data(); string.size = val.size(); } value(const void *val) { pointer = val; } template explicit value(const T &val) { custom.value = &val; custom.format = &format_custom_arg; } const named_arg_base &as_named_arg() { return *static_cast*>(pointer); } private: // Formats an argument of a custom type, such as a user-defined class. template static void format_custom_arg(const void *arg, Context &ctx) { // Get the formatter type through the context to allow different contexts // have different extension points, e.g. `formatter` for `format` and // `printf_formatter` for `printf`. typename Context::template formatter_type::type f; auto &&parse_ctx = ctx.parse_context(); parse_ctx.advance_to(f.parse(parse_ctx)); ctx.advance_to(f.format(*static_cast(arg), ctx)); } }; template struct typed_value : value { static const type type_tag = TYPE; template FMT_CONSTEXPR typed_value(const T &val) : value(val) {} }; template FMT_CONSTEXPR basic_format_arg make_arg(const T &value); #define FMT_MAKE_VALUE(TAG, ArgType, ValueType) \ template \ FMT_CONSTEXPR typed_value make_value(ArgType val) { \ return static_cast(val); \ } FMT_MAKE_VALUE(bool_type, bool, int) FMT_MAKE_VALUE(int_type, short, int) FMT_MAKE_VALUE(uint_type, unsigned short, unsigned) FMT_MAKE_VALUE(int_type, int, int) FMT_MAKE_VALUE(uint_type, unsigned, unsigned) // To minimize the number of types we need to deal with, long is translated // either to int or to long long depending on its size. typedef std::conditional::type long_type; FMT_MAKE_VALUE( (sizeof(long) == sizeof(int) ? int_type : long_long_type), long, long_type) typedef std::conditional::type ulong_type; FMT_MAKE_VALUE( (sizeof(unsigned long) == sizeof(unsigned) ? uint_type : ulong_long_type), unsigned long, ulong_type) FMT_MAKE_VALUE(long_long_type, long long, long long) FMT_MAKE_VALUE(ulong_long_type, unsigned long long, unsigned long long) FMT_MAKE_VALUE(int_type, signed char, int) FMT_MAKE_VALUE(uint_type, unsigned char, unsigned) FMT_MAKE_VALUE(char_type, char, int) #if !defined(_MSC_VER) || defined(_NATIVE_WCHAR_T_DEFINED) template inline typed_value make_value(wchar_t val) { require_wchar(); return static_cast(val); } #endif FMT_MAKE_VALUE(double_type, float, double) FMT_MAKE_VALUE(double_type, double, double) FMT_MAKE_VALUE(long_double_type, long double, long double) // Formatting of wide strings into a narrow buffer and multibyte strings // into a wide buffer is disallowed (https://github.com/fmtlib/fmt/pull/606). FMT_MAKE_VALUE(cstring_type, typename C::char_type*, const typename C::char_type*) FMT_MAKE_VALUE(cstring_type, const typename C::char_type*, const typename C::char_type*) FMT_MAKE_VALUE(cstring_type, signed char*, const signed char*) FMT_MAKE_VALUE(cstring_type, const signed char*, const signed char*) FMT_MAKE_VALUE(cstring_type, unsigned char*, const unsigned char*) FMT_MAKE_VALUE(cstring_type, const unsigned char*, const unsigned char*) FMT_MAKE_VALUE(string_type, basic_string_view, basic_string_view) FMT_MAKE_VALUE(string_type, typename basic_string_view::type, basic_string_view) FMT_MAKE_VALUE(string_type, const std::basic_string&, basic_string_view) FMT_MAKE_VALUE(pointer_type, void*, const void*) FMT_MAKE_VALUE(pointer_type, const void*, const void*) #if FMT_USE_NULLPTR FMT_MAKE_VALUE(pointer_type, std::nullptr_t, const void*) #endif // Formatting of arbitrary pointers is disallowed. If you want to output a // pointer cast it to "void *" or "const void *". In particular, this forbids // formatting of "[const] volatile char *" which is printed as bool by // iostreams. template typed_value make_value(const T *) { static_assert(!sizeof(T), "formatting of non-void pointers is disallowed"); } template inline typename std::enable_if< std::is_enum::value && convert_to_int::value, typed_value>::type make_value(const T &val) { return static_cast(val); } template inline typename std::enable_if< !convert_to_int::value && !std::is_convertible>::value && !std::is_convertible>::value, typed_value>::type make_value(const T &val) { return val; } template typed_value make_value(const named_arg &val) { basic_format_arg arg = make_arg(val.value); std::memcpy(val.data, &arg, sizeof(arg)); return static_cast(&val); } // Maximum number of arguments with packed types. enum { max_packed_args = 15 }; template class arg_map; template struct result_of; template struct result_of { // A workaround for gcc 4.4 that doesn't allow F to be a reference. typedef typename std::result_of< typename std::remove_reference::type(Args...)>::type type; }; } // A formatting argument. It is a trivially copyable/constructible type to // allow storage in basic_memory_buffer. template class basic_format_arg { private: internal::value value_; internal::type type_; template friend FMT_CONSTEXPR basic_format_arg internal::make_arg(const T &value); template friend FMT_CONSTEXPR typename internal::result_of::type visit(Visitor &&vis, basic_format_arg arg); friend class basic_format_args; friend class internal::arg_map; typedef typename Context::char_type char_type; public: class handle { public: explicit handle(internal::custom_value custom): custom_(custom) {} void format(Context &ctx) { custom_.format(custom_.value, ctx); } private: internal::custom_value custom_; }; FMT_CONSTEXPR basic_format_arg() : type_(internal::none_type) {} FMT_EXPLICIT operator bool() const FMT_NOEXCEPT { return type_ != internal::none_type; } internal::type type() const { return type_; } bool is_integral() const { return internal::is_integral(type_); } bool is_arithmetic() const { return internal::is_arithmetic(type_); } bool is_pointer() const { return type_ == internal::pointer_type; } }; // Parsing context consisting of a format string range being parsed and an // argument counter for automatic indexing. template class basic_parse_context : private ErrorHandler { private: basic_string_view format_str_; int next_arg_id_; public: typedef Char char_type; typedef typename basic_string_view::iterator iterator; explicit FMT_CONSTEXPR basic_parse_context( basic_string_view format_str, ErrorHandler eh = ErrorHandler()) : ErrorHandler(eh), format_str_(format_str), next_arg_id_(0) {} // Returns an iterator to the beginning of the format string range being // parsed. FMT_CONSTEXPR iterator begin() const FMT_NOEXCEPT { return format_str_.begin(); } // Returns an iterator past the end of the format string range being parsed. FMT_CONSTEXPR iterator end() const FMT_NOEXCEPT { return format_str_.end(); } // Advances the begin iterator to ``it``. FMT_CONSTEXPR void advance_to(iterator it) { format_str_.remove_prefix(it - begin()); } // Returns the next argument index. FMT_CONSTEXPR unsigned next_arg_id(); FMT_CONSTEXPR bool check_arg_id(unsigned) { if (next_arg_id_ > 0) { on_error("cannot switch from automatic to manual argument indexing"); return false; } next_arg_id_ = -1; return true; } void check_arg_id(basic_string_view) {} FMT_CONSTEXPR void on_error(const char *message) { ErrorHandler::on_error(message); } FMT_CONSTEXPR ErrorHandler error_handler() const { return *this; } }; typedef basic_parse_context parse_context; typedef basic_parse_context wparse_context; namespace internal { // A map from argument names to their values for named arguments. template class arg_map { private: FMT_DISALLOW_COPY_AND_ASSIGN(arg_map); typedef typename Context::char_type char_type; struct entry { basic_string_view name; basic_format_arg arg; }; entry *map_; unsigned size_; void push_back(value val) { const internal::named_arg_base &named = val.as_named_arg(); map_[size_] = entry{named.name, named.template deserialize()}; ++size_; } public: arg_map() : map_(FMT_NULL), size_(0) {} void init(const basic_format_args &args); ~arg_map() { delete [] map_; } basic_format_arg find(basic_string_view name) const { // The list is unsorted, so just return the first matching name. for (auto it = map_, end = map_ + size_; it != end; ++it) { if (it->name == name) return it->arg; } return basic_format_arg(); } }; template class context_base { public: typedef OutputIt iterator; private: basic_parse_context parse_context_; iterator out_; basic_format_args args_; protected: typedef Char char_type; typedef basic_format_arg format_arg; context_base(OutputIt out, basic_string_view format_str, basic_format_args args) : parse_context_(format_str), out_(out), args_(args) {} basic_format_args args() const { return args_; } // Returns the argument with specified index. format_arg do_get_arg(unsigned arg_id) { format_arg arg = args_[arg_id]; if (!arg) parse_context_.on_error("argument index out of range"); return arg; } // Checks if manual indexing is used and returns the argument with // specified index. format_arg get_arg(unsigned arg_id) { return this->parse_context().check_arg_id(arg_id) ? this->do_get_arg(arg_id) : format_arg(); } public: basic_parse_context &parse_context() { return parse_context_; } internal::error_handler error_handler() { return parse_context_.error_handler(); } void on_error(const char *message) { parse_context_.on_error(message); } // Returns an iterator to the beginning of the output range. iterator begin() { return out_; } // Advances the begin iterator to ``it``. void advance_to(iterator it) { out_ = it; } }; // Extracts a reference to the container from back_insert_iterator. template inline Container &get_container(std::back_insert_iterator it) { typedef std::back_insert_iterator bi_iterator; struct accessor: bi_iterator { accessor(bi_iterator iter) : bi_iterator(iter) {} using bi_iterator::container; }; return *accessor(it).container; } } // namespace internal // Formatting context. template class basic_context : public internal::context_base, Char> { public: /** The character type for the output. */ typedef Char char_type; // using formatter_type = formatter; template struct formatter_type { typedef formatter type; }; private: internal::arg_map map_; FMT_DISALLOW_COPY_AND_ASSIGN(basic_context); typedef internal::context_base base; typedef typename base::format_arg format_arg; using base::get_arg; public: using typename base::iterator; /** \rst Constructs a ``basic_context`` object. References to the arguments are stored in the object so make sure they have appropriate lifetimes. \endrst */ basic_context(OutputIt out, basic_string_view format_str, basic_format_args args) : base(out, format_str, args) {} format_arg next_arg() { return this->do_get_arg(this->parse_context().next_arg_id()); } format_arg get_arg(unsigned arg_id) { return this->do_get_arg(arg_id); } // Checks if manual indexing is used and returns the argument with the // specified name. format_arg get_arg(basic_string_view name); }; template struct buffer_context { typedef basic_context< std::back_insert_iterator>, Char> type; }; typedef buffer_context::type context; typedef buffer_context::type wcontext; namespace internal { template struct get_type { typedef decltype(make_value( declval::type&>())) value_type; static const type value = value_type::type_tag; }; template FMT_CONSTEXPR uint64_t get_types() { return 0; } template FMT_CONSTEXPR uint64_t get_types() { return get_type::value | (get_types() << 4); } template FMT_CONSTEXPR basic_format_arg make_arg(const T &value) { basic_format_arg arg; arg.type_ = get_type::value; arg.value_ = make_value(value); return arg; } template inline typename std::enable_if>::type make_arg(const T &value) { return make_value(value); } template inline typename std::enable_if>::type make_arg(const T &value) { return make_arg(value); } } /** \rst An array of references to arguments. It can be implicitly converted into `~fmt::basic_format_args` for passing into type-erased formatting functions such as `~fmt::vformat`. \endrst */ template class format_arg_store { private: static const size_t NUM_ARGS = sizeof...(Args); // Packed is a macro on MinGW so use IS_PACKED instead. static const bool IS_PACKED = NUM_ARGS < internal::max_packed_args; typedef typename std::conditional, basic_format_arg>::type value_type; // If the arguments are not packed, add one more element to mark the end. value_type data_[NUM_ARGS + (IS_PACKED && NUM_ARGS != 0 ? 0 : 1)]; friend class basic_format_args; public: static const uint64_t TYPES; #if FMT_GCC_VERSION && FMT_GCC_VERSION <= 405 // Workaround an array initialization bug in gcc 4.5 and earlier. format_arg_store(const Args &... args) { data_ = {internal::make_arg(args)...}; } #else format_arg_store(const Args &... args) : data_{internal::make_arg(args)...} {} #endif basic_format_args operator*() const { return *this; } }; template const uint64_t format_arg_store::TYPES = IS_PACKED ? internal::get_types() : -static_cast(NUM_ARGS); /** \rst Constructs an `~fmt::format_arg_store` object that contains references to arguments and can be implicitly converted to `~fmt::format_args`. `Context` can be omitted in which case it defaults to `~fmt::context`. \endrst */ template inline format_arg_store make_args(const Args & ... args) { return format_arg_store(args...); } template inline format_arg_store make_args(const Args & ... args) { return format_arg_store(args...); } /** Formatting arguments. */ template class basic_format_args { public: typedef unsigned size_type; typedef basic_format_arg format_arg; private: // To reduce compiled code size per formatting function call, types of first // max_packed_args arguments are passed in the types_ field. uint64_t types_; union { // If the number of arguments is less than max_packed_args, the argument // values are stored in values_, otherwise they are stored in args_. // This is done to reduce compiled code size as storing larger objects // may require more code (at least on x86-64) even if the same amount of // data is actually copied to stack. It saves ~10% on the bloat test. const internal::value *values_; const format_arg *args_; }; typename internal::type type(unsigned index) const { unsigned shift = index * 4; uint64_t mask = 0xf; return static_cast( (types_ & (mask << shift)) >> shift); } friend class internal::arg_map; void set_data(const internal::value *values) { values_ = values; } void set_data(const format_arg *args) { args_ = args; } format_arg get(size_type index) const { int64_t signed_types = static_cast(types_); if (signed_types < 0) { uint64_t num_args = -signed_types; return index < num_args ? args_[index] : format_arg(); } format_arg arg; if (index > internal::max_packed_args) return arg; arg.type_ = type(index); if (arg.type_ == internal::none_type) return arg; internal::value &val = arg.value_; val = values_[index]; return arg; } public: basic_format_args() : types_(0) {} /** \rst Constructs a `basic_format_args` object from `~fmt::format_arg_store`. \endrst */ template basic_format_args(const format_arg_store &store) : types_(store.TYPES) { set_data(store.data_); } /** Returns the argument at specified index. */ format_arg operator[](size_type index) const { format_arg arg = get(index); return arg.type_ == internal::name_arg_type ? arg.value_.as_named_arg().template deserialize() : arg; } unsigned max_size() const { int64_t signed_types = static_cast(types_); return static_cast( signed_types < 0 ? -signed_types : static_cast(internal::max_packed_args)); } }; /** An alias to ``basic_format_args``. */ // It is a separate type rather than a typedef to make symbols readable. struct format_args: basic_format_args { template format_args(Args && ... arg) : basic_format_args(std::forward(arg)...) {} }; typedef basic_format_args wformat_args; namespace internal { template struct named_arg_base { basic_string_view name; // Serialized value. mutable char data[sizeof(basic_format_arg)]; named_arg_base(basic_string_view nm) : name(nm) {} template basic_format_arg deserialize() const { basic_format_arg arg; std::memcpy(&arg, data, sizeof(basic_format_arg)); return arg; } }; template struct named_arg : named_arg_base { const T &value; named_arg(basic_string_view name, const T &val) : named_arg_base(name), value(val) {} }; } /** \rst Returns a named argument to be used in a formatting function. **Example**:: fmt::print("Elapsed time: {s:.2f} seconds", fmt::arg("s", 1.23)); \endrst */ template inline internal::named_arg arg(string_view name, const T &arg) { return internal::named_arg(name, arg); } template inline internal::named_arg arg(wstring_view name, const T &arg) { return internal::named_arg(name, arg); } // This function template is deleted intentionally to disable nested named // arguments as in ``format("{}", arg("a", arg("b", 42)))``. template void arg(S, internal::named_arg) FMT_DELETED; enum color { black, red, green, yellow, blue, magenta, cyan, white }; FMT_API void vprint_colored(color c, string_view format, format_args args); /** Formats a string and prints it to stdout using ANSI escape sequences to specify color (experimental). Example: fmt::print_colored(fmt::RED, "Elapsed time: {0:.2f} seconds", 1.23); */ template inline void print_colored(color c, string_view format_str, const Args & ... args) { vprint_colored(c, format_str, make_args(args...)); } context::iterator vformat_to(internal::buffer &buf, string_view format_str, format_args args); wcontext::iterator vformat_to(internal::wbuffer &buf, wstring_view format_str, wformat_args args); template struct is_contiguous : std::false_type {}; template struct is_contiguous> : std::true_type {}; template struct is_contiguous> : std::true_type {}; /** Formats a string and writes the output to ``out``. */ template typename std::enable_if< is_contiguous::value, std::back_insert_iterator>::type vformat_to(std::back_insert_iterator out, string_view format_str, format_args args) { auto& container = internal::get_container(out); internal::container_buffer buf(container); vformat_to(buf, format_str, args); return std::back_inserter(container); } std::string vformat(string_view format_str, format_args args); std::wstring vformat(wstring_view format_str, wformat_args args); /** \rst Formats arguments and returns the result as a string. **Example**:: #include std::string message = fmt::format("The answer is {}", 42); \endrst */ template inline std::string format(string_view format_str, const Args & ... args) { // This should be just // return vformat(format_str, make_args(args...)); // but gcc has trouble optimizing the latter, so break it down. format_arg_store as(args...); return vformat(format_str, as); } template inline std::wstring format(wstring_view format_str, const Args & ... args) { format_arg_store as(args...); return vformat(format_str, as); } FMT_API void vprint(std::FILE *f, string_view format_str, format_args args); /** \rst Prints formatted data to the file *f*. **Example**:: fmt::print(stderr, "Don't {}!", "panic"); \endrst */ template inline void print(std::FILE *f, string_view format_str, const Args & ... args) { format_arg_store as(args...); vprint(f, format_str, as); } FMT_API void vprint(string_view format_str, format_args args); /** \rst Prints formatted data to ``stdout``. **Example**:: fmt::print("Elapsed time: {0:.2f} seconds", 1.23); \endrst */ template inline void print(string_view format_str, const Args & ... args) { format_arg_store as(args...); vprint(format_str, as); } } // namespace fmt #endif // FMT_CORE_H_