| // -*- 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 |
| #define _LIBCPP_FORMAT |
| |
| /* |
| |
| namespace std { |
| // [format.context], class template basic_format_context |
| template<class Out, class charT> class basic_format_context; |
| using format_context = basic_format_context<unspecified, char>; |
| using wformat_context = basic_format_context<unspecified, wchar_t>; |
| |
| // [format.args], class template basic_format_args |
| template<class Context> class basic_format_args; |
| using format_args = basic_format_args<format_context>; |
| using wformat_args = basic_format_args<wformat_context>; |
| |
| // [format.fmt.string], class template basic-format-string |
| template<class charT, class... Args> |
| struct basic-format-string; // exposition only |
| |
| template<class... Args> |
| using format-string = // exposition only |
| basic-format-string<char, type_identity_t<Args>...>; |
| template<class... Args> |
| using wformat-string = // exposition only |
| basic-format-string<wchar_t, type_identity_t<Args>...>; |
| |
| // [format.functions], formatting functions |
| template<class... Args> |
| string format(format-string<Args...> fmt, Args&&... args); |
| template<class... Args> |
| wstring format(wformat-string<Args...> fmt, Args&&... args); |
| template<class... Args> |
| string format(const locale& loc, format-string<Args...> fmt, Args&&... args); |
| template<class... Args> |
| wstring format(const locale& loc, wformat-string<Args...> fmt, Args&&... args); |
| |
| string vformat(string_view fmt, format_args args); |
| wstring vformat(wstring_view fmt, wformat_args args); |
| string vformat(const locale& loc, string_view fmt, format_args args); |
| wstring vformat(const locale& loc, wstring_view fmt, wformat_args args); |
| |
| template<class Out, class... Args> |
| Out format_to(Out out, format-string<Args...> fmt, Args&&... args); |
| template<class Out, class... Args> |
| Out format_to(Out out, wformat-string<Args...> fmt, Args&&... args); |
| template<class Out, class... Args> |
| Out format_to(Out out, const locale& loc, format-string<Args...> fmt, Args&&... args); |
| template<class Out, class... Args> |
| Out format_to(Out out, const locale& loc, wformat-string<Args...> fmt, Args&&... args); |
| |
| template<class Out> |
| Out vformat_to(Out out, string_view fmt, format_args args); |
| template<class Out> |
| Out vformat_to(Out out, wstring_view fmt, wformat_args args); |
| template<class Out> |
| Out vformat_to(Out out, const locale& loc, string_view fmt, |
| format_args char> args); |
| template<class Out> |
| Out vformat_to(Out out, const locale& loc, wstring_view fmt, |
| wformat_args args); |
| |
| template<class Out> struct format_to_n_result { |
| Out out; |
| iter_difference_t<Out> size; |
| }; |
| template<class Out, class... Args> |
| format_to_n_result<Out> format_to_n(Out out, iter_difference_t<Out> n, |
| format-string<Args...> fmt, Args&&... args); |
| template<class Out, class... Args> |
| format_to_n_result<Out> format_to_n(Out out, iter_difference_t<Out> n, |
| wformat-string<Args...> fmt, Args&&... args); |
| template<class Out, class... Args> |
| format_to_n_result<Out> format_to_n(Out out, iter_difference_t<Out> n, |
| const locale& loc, format-string<Args...> fmt, |
| Args&&... args); |
| template<class Out, class... Args> |
| format_to_n_result<Out> format_to_n(Out out, iter_difference_t<Out> n, |
| const locale& loc, wformat-string<Args...> fmt, |
| Args&&... args); |
| |
| template<class... Args> |
| size_t formatted_size(format-string<Args...> fmt, Args&&... args); |
| template<class... Args> |
| size_t formatted_size(wformat-string<Args...> fmt, Args&&... args); |
| template<class... Args> |
| size_t formatted_size(const locale& loc, format-string<Args...> fmt, Args&&... args); |
| template<class... Args> |
| size_t formatted_size(const locale& loc, wformat-string<Args...> fmt, Args&&... args); |
| |
| // [format.formatter], formatter |
| template<class T, class charT = char> struct formatter; |
| |
| // [format.parse.ctx], class template basic_format_parse_context |
| template<class charT> class basic_format_parse_context; |
| using format_parse_context = basic_format_parse_context<char>; |
| using wformat_parse_context = basic_format_parse_context<wchar_t>; |
| |
| // [format.arguments], arguments |
| // [format.arg], class template basic_format_arg |
| template<class Context> class basic_format_arg; |
| |
| template<class Visitor, class Context> |
| see below visit_format_arg(Visitor&& vis, basic_format_arg<Context> arg); |
| |
| // [format.arg.store], class template format-arg-store |
| template<class Context, class... Args> struct format-arg-store; // exposition only |
| |
| template<class Context = format_context, class... Args> |
| format-arg-store<Context, Args...> |
| make_format_args(Args&&... args); |
| template<class... Args> |
| format-arg-store<wformat_context, Args...> |
| make_wformat_args(Args&&... args); |
| |
| // [format.error], class format_error |
| class format_error; |
| } |
| |
| */ |
| |
| #include <__assert> // all public C++ headers provide the assertion handler |
| // Make sure all feature-test macros are available. |
| #include <version> |
| // Enable the contents of the header only when libc++ was built with experimental features enabled. |
| #if !defined(_LIBCPP_HAS_NO_INCOMPLETE_FORMAT) |
| |
| #include <__algorithm/clamp.h> |
| #include <__config> |
| #include <__debug> |
| #include <__format/buffer.h> |
| #include <__format/concepts.h> |
| #include <__format/enable_insertable.h> |
| #include <__format/format_arg.h> |
| #include <__format/format_arg_store.h> |
| #include <__format/format_args.h> |
| #include <__format/format_context.h> |
| #include <__format/format_error.h> |
| #include <__format/format_fwd.h> |
| #include <__format/format_parse_context.h> |
| #include <__format/format_string.h> |
| #include <__format/format_to_n_result.h> |
| #include <__format/formatter.h> |
| #include <__format/formatter_bool.h> |
| #include <__format/formatter_char.h> |
| #include <__format/formatter_floating_point.h> |
| #include <__format/formatter_integer.h> |
| #include <__format/formatter_pointer.h> |
| #include <__format/formatter_string.h> |
| #include <__format/parser_std_format_spec.h> |
| #include <__format/unicode.h> |
| #include <__iterator/back_insert_iterator.h> |
| #include <__iterator/incrementable_traits.h> |
| #include <__variant/monostate.h> |
| #include <array> |
| #include <concepts> |
| #include <string> |
| #include <string_view> |
| #include <type_traits> |
| |
| #ifndef _LIBCPP_HAS_NO_LOCALIZATION |
| #include <locale> |
| #endif |
| |
| #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER) |
| # pragma GCC system_header |
| #endif |
| |
| _LIBCPP_BEGIN_NAMESPACE_STD |
| |
| #if _LIBCPP_STD_VER > 17 |
| |
| // TODO FMT Move the implementation in this file to its own granular headers. |
| |
| // TODO FMT Evaluate which templates should be external templates. This |
| // improves the efficiency of the header. However since the header is still |
| // under heavy development and not all classes are stable it makes no sense |
| // to do this optimization now. |
| |
| using format_args = basic_format_args<format_context>; |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| using wformat_args = basic_format_args<wformat_context>; |
| #endif |
| |
| template <class _Context = format_context, class... _Args> |
| _LIBCPP_HIDE_FROM_ABI __format_arg_store<_Context, _Args...> make_format_args(_Args&&... __args) { |
| return _VSTD::__format_arg_store<_Context, _Args...>(__args...); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <class... _Args> |
| _LIBCPP_HIDE_FROM_ABI __format_arg_store<wformat_context, _Args...> make_wformat_args(_Args&&... __args) { |
| return _VSTD::__format_arg_store<wformat_context, _Args...>(__args...); |
| } |
| #endif |
| |
| namespace __format { |
| |
| /// Helper class parse and handle argument. |
| /// |
| /// When parsing a handle which is not enabled the code is ill-formed. |
| /// This helper uses the parser of the appropriate formatter for the stored type. |
| template <class _CharT> |
| class _LIBCPP_TEMPLATE_VIS __compile_time_handle { |
| public: |
| _LIBCPP_HIDE_FROM_ABI |
| constexpr void __parse(basic_format_parse_context<_CharT>& __parse_ctx) const { __parse_(__parse_ctx); } |
| |
| template <class _Tp> |
| _LIBCPP_HIDE_FROM_ABI constexpr void __enable() { |
| __parse_ = [](basic_format_parse_context<_CharT>& __parse_ctx) { |
| formatter<_Tp, _CharT> __f; |
| __parse_ctx.advance_to(__f.parse(__parse_ctx)); |
| }; |
| } |
| |
| // Before calling __parse the proper handler needs to be set with __enable. |
| // The default handler isn't a core constant expression. |
| _LIBCPP_HIDE_FROM_ABI constexpr __compile_time_handle() |
| : __parse_([](basic_format_parse_context<_CharT>&) { __throw_format_error("Not a handle"); }) {} |
| |
| private: |
| void (*__parse_)(basic_format_parse_context<_CharT>&); |
| }; |
| |
| // Dummy format_context only providing the parts used during constant |
| // validation of the basic-format-string. |
| template <class _CharT> |
| struct _LIBCPP_TEMPLATE_VIS __compile_time_basic_format_context { |
| public: |
| using char_type = _CharT; |
| |
| _LIBCPP_HIDE_FROM_ABI constexpr explicit __compile_time_basic_format_context( |
| const __arg_t* __args, const __compile_time_handle<_CharT>* __handles, size_t __size) |
| : __args_(__args), __handles_(__handles), __size_(__size) {} |
| |
| // During the compile-time validation nothing needs to be written. |
| // Therefore all operations of this iterator are a NOP. |
| struct iterator { |
| _LIBCPP_HIDE_FROM_ABI constexpr iterator& operator=(_CharT) { return *this; } |
| _LIBCPP_HIDE_FROM_ABI constexpr iterator& operator*() { return *this; } |
| _LIBCPP_HIDE_FROM_ABI constexpr iterator operator++(int) { return *this; } |
| }; |
| |
| _LIBCPP_HIDE_FROM_ABI constexpr __arg_t arg(size_t __id) const { |
| if (__id >= __size_) |
| __throw_format_error("Argument index out of bounds"); |
| return __args_[__id]; |
| } |
| |
| _LIBCPP_HIDE_FROM_ABI constexpr const __compile_time_handle<_CharT>& __handle(size_t __id) const { |
| if (__id >= __size_) |
| __throw_format_error("Argument index out of bounds"); |
| return __handles_[__id]; |
| } |
| |
| _LIBCPP_HIDE_FROM_ABI constexpr iterator out() { return {}; } |
| _LIBCPP_HIDE_FROM_ABI constexpr void advance_to(iterator) {} |
| |
| private: |
| const __arg_t* __args_; |
| const __compile_time_handle<_CharT>* __handles_; |
| size_t __size_; |
| }; |
| |
| _LIBCPP_HIDE_FROM_ABI |
| constexpr void __compile_time_validate_integral(__arg_t __type) { |
| switch (__type) { |
| case __arg_t::__int: |
| case __arg_t::__long_long: |
| case __arg_t::__i128: |
| case __arg_t::__unsigned: |
| case __arg_t::__unsigned_long_long: |
| case __arg_t::__u128: |
| return; |
| |
| default: |
| __throw_format_error("Argument isn't an integral type"); |
| } |
| } |
| |
| // _HasPrecision does the formatter have a precision? |
| template <class _CharT, class _Tp, bool _HasPrecision = false> |
| _LIBCPP_HIDE_FROM_ABI constexpr void |
| __compile_time_validate_argument(basic_format_parse_context<_CharT>& __parse_ctx, |
| __compile_time_basic_format_context<_CharT>& __ctx) { |
| formatter<_Tp, _CharT> __formatter; |
| __parse_ctx.advance_to(__formatter.parse(__parse_ctx)); |
| // [format.string.std]/7 |
| // ... If the corresponding formatting argument is not of integral type, or |
| // its value is negative for precision or non-positive for width, an |
| // exception of type format_error is thrown. |
| // |
| // Validate whether the arguments are integrals. |
| if constexpr (requires(formatter<_Tp, _CharT> __f) { __f.__width_needs_substitution(); }) { |
| // TODO FMT Remove this when parser v1 has been phased out. |
| if (__formatter.__width_needs_substitution()) |
| __format::__compile_time_validate_integral(__ctx.arg(__formatter.__width)); |
| |
| if constexpr (_HasPrecision) |
| if (__formatter.__precision_needs_substitution()) |
| __format::__compile_time_validate_integral(__ctx.arg(__formatter.__precision)); |
| } else { |
| if (__formatter.__parser_.__width_as_arg_) |
| __format::__compile_time_validate_integral(__ctx.arg(__formatter.__parser_.__width_)); |
| |
| if constexpr (_HasPrecision) |
| if (__formatter.__parser_.__precision_as_arg_) |
| __format::__compile_time_validate_integral(__ctx.arg(__formatter.__parser_.__precision_)); |
| } |
| } |
| |
| template <class _CharT> |
| _LIBCPP_HIDE_FROM_ABI constexpr void __compile_time_visit_format_arg(basic_format_parse_context<_CharT>& __parse_ctx, |
| __compile_time_basic_format_context<_CharT>& __ctx, |
| __arg_t __type) { |
| switch (__type) { |
| case __arg_t::__none: |
| __throw_format_error("Invalid argument"); |
| case __arg_t::__boolean: |
| return __format::__compile_time_validate_argument<_CharT, bool>(__parse_ctx, __ctx); |
| case __arg_t::__char_type: |
| return __format::__compile_time_validate_argument<_CharT, _CharT>(__parse_ctx, __ctx); |
| case __arg_t::__int: |
| return __format::__compile_time_validate_argument<_CharT, int>(__parse_ctx, __ctx); |
| case __arg_t::__long_long: |
| return __format::__compile_time_validate_argument<_CharT, long long>(__parse_ctx, __ctx); |
| case __arg_t::__i128: |
| # ifndef _LIBCPP_HAS_NO_INT128 |
| return __format::__compile_time_validate_argument<_CharT, __int128_t>(__parse_ctx, __ctx); |
| # else |
| __throw_format_error("Invalid argument"); |
| # endif |
| return; |
| case __arg_t::__unsigned: |
| return __format::__compile_time_validate_argument<_CharT, unsigned>(__parse_ctx, __ctx); |
| case __arg_t::__unsigned_long_long: |
| return __format::__compile_time_validate_argument<_CharT, unsigned long long>(__parse_ctx, __ctx); |
| case __arg_t::__u128: |
| # ifndef _LIBCPP_HAS_NO_INT128 |
| return __format::__compile_time_validate_argument<_CharT, __uint128_t>(__parse_ctx, __ctx); |
| # else |
| __throw_format_error("Invalid argument"); |
| # endif |
| return; |
| case __arg_t::__float: |
| return __format::__compile_time_validate_argument<_CharT, float, true>(__parse_ctx, __ctx); |
| case __arg_t::__double: |
| return __format::__compile_time_validate_argument<_CharT, double, true>(__parse_ctx, __ctx); |
| case __arg_t::__long_double: |
| return __format::__compile_time_validate_argument<_CharT, long double, true>(__parse_ctx, __ctx); |
| case __arg_t::__const_char_type_ptr: |
| return __format::__compile_time_validate_argument<_CharT, const _CharT*, true>(__parse_ctx, __ctx); |
| case __arg_t::__string_view: |
| return __format::__compile_time_validate_argument<_CharT, basic_string_view<_CharT>, true>(__parse_ctx, __ctx); |
| case __arg_t::__ptr: |
| return __format::__compile_time_validate_argument<_CharT, const void*>(__parse_ctx, __ctx); |
| case __arg_t::__handle: |
| __throw_format_error("Handle should use __compile_time_validate_handle_argument"); |
| } |
| __throw_format_error("Invalid argument"); |
| } |
| |
| template <class _CharT, class _ParseCtx, class _Ctx> |
| _LIBCPP_HIDE_FROM_ABI constexpr const _CharT* |
| __handle_replacement_field(const _CharT* __begin, const _CharT* __end, |
| _ParseCtx& __parse_ctx, _Ctx& __ctx) { |
| __format::__parse_number_result __r = |
| __format::__parse_arg_id(__begin, __end, __parse_ctx); |
| |
| bool __parse = *__r.__ptr == _CharT(':'); |
| switch (*__r.__ptr) { |
| case _CharT(':'): |
| // The arg-id has a format-specifier, advance the input to the format-spec. |
| __parse_ctx.advance_to(__r.__ptr + 1); |
| break; |
| case _CharT('}'): |
| // The arg-id has no format-specifier. |
| __parse_ctx.advance_to(__r.__ptr); |
| break; |
| default: |
| __throw_format_error( |
| "The replacement field arg-id should terminate at a ':' or '}'"); |
| } |
| |
| if constexpr (same_as<_Ctx, __compile_time_basic_format_context<_CharT>>) { |
| __arg_t __type = __ctx.arg(__r.__value); |
| if (__type == __arg_t::__handle) |
| __ctx.__handle(__r.__value).__parse(__parse_ctx); |
| else |
| __format::__compile_time_visit_format_arg(__parse_ctx, __ctx, __type); |
| } else |
| _VSTD::visit_format_arg( |
| [&](auto __arg) { |
| if constexpr (same_as<decltype(__arg), monostate>) |
| __throw_format_error("Argument index out of bounds"); |
| else if constexpr (same_as<decltype(__arg), typename basic_format_arg<_Ctx>::handle>) |
| __arg.format(__parse_ctx, __ctx); |
| else { |
| formatter<decltype(__arg), _CharT> __formatter; |
| if (__parse) |
| __parse_ctx.advance_to(__formatter.parse(__parse_ctx)); |
| __ctx.advance_to(__formatter.format(__arg, __ctx)); |
| } |
| }, |
| __ctx.arg(__r.__value)); |
| |
| __begin = __parse_ctx.begin(); |
| if (__begin == __end || *__begin != _CharT('}')) |
| __throw_format_error("The replacement field misses a terminating '}'"); |
| |
| return ++__begin; |
| } |
| |
| template <class _ParseCtx, class _Ctx> |
| _LIBCPP_HIDE_FROM_ABI constexpr typename _Ctx::iterator |
| __vformat_to(_ParseCtx&& __parse_ctx, _Ctx&& __ctx) { |
| using _CharT = typename _ParseCtx::char_type; |
| static_assert(same_as<typename _Ctx::char_type, _CharT>); |
| |
| const _CharT* __begin = __parse_ctx.begin(); |
| const _CharT* __end = __parse_ctx.end(); |
| typename _Ctx::iterator __out_it = __ctx.out(); |
| while (__begin != __end) { |
| switch (*__begin) { |
| case _CharT('{'): |
| ++__begin; |
| if (__begin == __end) |
| __throw_format_error("The format string terminates at a '{'"); |
| |
| if (*__begin != _CharT('{')) [[likely]] { |
| __ctx.advance_to(_VSTD::move(__out_it)); |
| __begin = |
| __handle_replacement_field(__begin, __end, __parse_ctx, __ctx); |
| __out_it = __ctx.out(); |
| |
| // The output is written and __begin points to the next character. So |
| // start the next iteration. |
| continue; |
| } |
| // The string is an escape character. |
| break; |
| |
| case _CharT('}'): |
| ++__begin; |
| if (__begin == __end || *__begin != _CharT('}')) |
| __throw_format_error( |
| "The format string contains an invalid escape sequence"); |
| |
| break; |
| } |
| |
| // Copy the character to the output verbatim. |
| *__out_it++ = *__begin++; |
| } |
| return __out_it; |
| } |
| |
| } // namespace __format |
| |
| template <class _CharT, class... _Args> |
| struct _LIBCPP_TEMPLATE_VIS __basic_format_string { |
| basic_string_view<_CharT> __str_; |
| |
| template <class _Tp> |
| requires convertible_to<const _Tp&, basic_string_view<_CharT>> |
| consteval __basic_format_string(const _Tp& __str) : __str_{__str} { |
| __format::__vformat_to(basic_format_parse_context<_CharT>{__str_, sizeof...(_Args)}, |
| _Context{__types_.data(), __handles_.data(), sizeof...(_Args)}); |
| } |
| |
| private: |
| using _Context = __format::__compile_time_basic_format_context<_CharT>; |
| |
| static constexpr array<__format::__arg_t, sizeof...(_Args)> __types_{ |
| __format::__determine_arg_t<_Context, remove_cvref_t<_Args>>()...}; |
| |
| // TODO FMT remove this work-around when the AIX ICE has been resolved. |
| # if defined(_AIX) && defined(_LIBCPP_CLANG_VER) && _LIBCPP_CLANG_VER < 1400 |
| template <class _Tp> |
| static constexpr __format::__compile_time_handle<_CharT> __get_handle() { |
| __format::__compile_time_handle<_CharT> __handle; |
| if (__format::__determine_arg_t<_Context, _Tp>() == __format::__arg_t::__handle) |
| __handle.template __enable<_Tp>(); |
| |
| return __handle; |
| } |
| |
| static constexpr array<__format::__compile_time_handle<_CharT>, sizeof...(_Args)> __handles_{ |
| __get_handle<_Args>()...}; |
| # else |
| static constexpr array<__format::__compile_time_handle<_CharT>, sizeof...(_Args)> __handles_{[] { |
| using _Tp = remove_cvref_t<_Args>; |
| __format::__compile_time_handle<_CharT> __handle; |
| if (__format::__determine_arg_t<_Context, _Tp>() == __format::__arg_t::__handle) |
| __handle.template __enable<_Tp>(); |
| |
| return __handle; |
| }()...}; |
| # endif |
| }; |
| |
| template <class... _Args> |
| using __format_string_t = __basic_format_string<char, type_identity_t<_Args>...>; |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <class... _Args> |
| using __wformat_string_t = __basic_format_string<wchar_t, type_identity_t<_Args>...>; |
| #endif |
| |
| template <class _OutIt, class _CharT, class _FormatOutIt> |
| requires(output_iterator<_OutIt, const _CharT&>) _LIBCPP_HIDE_FROM_ABI _OutIt |
| __vformat_to( |
| _OutIt __out_it, basic_string_view<_CharT> __fmt, |
| basic_format_args<basic_format_context<_FormatOutIt, _CharT>> __args) { |
| if constexpr (same_as<_OutIt, _FormatOutIt>) |
| return _VSTD::__format::__vformat_to( |
| basic_format_parse_context{__fmt, __args.__size()}, |
| _VSTD::__format_context_create(_VSTD::move(__out_it), __args)); |
| else { |
| __format::__format_buffer<_OutIt, _CharT> __buffer{_VSTD::move(__out_it)}; |
| _VSTD::__format::__vformat_to( |
| basic_format_parse_context{__fmt, __args.__size()}, |
| _VSTD::__format_context_create(__buffer.make_output_iterator(), |
| __args)); |
| return _VSTD::move(__buffer).out(); |
| } |
| } |
| |
| // The function is _LIBCPP_ALWAYS_INLINE since the compiler is bad at inlining |
| // https://reviews.llvm.org/D110499#inline-1180704 |
| // TODO FMT Evaluate whether we want to file a Clang bug report regarding this. |
| template <output_iterator<const char&> _OutIt> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT _OutIt |
| vformat_to(_OutIt __out_it, string_view __fmt, format_args __args) { |
| return _VSTD::__vformat_to(_VSTD::move(__out_it), __fmt, __args); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <output_iterator<const wchar_t&> _OutIt> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT _OutIt |
| vformat_to(_OutIt __out_it, wstring_view __fmt, wformat_args __args) { |
| return _VSTD::__vformat_to(_VSTD::move(__out_it), __fmt, __args); |
| } |
| #endif |
| |
| template <output_iterator<const char&> _OutIt, class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT _OutIt |
| format_to(_OutIt __out_it, __format_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::vformat_to(_VSTD::move(__out_it), __fmt.__str_, |
| _VSTD::make_format_args(__args...)); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <output_iterator<const wchar_t&> _OutIt, class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT _OutIt |
| format_to(_OutIt __out_it, __wformat_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::vformat_to(_VSTD::move(__out_it), __fmt.__str_, |
| _VSTD::make_wformat_args(__args...)); |
| } |
| #endif |
| |
| _LIBCPP_ALWAYS_INLINE inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT string |
| vformat(string_view __fmt, format_args __args) { |
| string __res; |
| _VSTD::vformat_to(_VSTD::back_inserter(__res), __fmt, __args); |
| return __res; |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| _LIBCPP_ALWAYS_INLINE inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT wstring |
| vformat(wstring_view __fmt, wformat_args __args) { |
| wstring __res; |
| _VSTD::vformat_to(_VSTD::back_inserter(__res), __fmt, __args); |
| return __res; |
| } |
| #endif |
| |
| template <class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT string format(__format_string_t<_Args...> __fmt, |
| _Args&&... __args) { |
| return _VSTD::vformat(__fmt.__str_, _VSTD::make_format_args(__args...)); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT wstring |
| format(__wformat_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::vformat(__fmt.__str_, _VSTD::make_wformat_args(__args...)); |
| } |
| #endif |
| |
| template <class _Context, class _OutIt, class _CharT> |
| _LIBCPP_HIDE_FROM_ABI format_to_n_result<_OutIt> __vformat_to_n(_OutIt __out_it, iter_difference_t<_OutIt> __n, |
| basic_string_view<_CharT> __fmt, |
| basic_format_args<_Context> __args) { |
| __format::__format_to_n_buffer<_OutIt, _CharT> __buffer{_VSTD::move(__out_it), __n}; |
| _VSTD::__format::__vformat_to(basic_format_parse_context{__fmt, __args.__size()}, |
| _VSTD::__format_context_create(__buffer.make_output_iterator(), __args)); |
| return _VSTD::move(__buffer).result(); |
| } |
| |
| template <output_iterator<const char&> _OutIt, class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT format_to_n_result<_OutIt> |
| format_to_n(_OutIt __out_it, iter_difference_t<_OutIt> __n, __format_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::__vformat_to_n<format_context>(_VSTD::move(__out_it), __n, __fmt.__str_, _VSTD::make_format_args(__args...)); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <output_iterator<const wchar_t&> _OutIt, class... _Args> |
| _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT format_to_n_result<_OutIt> |
| format_to_n(_OutIt __out_it, iter_difference_t<_OutIt> __n, __wformat_string_t<_Args...> __fmt, |
| _Args&&... __args) { |
| return _VSTD::__vformat_to_n<wformat_context>(_VSTD::move(__out_it), __n, __fmt.__str_, _VSTD::make_wformat_args(__args...)); |
| } |
| #endif |
| |
| template <class _CharT> |
| _LIBCPP_HIDE_FROM_ABI size_t __vformatted_size(basic_string_view<_CharT> __fmt, auto __args) { |
| __format::__formatted_size_buffer<_CharT> __buffer; |
| _VSTD::__format::__vformat_to(basic_format_parse_context{__fmt, __args.__size()}, |
| _VSTD::__format_context_create(__buffer.make_output_iterator(), __args)); |
| return _VSTD::move(__buffer).result(); |
| } |
| |
| template <class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT size_t |
| formatted_size(__format_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::__vformatted_size(__fmt.__str_, basic_format_args{_VSTD::make_format_args(__args...)}); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT size_t |
| formatted_size(__wformat_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::__vformatted_size(__fmt.__str_, basic_format_args{_VSTD::make_wformat_args(__args...)}); |
| } |
| #endif |
| |
| #ifndef _LIBCPP_HAS_NO_LOCALIZATION |
| |
| template <class _OutIt, class _CharT, class _FormatOutIt> |
| requires(output_iterator<_OutIt, const _CharT&>) _LIBCPP_HIDE_FROM_ABI _OutIt |
| __vformat_to( |
| _OutIt __out_it, locale __loc, basic_string_view<_CharT> __fmt, |
| basic_format_args<basic_format_context<_FormatOutIt, _CharT>> __args) { |
| if constexpr (same_as<_OutIt, _FormatOutIt>) |
| return _VSTD::__format::__vformat_to( |
| basic_format_parse_context{__fmt, __args.__size()}, |
| _VSTD::__format_context_create(_VSTD::move(__out_it), __args, |
| _VSTD::move(__loc))); |
| else { |
| __format::__format_buffer<_OutIt, _CharT> __buffer{_VSTD::move(__out_it)}; |
| _VSTD::__format::__vformat_to( |
| basic_format_parse_context{__fmt, __args.__size()}, |
| _VSTD::__format_context_create(__buffer.make_output_iterator(), |
| __args, _VSTD::move(__loc))); |
| return _VSTD::move(__buffer).out(); |
| } |
| } |
| |
| template <output_iterator<const char&> _OutIt> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT _OutIt vformat_to( |
| _OutIt __out_it, locale __loc, string_view __fmt, format_args __args) { |
| return _VSTD::__vformat_to(_VSTD::move(__out_it), _VSTD::move(__loc), __fmt, |
| __args); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <output_iterator<const wchar_t&> _OutIt> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT _OutIt vformat_to( |
| _OutIt __out_it, locale __loc, wstring_view __fmt, wformat_args __args) { |
| return _VSTD::__vformat_to(_VSTD::move(__out_it), _VSTD::move(__loc), __fmt, |
| __args); |
| } |
| #endif |
| |
| template <output_iterator<const char&> _OutIt, class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT _OutIt |
| format_to(_OutIt __out_it, locale __loc, __format_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::vformat_to(_VSTD::move(__out_it), _VSTD::move(__loc), __fmt.__str_, |
| _VSTD::make_format_args(__args...)); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <output_iterator<const wchar_t&> _OutIt, class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT _OutIt |
| format_to(_OutIt __out_it, locale __loc, __wformat_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::vformat_to(_VSTD::move(__out_it), _VSTD::move(__loc), __fmt.__str_, |
| _VSTD::make_wformat_args(__args...)); |
| } |
| #endif |
| |
| _LIBCPP_ALWAYS_INLINE inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT string |
| vformat(locale __loc, string_view __fmt, format_args __args) { |
| string __res; |
| _VSTD::vformat_to(_VSTD::back_inserter(__res), _VSTD::move(__loc), __fmt, |
| __args); |
| return __res; |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| _LIBCPP_ALWAYS_INLINE inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT wstring |
| vformat(locale __loc, wstring_view __fmt, wformat_args __args) { |
| wstring __res; |
| _VSTD::vformat_to(_VSTD::back_inserter(__res), _VSTD::move(__loc), __fmt, |
| __args); |
| return __res; |
| } |
| #endif |
| |
| template <class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT string format(locale __loc, |
| __format_string_t<_Args...> __fmt, |
| _Args&&... __args) { |
| return _VSTD::vformat(_VSTD::move(__loc), __fmt.__str_, |
| _VSTD::make_format_args(__args...)); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT wstring |
| format(locale __loc, __wformat_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::vformat(_VSTD::move(__loc), __fmt.__str_, |
| _VSTD::make_wformat_args(__args...)); |
| } |
| #endif |
| |
| template <class _Context, class _OutIt, class _CharT> |
| _LIBCPP_HIDE_FROM_ABI format_to_n_result<_OutIt> __vformat_to_n(_OutIt __out_it, iter_difference_t<_OutIt> __n, |
| locale __loc, basic_string_view<_CharT> __fmt, |
| basic_format_args<_Context> __args) { |
| __format::__format_to_n_buffer<_OutIt, _CharT> __buffer{_VSTD::move(__out_it), __n}; |
| _VSTD::__format::__vformat_to( |
| basic_format_parse_context{__fmt, __args.__size()}, |
| _VSTD::__format_context_create(__buffer.make_output_iterator(), __args, _VSTD::move(__loc))); |
| return _VSTD::move(__buffer).result(); |
| } |
| |
| template <output_iterator<const char&> _OutIt, class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT format_to_n_result<_OutIt> |
| format_to_n(_OutIt __out_it, iter_difference_t<_OutIt> __n, locale __loc, __format_string_t<_Args...> __fmt, |
| _Args&&... __args) { |
| return _VSTD::__vformat_to_n<format_context>(_VSTD::move(__out_it), __n, _VSTD::move(__loc), __fmt.__str_, |
| _VSTD::make_format_args(__args...)); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <output_iterator<const wchar_t&> _OutIt, class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT format_to_n_result<_OutIt> |
| format_to_n(_OutIt __out_it, iter_difference_t<_OutIt> __n, locale __loc, __wformat_string_t<_Args...> __fmt, |
| _Args&&... __args) { |
| return _VSTD::__vformat_to_n<wformat_context>(_VSTD::move(__out_it), __n, _VSTD::move(__loc), __fmt.__str_, |
| _VSTD::make_wformat_args(__args...)); |
| } |
| #endif |
| |
| template <class _CharT> |
| _LIBCPP_HIDE_FROM_ABI size_t __vformatted_size(locale __loc, basic_string_view<_CharT> __fmt, auto __args) { |
| __format::__formatted_size_buffer<_CharT> __buffer; |
| _VSTD::__format::__vformat_to( |
| basic_format_parse_context{__fmt, __args.__size()}, |
| _VSTD::__format_context_create(__buffer.make_output_iterator(), __args, _VSTD::move(__loc))); |
| return _VSTD::move(__buffer).result(); |
| } |
| |
| template <class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT size_t |
| formatted_size(locale __loc, __format_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::__vformatted_size(_VSTD::move(__loc), __fmt.__str_, basic_format_args{_VSTD::make_format_args(__args...)}); |
| } |
| |
| #ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS |
| template <class... _Args> |
| _LIBCPP_ALWAYS_INLINE _LIBCPP_HIDE_FROM_ABI _LIBCPP_AVAILABILITY_FORMAT size_t |
| formatted_size(locale __loc, __wformat_string_t<_Args...> __fmt, _Args&&... __args) { |
| return _VSTD::__vformatted_size(_VSTD::move(__loc), __fmt.__str_, basic_format_args{_VSTD::make_wformat_args(__args...)}); |
| } |
| #endif |
| |
| #endif // _LIBCPP_HAS_NO_LOCALIZATION |
| |
| #endif //_LIBCPP_STD_VER > 17 |
| |
| _LIBCPP_END_NAMESPACE_STD |
| |
| #endif // !defined(_LIBCPP_HAS_NO_INCOMPLETE_FORMAT) |
| |
| #endif // _LIBCPP_FORMAT |
