| // -*- 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 { // since C++23, exposition only before C++23 |
| private: |
| basic_string_view<charT> str; // exposition only |
| |
| public: |
| template<class T> consteval basic_format_string(const T& s); |
| |
| constexpr basic_string_view<charT> get() const noexcept { return str; } |
| }; |
| template<class... Args> |
| using format_string = // since C++23, exposition only before C++23 |
| basic_format_string<char, type_identity_t<Args>...>; |
| template<class... Args> |
| using wformat_string = // since C++23, exposition only before C++23 |
| 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 <__config> |
| #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_functions.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> |
| |
| #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER) |
| # pragma GCC system_header |
| #endif |
| |
| #endif // !defined(_LIBCPP_HAS_NO_INCOMPLETE_FORMAT) |
| |
| #endif // _LIBCPP_FORMAT |