// -*- C++ -*- //===----------------------------------------------------------------------===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// #ifndef _LIBCPP___FORMAT_RANGE_DEFAULT_FORMATTER_H #define _LIBCPP___FORMAT_RANGE_DEFAULT_FORMATTER_H #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER) # pragma GCC system_header #endif #include <__algorithm/ranges_copy.h> #include <__chrono/statically_widen.h> #include <__concepts/same_as.h> #include <__config> #include <__format/concepts.h> #include <__format/formatter.h> #include <__format/range_formatter.h> #include <__iterator/back_insert_iterator.h> #include <__ranges/concepts.h> #include <__ranges/data.h> #include <__ranges/from_range.h> #include <__ranges/size.h> #include <__type_traits/conditional.h> #include <__type_traits/remove_cvref.h> #include <__utility/pair.h> #include _LIBCPP_BEGIN_NAMESPACE_STD #if _LIBCPP_STD_VER >= 23 template concept __const_formattable_range = ranges::input_range && formattable, _CharT>; template using __fmt_maybe_const = conditional_t<__const_formattable_range<_Rp, _CharT>, const _Rp, _Rp>; _LIBCPP_DIAGNOSTIC_PUSH _LIBCPP_CLANG_DIAGNOSTIC_IGNORED("-Wshadow") _LIBCPP_GCC_DIAGNOSTIC_IGNORED("-Wshadow") // This shadows map, set, and string. enum class range_format { disabled, map, set, sequence, string, debug_string }; _LIBCPP_DIAGNOSTIC_POP // There is no definition of this struct, it's purely intended to be used to // generate diagnostics. template struct _LIBCPP_TEMPLATE_VIS __instantiated_the_primary_template_of_format_kind; template constexpr range_format format_kind = [] { // [format.range.fmtkind]/1 // A program that instantiates the primary template of format_kind is ill-formed. static_assert(sizeof(_Rp) != sizeof(_Rp), "create a template specialization of format_kind for your type"); return range_format::disabled; }(); template requires same_as<_Rp, remove_cvref_t<_Rp>> inline constexpr range_format format_kind<_Rp> = [] { // [format.range.fmtkind]/2 // 2.1 If same_as>, R> is true, // Otherwise format_kind is range_format::disabled. if constexpr (same_as>, _Rp>) return range_format::disabled; // 2.2 Otherwise, if the qualified-id R::key_type is valid and denotes a type: else if constexpr (requires { typename _Rp::key_type; }) { // 2.2.1 If the qualified-id R::mapped_type is valid and denotes a type ... if constexpr (requires { typename _Rp::mapped_type; } && // 2.2.1 ... If either U is a specialization of pair or U is a specialization // of tuple and tuple_size_v == 2 __fmt_pair_like>>) return range_format::map; else // 2.2.2 Otherwise format_kind is range_format::set. return range_format::set; } else // 2.3 Otherwise, format_kind is range_format::sequence. return range_format::sequence; }(); template struct _LIBCPP_TEMPLATE_VIS __range_default_formatter; // Required specializations template struct _LIBCPP_TEMPLATE_VIS __range_default_formatter { private: using __maybe_const_r = __fmt_maybe_const<_Rp, _CharT>; range_formatter>, _CharT> __underlying_; public: _LIBCPP_HIDE_FROM_ABI constexpr void set_separator(basic_string_view<_CharT> __separator) noexcept { __underlying_.set_separator(__separator); } _LIBCPP_HIDE_FROM_ABI constexpr void set_brackets(basic_string_view<_CharT> __opening_bracket, basic_string_view<_CharT> __closing_bracket) noexcept { __underlying_.set_brackets(__opening_bracket, __closing_bracket); } template _LIBCPP_HIDE_FROM_ABI constexpr typename _ParseContext::iterator parse(_ParseContext& __ctx) { return __underlying_.parse(__ctx); } template _LIBCPP_HIDE_FROM_ABI typename _FormatContext::iterator format(__maybe_const_r& __range, _FormatContext& __ctx) const { return __underlying_.format(__range, __ctx); } }; template struct _LIBCPP_TEMPLATE_VIS __range_default_formatter { private: using __maybe_const_map = __fmt_maybe_const<_Rp, _CharT>; using __element_type = remove_cvref_t>; range_formatter<__element_type, _CharT> __underlying_; public: _LIBCPP_HIDE_FROM_ABI constexpr __range_default_formatter() requires(__fmt_pair_like<__element_type>) { __underlying_.set_brackets(_LIBCPP_STATICALLY_WIDEN(_CharT, "{"), _LIBCPP_STATICALLY_WIDEN(_CharT, "}")); __underlying_.underlying().set_brackets({}, {}); __underlying_.underlying().set_separator(_LIBCPP_STATICALLY_WIDEN(_CharT, ": ")); } template _LIBCPP_HIDE_FROM_ABI constexpr typename _ParseContext::iterator parse(_ParseContext& __ctx) { return __underlying_.parse(__ctx); } template _LIBCPP_HIDE_FROM_ABI typename _FormatContext::iterator format(__maybe_const_map& __range, _FormatContext& __ctx) const { return __underlying_.format(__range, __ctx); } }; template struct _LIBCPP_TEMPLATE_VIS __range_default_formatter { private: using __maybe_const_set = __fmt_maybe_const<_Rp, _CharT>; using __element_type = remove_cvref_t>; range_formatter<__element_type, _CharT> __underlying_; public: _LIBCPP_HIDE_FROM_ABI constexpr __range_default_formatter() { __underlying_.set_brackets(_LIBCPP_STATICALLY_WIDEN(_CharT, "{"), _LIBCPP_STATICALLY_WIDEN(_CharT, "}")); } template _LIBCPP_HIDE_FROM_ABI constexpr typename _ParseContext::iterator parse(_ParseContext& __ctx) { return __underlying_.parse(__ctx); } template _LIBCPP_HIDE_FROM_ABI typename _FormatContext::iterator format(__maybe_const_set& __range, _FormatContext& __ctx) const { return __underlying_.format(__range, __ctx); } }; template requires(_Kp == range_format::string || _Kp == range_format::debug_string) struct _LIBCPP_TEMPLATE_VIS __range_default_formatter<_Kp, _Rp, _CharT> { private: // This deviates from the Standard, there the exposition only type is // formatter, charT> underlying_; // Using a string_view allows the format function to avoid a copy of the // input range when it is a contigious range. formatter, _CharT> __underlying_; public: template _LIBCPP_HIDE_FROM_ABI constexpr typename _ParseContext::iterator parse(_ParseContext& __ctx) { typename _ParseContext::iterator __i = __underlying_.parse(__ctx); if constexpr (_Kp == range_format::debug_string) __underlying_.set_debug_format(); return __i; } template _LIBCPP_HIDE_FROM_ABI typename _FormatContext::iterator format(conditional_t, const _Rp&, _Rp&> __range, _FormatContext& __ctx) const { // When the range is contiguous use a basic_string_view instead to avoid a // copy of the underlying data. The basic_string_view formatter // specialization is the "basic" string formatter in libc++. if constexpr (ranges::contiguous_range<_Rp> && std::ranges::sized_range<_Rp>) return __underlying_.format(basic_string_view<_CharT>{ranges::data(__range), ranges::size(__range)}, __ctx); else return __underlying_.format(basic_string<_CharT>{from_range, __range}, __ctx); } }; template requires(format_kind<_Rp> != range_format::disabled && formattable, _CharT>) struct _LIBCPP_TEMPLATE_VIS formatter<_Rp, _CharT> : __range_default_formatter, _Rp, _CharT> {}; #endif //_LIBCPP_STD_VER >= 23 _LIBCPP_END_NAMESPACE_STD #endif // _LIBCPP___FORMAT_RANGE_DEFAULT_FORMATTER_H