1 // -*- C++ -*-
2 //===----------------------------------------------------------------------===//
3 //
4 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5 // See https://llvm.org/LICENSE.txt for license information.
6 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #ifndef _LIBCPP___FORMAT_FORMATTER_CHAR_H
11 #define _LIBCPP___FORMAT_FORMATTER_CHAR_H
12 
13 #include <__availability>
14 #include <__concepts/same_as.h>
15 #include <__config>
16 #include <__format/concepts.h>
17 #include <__format/format_parse_context.h>
18 #include <__format/formatter.h>
19 #include <__format/formatter_integral.h>
20 #include <__format/formatter_output.h>
21 #include <__format/parser_std_format_spec.h>
22 #include <__format/write_escaped.h>
23 #include <__type_traits/conditional.h>
24 #include <__type_traits/make_unsigned.h>
25 
26 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
27 #  pragma GCC system_header
28 #endif
29 
30 _LIBCPP_BEGIN_NAMESPACE_STD
31 
32 #if _LIBCPP_STD_VER >= 20
33 
34 template <__fmt_char_type _CharT>
35 struct _LIBCPP_TEMPLATE_VIS __formatter_char {
36 public:
37   template <class _ParseContext>
parse__formatter_char38   _LIBCPP_HIDE_FROM_ABI constexpr typename _ParseContext::iterator parse(_ParseContext& __ctx) {
39     typename _ParseContext::iterator __result = __parser_.__parse(__ctx, __format_spec::__fields_integral);
40     __format_spec::__process_parsed_char(__parser_, "a character");
41     return __result;
42   }
43 
44   template <class _FormatContext>
format__formatter_char45   _LIBCPP_HIDE_FROM_ABI typename _FormatContext::iterator format(_CharT __value, _FormatContext& __ctx) const {
46     if (__parser_.__type_ == __format_spec::__type::__default || __parser_.__type_ == __format_spec::__type::__char)
47       return __formatter::__format_char(__value, __ctx.out(), __parser_.__get_parsed_std_specifications(__ctx));
48 
49 #  if _LIBCPP_STD_VER >= 23
50     if (__parser_.__type_ == __format_spec::__type::__debug)
51       return __formatter::__format_escaped_char(__value, __ctx.out(), __parser_.__get_parsed_std_specifications(__ctx));
52 #  endif
53 
54     if constexpr (sizeof(_CharT) <= sizeof(unsigned))
55       return __formatter::__format_integer(
56           static_cast<unsigned>(static_cast<make_unsigned_t<_CharT>>(__value)),
57           __ctx,
58           __parser_.__get_parsed_std_specifications(__ctx));
59     else
60       return __formatter::__format_integer(
61           static_cast<make_unsigned_t<_CharT>>(__value), __ctx, __parser_.__get_parsed_std_specifications(__ctx));
62   }
63 
64   template <class _FormatContext>
format__formatter_char65   _LIBCPP_HIDE_FROM_ABI typename _FormatContext::iterator format(char __value, _FormatContext& __ctx) const
66     requires(same_as<_CharT, wchar_t>)
67   {
68     return format(static_cast<wchar_t>(static_cast<unsigned char>(__value)), __ctx);
69   }
70 
71 #  if _LIBCPP_STD_VER >= 23
set_debug_format__formatter_char72   _LIBCPP_HIDE_FROM_ABI constexpr void set_debug_format() { __parser_.__type_ = __format_spec::__type::__debug; }
73 #  endif
74 
75   __format_spec::__parser<_CharT> __parser_;
76 };
77 
78 template <>
79 struct _LIBCPP_TEMPLATE_VIS formatter<char, char> : public __formatter_char<char> {};
80 
81 #  ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS
82 template <>
83 struct _LIBCPP_TEMPLATE_VIS formatter<char, wchar_t> : public __formatter_char<wchar_t> {};
84 
85 template <>
86 struct _LIBCPP_TEMPLATE_VIS formatter<wchar_t, wchar_t> : public __formatter_char<wchar_t> {};
87 
88 #  endif // _LIBCPP_HAS_NO_WIDE_CHARACTERS
89 
90 #endif //_LIBCPP_STD_VER >= 20
91 
92 _LIBCPP_END_NAMESPACE_STD
93 
94 #endif // _LIBCPP___FORMAT_FORMATTER_CHAR_H
95