tmp/tmpd8rry5yn/{from.md → to.md}
RENAMED
|
@@ -0,0 +1,115 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
### Header `<format>` synopsis <a id="format.syn">[[format.syn]]</a>
|
| 2 |
+
|
| 3 |
+
``` cpp
|
| 4 |
+
namespace std {
|
| 5 |
+
// [format.functions], formatting functions
|
| 6 |
+
template<class... Args>
|
| 7 |
+
string format(string_view fmt, const Args&... args);
|
| 8 |
+
template<class... Args>
|
| 9 |
+
wstring format(wstring_view fmt, const Args&... args);
|
| 10 |
+
template<class... Args>
|
| 11 |
+
string format(const locale& loc, string_view fmt, const Args&... args);
|
| 12 |
+
template<class... Args>
|
| 13 |
+
wstring format(const locale& loc, wstring_view fmt, const Args&... args);
|
| 14 |
+
|
| 15 |
+
string vformat(string_view fmt, format_args args);
|
| 16 |
+
wstring vformat(wstring_view fmt, wformat_args args);
|
| 17 |
+
string vformat(const locale& loc, string_view fmt, format_args args);
|
| 18 |
+
wstring vformat(const locale& loc, wstring_view fmt, wformat_args args);
|
| 19 |
+
|
| 20 |
+
template<class Out, class... Args>
|
| 21 |
+
Out format_to(Out out, string_view fmt, const Args&... args);
|
| 22 |
+
template<class Out, class... Args>
|
| 23 |
+
Out format_to(Out out, wstring_view fmt, const Args&... args);
|
| 24 |
+
template<class Out, class... Args>
|
| 25 |
+
Out format_to(Out out, const locale& loc, string_view fmt, const Args&... args);
|
| 26 |
+
template<class Out, class... Args>
|
| 27 |
+
Out format_to(Out out, const locale& loc, wstring_view fmt, const Args&... args);
|
| 28 |
+
|
| 29 |
+
template<class Out>
|
| 30 |
+
Out vformat_to(Out out, string_view fmt,
|
| 31 |
+
format_args_t<type_identity_t<Out>, char> args);
|
| 32 |
+
template<class Out>
|
| 33 |
+
Out vformat_to(Out out, wstring_view fmt,
|
| 34 |
+
format_args_t<type_identity_t<Out>, wchar_t> args);
|
| 35 |
+
template<class Out>
|
| 36 |
+
Out vformat_to(Out out, const locale& loc, string_view fmt,
|
| 37 |
+
format_args_t<type_identity_t<Out>, char> args);
|
| 38 |
+
template<class Out>
|
| 39 |
+
Out vformat_to(Out out, const locale& loc, wstring_view fmt,
|
| 40 |
+
format_args_t<type_identity_t<Out>, wchar_t> args);
|
| 41 |
+
|
| 42 |
+
template<class Out> struct format_to_n_result {
|
| 43 |
+
Out out;
|
| 44 |
+
iter_difference_t<Out> size;
|
| 45 |
+
};
|
| 46 |
+
template<class Out, class... Args>
|
| 47 |
+
format_to_n_result<Out> format_to_n(Out out, iter_difference_t<Out> n,
|
| 48 |
+
string_view fmt, const Args&... args);
|
| 49 |
+
template<class Out, class... Args>
|
| 50 |
+
format_to_n_result<Out> format_to_n(Out out, iter_difference_t<Out> n,
|
| 51 |
+
wstring_view fmt, const Args&... args);
|
| 52 |
+
template<class Out, class... Args>
|
| 53 |
+
format_to_n_result<Out> format_to_n(Out out, iter_difference_t<Out> n,
|
| 54 |
+
const locale& loc, string_view fmt,
|
| 55 |
+
const Args&... args);
|
| 56 |
+
template<class Out, class... Args>
|
| 57 |
+
format_to_n_result<Out> format_to_n(Out out, iter_difference_t<Out> n,
|
| 58 |
+
const locale& loc, wstring_view fmt,
|
| 59 |
+
const Args&... args);
|
| 60 |
+
|
| 61 |
+
template<class... Args>
|
| 62 |
+
size_t formatted_size(string_view fmt, const Args&... args);
|
| 63 |
+
template<class... Args>
|
| 64 |
+
size_t formatted_size(wstring_view fmt, const Args&... args);
|
| 65 |
+
template<class... Args>
|
| 66 |
+
size_t formatted_size(const locale& loc, string_view fmt, const Args&... args);
|
| 67 |
+
template<class... Args>
|
| 68 |
+
size_t formatted_size(const locale& loc, wstring_view fmt, const Args&... args);
|
| 69 |
+
|
| 70 |
+
// [format.formatter], formatter
|
| 71 |
+
template<class T, class charT = char> struct formatter;
|
| 72 |
+
|
| 73 |
+
// [format.parse.ctx], class template basic_format_parse_context
|
| 74 |
+
template<class charT> class basic_format_parse_context;
|
| 75 |
+
using format_parse_context = basic_format_parse_context<char>;
|
| 76 |
+
using wformat_parse_context = basic_format_parse_context<wchar_t>;
|
| 77 |
+
|
| 78 |
+
template<class Out, class charT> class basic_format_context;
|
| 79 |
+
using format_context = basic_format_context<unspecified, char>;
|
| 80 |
+
using wformat_context = basic_format_context<unspecified, wchar_t>;
|
| 81 |
+
|
| 82 |
+
// [format.arguments], arguments
|
| 83 |
+
// [format.arg], class template basic_format_arg
|
| 84 |
+
template<class Context> class basic_format_arg;
|
| 85 |
+
|
| 86 |
+
template<class Visitor, class Context>
|
| 87 |
+
see below visit_format_arg(Visitor&& vis, basic_format_arg<Context> arg);
|
| 88 |
+
|
| 89 |
+
// [format.arg.store], class template format-arg-store
|
| 90 |
+
template<class Context, class... Args> struct format-arg-store; // exposition only
|
| 91 |
+
|
| 92 |
+
template<class Context = format_context, class... Args>
|
| 93 |
+
format-arg-store<Context, Args...>
|
| 94 |
+
make_format_args(const Args&... args);
|
| 95 |
+
template<class... Args>
|
| 96 |
+
format-arg-store<wformat_context, Args...>
|
| 97 |
+
make_wformat_args(const Args&... args);
|
| 98 |
+
|
| 99 |
+
// [format.args], class template basic_format_args
|
| 100 |
+
template<class Context> class basic_format_args;
|
| 101 |
+
using format_args = basic_format_args<format_context>;
|
| 102 |
+
using wformat_args = basic_format_args<wformat_context>;
|
| 103 |
+
|
| 104 |
+
template<class Out, class charT>
|
| 105 |
+
using format_args_t = basic_format_args<basic_format_context<Out, charT>>;
|
| 106 |
+
|
| 107 |
+
// [format.error], class format_error
|
| 108 |
+
class format_error;
|
| 109 |
+
}
|
| 110 |
+
```
|
| 111 |
+
|
| 112 |
+
The class template `format_to_n_result` has the template parameters,
|
| 113 |
+
data members, and special members specified above. It has no base
|
| 114 |
+
classes or members other than those specified.
|
| 115 |
+
|