// Formatting library for C++ - experimental format string compilation // // Copyright (c) 2012 - present, Victor Zverovich and fmt contributors // All rights reserved. // // For the license information refer to format.h. #ifndef FMT_COMPILE_H_ #define FMT_COMPILE_H_ #include #include "format.h" FMT_BEGIN_NAMESPACE namespace internal { template struct format_part { public: struct named_argument_id { FMT_CONSTEXPR named_argument_id(internal::string_view_metadata id) : id(id) {} internal::string_view_metadata id; }; struct argument_id { FMT_CONSTEXPR argument_id() : argument_id(0u) {} FMT_CONSTEXPR argument_id(unsigned id) : which(which_arg_id::index), val(id) {} FMT_CONSTEXPR argument_id(internal::string_view_metadata id) : which(which_arg_id::named_index), val(id) {} enum class which_arg_id { index, named_index }; which_arg_id which; union value { FMT_CONSTEXPR value() : index(0u) {} FMT_CONSTEXPR value(unsigned id) : index(id) {} FMT_CONSTEXPR value(internal::string_view_metadata id) : named_index(id) {} unsigned index; internal::string_view_metadata named_index; } val; }; struct specification { FMT_CONSTEXPR specification() : arg_id(0u) {} FMT_CONSTEXPR specification(unsigned id) : arg_id(id) {} FMT_CONSTEXPR specification(internal::string_view_metadata id) : arg_id(id) {} argument_id arg_id; internal::dynamic_format_specs parsed_specs; }; FMT_CONSTEXPR format_part() : which(kind::argument_id), end_of_argument_id(0u), val(0u) {} FMT_CONSTEXPR format_part(internal::string_view_metadata text) : which(kind::text), end_of_argument_id(0u), val(text) {} FMT_CONSTEXPR format_part(unsigned id) : which(kind::argument_id), end_of_argument_id(0u), val(id) {} FMT_CONSTEXPR format_part(named_argument_id arg_id) : which(kind::named_argument_id), end_of_argument_id(0u), val(arg_id) {} FMT_CONSTEXPR format_part(specification spec) : which(kind::specification), end_of_argument_id(0u), val(spec) {} enum class kind { argument_id, named_argument_id, text, specification }; kind which; std::size_t end_of_argument_id; union value { FMT_CONSTEXPR value() : arg_id(0u) {} FMT_CONSTEXPR value(unsigned id) : arg_id(id) {} FMT_CONSTEXPR value(named_argument_id named_id) : named_arg_id(named_id.id) {} FMT_CONSTEXPR value(internal::string_view_metadata t) : text(t) {} FMT_CONSTEXPR value(specification s) : spec(s) {} unsigned arg_id; internal::string_view_metadata named_arg_id; internal::string_view_metadata text; specification spec; } val; }; template class format_preparation_handler : public internal::error_handler { private: using part = format_part; public: using iterator = typename basic_string_view::iterator; FMT_CONSTEXPR format_preparation_handler(basic_string_view format, PartsContainer& parts) : parts_(parts), format_(format), parse_context_(format) {} FMT_CONSTEXPR void on_text(const Char* begin, const Char* end) { if (begin == end) return; const auto offset = begin - format_.data(); const auto size = end - begin; parts_.push_back(part(string_view_metadata(offset, size))); } FMT_CONSTEXPR void on_arg_id() { parts_.push_back(part(parse_context_.next_arg_id())); } FMT_CONSTEXPR void on_arg_id(unsigned id) { parse_context_.check_arg_id(id); parts_.push_back(part(id)); } FMT_CONSTEXPR void on_arg_id(basic_string_view id) { const auto view = string_view_metadata(format_, id); const auto arg_id = typename part::named_argument_id(view); parts_.push_back(part(arg_id)); } FMT_CONSTEXPR void on_replacement_field(const Char* ptr) { parts_.back().end_of_argument_id = ptr - format_.begin(); } FMT_CONSTEXPR const Char* on_format_specs(const Char* begin, const Char* end) { const auto specs_offset = to_unsigned(begin - format_.begin()); using parse_context = basic_parse_context; internal::dynamic_format_specs parsed_specs; dynamic_specs_handler handler(parsed_specs, parse_context_); begin = parse_format_specs(begin, end, handler); if (*begin != '}') on_error("missing '}' in format string"); auto& last_part = parts_.back(); auto specs = last_part.which == part::kind::argument_id ? typename part::specification(last_part.val.arg_id) : typename part::specification(last_part.val.named_arg_id); specs.parsed_specs = parsed_specs; last_part = part(specs); last_part.end_of_argument_id = specs_offset; return begin; } private: PartsContainer& parts_; basic_string_view format_; basic_parse_context parse_context_; }; template class prepared_format { public: using char_type = char_t; using format_part_t = format_part; constexpr prepared_format(Format f) : format_(std::move(f)), parts_provider_(to_string_view(format_)) {} prepared_format() = delete; using context = buffer_context; template auto vformat_to(Range out, basic_format_args args) const -> typename Context::iterator { const auto format_view = internal::to_string_view(format_); basic_parse_context parse_ctx(format_view); Context ctx(out.begin(), args); const auto& parts = parts_provider_.parts(); for (auto part_it = parts.begin(); part_it != parts.end(); ++part_it) { const auto& part = *part_it; const auto& value = part.val; switch (part.which) { case format_part_t::kind::text: { const auto text = value.text.to_view(format_view.data()); auto output = ctx.out(); auto&& it = internal::reserve(output, text.size()); it = std::copy_n(text.begin(), text.size(), it); ctx.advance_to(output); } break; case format_part_t::kind::argument_id: { advance_parse_context_to_specification(parse_ctx, part); format_arg(parse_ctx, ctx, value.arg_id); } break; case format_part_t::kind::named_argument_id: { advance_parse_context_to_specification(parse_ctx, part); const auto named_arg_id = value.named_arg_id.to_view(format_view.data()); format_arg(parse_ctx, ctx, named_arg_id); } break; case format_part_t::kind::specification: { const auto& arg_id_value = value.spec.arg_id.val; const auto arg = value.spec.arg_id.which == format_part_t::argument_id::which_arg_id::index ? ctx.arg(arg_id_value.index) : ctx.arg(arg_id_value.named_index.to_view( to_string_view(format_).data())); auto specs = value.spec.parsed_specs; handle_dynamic_spec( specs.width, specs.width_ref, ctx, format_view.begin()); handle_dynamic_spec( specs.precision, specs.precision_ref, ctx, format_view.begin()); check_prepared_specs(specs, arg.type()); advance_parse_context_to_specification(parse_ctx, part); ctx.advance_to( visit_format_arg(arg_formatter(ctx, nullptr, &specs), arg)); } break; } } return ctx.out(); } private: void advance_parse_context_to_specification( basic_parse_context& parse_ctx, const format_part_t& part) const { const auto view = to_string_view(format_); const auto specification_begin = view.data() + part.end_of_argument_id; advance_to(parse_ctx, specification_begin); } template void format_arg(basic_parse_context& parse_ctx, Context& ctx, Id arg_id) const { parse_ctx.check_arg_id(arg_id); const auto stopped_at = visit_format_arg(arg_formatter(ctx), ctx.arg(arg_id)); ctx.advance_to(stopped_at); } template void check_prepared_specs(const basic_format_specs& specs, internal::type arg_type) const { internal::error_handler h; numeric_specs_checker checker(h, arg_type); if (specs.align == align::numeric) checker.require_numeric_argument(); if (specs.sign != sign::none) checker.check_sign(); if (specs.alt) checker.require_numeric_argument(); if (specs.precision >= 0) checker.check_precision(); } private: Format format_; PreparedPartsProvider parts_provider_; }; template struct part_counter { unsigned num_parts = 0; FMT_CONSTEXPR void on_text(const Char* begin, const Char* end) { if (begin != end) ++num_parts; } FMT_CONSTEXPR void on_arg_id() { ++num_parts; } FMT_CONSTEXPR void on_arg_id(unsigned) { ++num_parts; } FMT_CONSTEXPR void on_arg_id(basic_string_view) { ++num_parts; } FMT_CONSTEXPR void on_replacement_field(const Char*) {} FMT_CONSTEXPR const Char* on_format_specs(const Char* begin, const Char* end) { // Find the matching brace. unsigned braces_counter = 0; for (; begin != end; ++begin) { if (*begin == '{') { ++braces_counter; } else if (*begin == '}') { if (braces_counter == 0u) break; --braces_counter; } } return begin; } FMT_CONSTEXPR void on_error(const char*) {} }; template class compiletime_prepared_parts_type_provider { private: using char_type = char_t; static FMT_CONSTEXPR unsigned count_parts() { FMT_CONSTEXPR_DECL const auto text = to_string_view(Format{}); part_counter counter; internal::parse_format_string(text, counter); return counter.num_parts; } // Workaround for old compilers. Compiletime parts preparation will not be // performed with them anyway. #if FMT_USE_CONSTEXPR static FMT_CONSTEXPR_DECL const unsigned number_of_format_parts = compiletime_prepared_parts_type_provider::count_parts(); #else static const unsigned number_of_format_parts = 0u; #endif public: template struct format_parts_array { using value_type = format_part; FMT_CONSTEXPR format_parts_array() : arr{} {} FMT_CONSTEXPR value_type& operator[](unsigned ind) { return arr[ind]; } FMT_CONSTEXPR const value_type* begin() const { return arr; } FMT_CONSTEXPR const value_type* end() const { return begin() + N; } private: value_type arr[N]; }; struct empty { // Parts preparator will search for it using value_type = format_part; }; using type = conditional_t, empty>; }; template class compiletime_prepared_parts_collector { private: using format_part = typename Parts::value_type; public: FMT_CONSTEXPR explicit compiletime_prepared_parts_collector(Parts& parts) : parts_{parts}, counter_{0u} {} FMT_CONSTEXPR void push_back(format_part part) { parts_[counter_++] = part; } FMT_CONSTEXPR format_part& back() { return parts_[counter_ - 1]; } private: Parts& parts_; unsigned counter_; }; template FMT_CONSTEXPR PartsContainer prepare_parts(basic_string_view format) { PartsContainer parts; internal::parse_format_string( format, format_preparation_handler(format, parts)); return parts; } template FMT_CONSTEXPR PartsContainer prepare_compiletime_parts(basic_string_view format) { using collector = compiletime_prepared_parts_collector; PartsContainer parts; collector c(parts); internal::parse_format_string( format, format_preparation_handler(format, c)); return parts; } template class runtime_parts_provider { public: runtime_parts_provider() = delete; template runtime_parts_provider(basic_string_view format) : parts_(prepare_parts(format)) {} const PartsContainer& parts() const { return parts_; } private: PartsContainer parts_; }; template struct compiletime_parts_provider { compiletime_parts_provider() = delete; template FMT_CONSTEXPR compiletime_parts_provider(basic_string_view) {} const PartsContainer& parts() const { static FMT_CONSTEXPR_DECL const PartsContainer prepared_parts = prepare_compiletime_parts( internal::to_string_view(Format{})); return prepared_parts; } }; } // namespace internal #if FMT_USE_CONSTEXPR template ::value)> FMT_CONSTEXPR auto compile(S format_str) -> internal::prepared_format< S, internal::compiletime_parts_provider< S, typename internal::compiletime_prepared_parts_type_provider::type>, Args...> { return format_str; } #endif template auto compile(const Char (&format_str)[N]) -> internal::prepared_format< std::basic_string, internal::runtime_parts_provider>>, Args...> { return std::basic_string(format_str, N - 1); } template std::basic_string format(const CompiledFormat& cf, const Args&... args) { basic_memory_buffer buffer; using range = internal::buffer_range; using context = buffer_context; cf.template vformat_to(range(buffer), {make_format_args(args...)}); return to_string(buffer); } template OutputIt format_to(OutputIt out, const CompiledFormat& cf, const Args&... args) { using char_type = typename CompiledFormat::char_type; using range = internal::output_range; using context = format_context_t; return cf.template vformat_to( range(out), {make_format_args(args...)}); } template ::value)> format_to_n_result format_to_n(OutputIt out, size_t n, const CompiledFormat& cf, const Args&... args) { auto it = format_to(internal::truncating_iterator(out, n), cf, args...); return {it.base(), it.count()}; } template std::size_t formatted_size(const CompiledFormat& cf, const Args&... args) { return fmt::format_to( internal::counting_iterator(), cf, args...) .count(); } FMT_END_NAMESPACE #endif // FMT_COMPILE_H_