查看“︁cpp/utility/format”︁的源代码

因为以下原因，您没有权限编辑该页面：

您请求的操作仅限属于这些用户组的用户执行：用户、管理员

您可以查看和复制此页面的源代码。

{{title|格式化库 {{mark since c++20}}}}
{{cpp/utility/format/navbar}}

文本格式化库提供 printf 函数族的安全且可扩展的替用品。其意图是补充既存的 C++ I/O 流库。

===格式说明===
格式说明制定了对象在不同类别的选项下会如何进行格式化。

基本类型和标准字符串类型对象会使用{{rl|spec|标准格式说明}}进行格式化。其他库组件也会提供它们自己的格式说明，详情见{{rl|basic_format_string|此处}}。

===格式化函数===
{{dsc begin}}
{{dsc header|format}}
{{dsc inc|cpp/utility/format/dsc format}}
{{dsc inc|cpp/utility/format/dsc format_to}}
{{dsc inc|cpp/utility/format/dsc format_to_n}}
{{dsc inc|cpp/utility/format/dsc formatted_size}}
{{dsc end}}

===格式字符串===
{{dsc begin}}
{{dsc header|format}}
{{dsc inc|cpp/utility/format/dsc basic_format_string}}
{{dsc inc|cpp/utility/format/dsc dynamic_format}}
{{dsc end}}

===格式化概念===
{{dsc begin}}
{{dsc header|format}}
{{dsc inc|cpp/utility/format/dsc formattable}}
{{dsc end}}

===扩展性支持与实现细节===
{{dsc begin}}
{{dsc header|format}}
{{dsc inc|cpp/utility/format/dsc vformat}}
{{dsc inc|cpp/utility/format/dsc vformat_to}}
{{dsc inc|cpp/utility/format/dsc make_format_args}}
{{dsc inc|cpp/utility/format/dsc visit_format_arg}}
{{dsc inc|cpp/utility/format/dsc formatter}}
{{dsc inc|cpp/utility/format/dsc range_formatter}}
{{dsc inc|cpp/utility/format/dsc enable_nonlocking_formatter_optimization}}
{{dsc inc|cpp/utility/format/dsc range_format}}
{{dsc inc|cpp/utility/format/dsc format_kind}}
{{dsc inc|cpp/utility/format/dsc basic_format_arg}}
{{dsc inc|cpp/utility/format/dsc basic_format_args}}
{{dsc inc|cpp/utility/format/dsc basic_format_context}}
{{dsc inc|cpp/utility/format/dsc basic_format_parse_context}}
{{dsc inc|cpp/utility/format/dsc format_error}}
{{dsc end}}

===辅助项 {{mark since c++23}}===
{{dcl begin}}
{{dcla|num=1|anchor=const-formattable-range|expos=yes|1=
template< class R, class CharT >
concept /*const-formattable-range*/ = 
    ranges::input_range<const R> &&
    std::formattable<ranges::range_reference_t<const R>, CharT>;
}}
{{dcla|num=2|anchor=fmt-maybe-const|expos=yes|1=
template< class R, class CharT >
using /*fmt-maybe-const*/ = 
    std::conditional_t</*const-formattable-range*/<R, CharT>, const R, R>;
}}
{{dcl end}}

===注解===
{{ftm begin|sort=1}}
{{ftm|__cpp_lib_format|std=C++20|value=201907L|rowspan="10"|文本格式化}}
{{ftm|-|std=C++23|dr=20|value=202106L|编译期格式字符串检查<br>减少 {{lc|std::vformat_to}} 的参数化}}
{{ftm|-|std=C++23|dr=20|value=202110L|修复时间格式化器中的本地化处理；<br>支持非 const 可格式化类型}}
{{ftm|-|std=C++23|dr=20|value=202207L|暴露 {{lc|std::basic_format_string}}；<br>澄清时间类型的本地化编码处理}}
{{ftm|-|std=C++26|value=202304L|格式化指针}}
{{ftm|-|std=C++26|value=202305L|对格式化参数进行类型检查}}
{{ftm|-|std=C++26|value=202306L|{{rlt|basic_format_arg#visit|std::basic_format_arg::visit}} 成员}}
{{ftm|-|std=C++26|value=202311L|运行时格式字符串}}
{{ftm|-|用 {{lc|std::println}} 打印空行|std=C++26|value=202403L}}
{{ftm|-|允许 {{lc|std::print}} 的一种高效实现{{todo|1=值应 >= 202406L，即与上值不同}}|std=C++26|dr=23|value=202403L}}
{{ftm|__cpp_lib_format_ranges|std=C++23|value=202207L|格式化范围}}
{{ftm|__cpp_lib_format_path|std=C++26|{{lc|std::filesystem::path}} 的格式化|value=202403L}}
{{ftm|__cpp_lib_format_uchar|std=C++26|修正代码单元作为整数格式化|value=202311L}}
{{ftm|__cpp_lib_formatters|std=C++23|{{lc|std::thread::id}} 与 {{lc|std::stacktrace}} 的格式化|value=202302L}}
{{ftm end}}

我们有意将 {{tt|std::basic_format_string}} 的加入（{{wg21|P2508}}）作为缺陷报告处理，因为所有已知的实现都使这些组件在 C++20 模式下可用，尽管它没有被正式分类。

===示例===
{{example|code=
#include <cassert>
#include <format>

int main()
{
    std::string message = std::format("答案是 {}。", 42);
    assert(message == "答案是 42。");
}
}}

===缺陷报告===
{{dr list begin}}
{{dr list item|paper=P2418R2|std=C++20|before=既不可 const 格式化又不可复制的对象（例如类生成器对象）不可格式化|after=允许格式化这些对象（放松格式化器要求）}}
{{dr_p2508}}
{{dr list end}}

===参阅===
{{dsc begin}}
{{dsc inc|cpp/io/dsc print}}
{{dsc inc|cpp/io/dsc println}}
{{dsc inc|cpp/io/basic_ostream/dsc print}}
{{dsc end}}

{{langlinks|en|es|ru|ja}}

该页面使用的模板：

Template:!!（查看源代码）
Template:ambox（查看源代码）
Template:ambox/category（查看源代码）
Template:ambox/core（查看源代码）
Template:anchor（查看源代码）
Template:c/core（查看源代码）
Template:cat handler（查看源代码）
Template:cat handler/blacklist（查看源代码）
Template:cat handler/numbered（查看源代码）
Template:cpp/io/basic ostream/dsc print（查看源代码）
Template:cpp/io/dsc print（查看源代码）
Template:cpp/io/dsc println（查看源代码）
Template:cpp/navbar content（查看源代码）
Template:cpp/navbar heading（查看源代码）
Template:cpp/text/navbar content（查看源代码）
Template:cpp/text/navbar heading（查看源代码）
Template:cpp/utility/format/dsc basic format arg（查看源代码）
Template:cpp/utility/format/dsc basic format args（查看源代码）
Template:cpp/utility/format/dsc basic format context（查看源代码）
Template:cpp/utility/format/dsc basic format parse context（查看源代码）
Template:cpp/utility/format/dsc basic format string（查看源代码）
Template:cpp/utility/format/dsc dynamic format（查看源代码）
Template:cpp/utility/format/dsc enable nonlocking formatter optimization（查看源代码）
Template:cpp/utility/format/dsc format（查看源代码）
Template:cpp/utility/format/dsc format error（查看源代码）
Template:cpp/utility/format/dsc format kind（查看源代码）
Template:cpp/utility/format/dsc format to（查看源代码）
Template:cpp/utility/format/dsc format to n（查看源代码）
Template:cpp/utility/format/dsc formattable（查看源代码）
Template:cpp/utility/format/dsc formatted size（查看源代码）
Template:cpp/utility/format/dsc formatter（查看源代码）
Template:cpp/utility/format/dsc make format args（查看源代码）
Template:cpp/utility/format/dsc range format（查看源代码）
Template:cpp/utility/format/dsc range formatter（查看源代码）
Template:cpp/utility/format/dsc vformat（查看源代码）
Template:cpp/utility/format/dsc vformat to（查看源代码）
Template:cpp/utility/format/dsc visit format arg（查看源代码）
Template:cpp/utility/format/navbar（查看源代码）
Template:cpp/utility/format/navbar content（查看源代码）
Template:cpp/utility/format/navbar heading（查看源代码）
Template:dcl/std（查看源代码）
Template:dcl begin（查看源代码）
Template:dcl end（查看源代码）
Template:dcl list header/link（查看源代码）
Template:dcl sep（查看源代码）
Template:dcla（查看源代码）
Template:dr list begin（查看源代码）
Template:dr list end（查看源代码）
Template:dr list item（查看源代码）
Template:dr p2508（查看源代码）
Template:dsc（查看源代码）
Template:dsc begin（查看源代码）
Template:dsc class（查看源代码）
Template:dsc concept（查看源代码）
Template:dsc editlink（查看源代码）
Template:dsc end（查看源代码）
Template:dsc enum（查看源代码）
Template:dsc fun（查看源代码）
Template:dsc guard（查看源代码）
Template:dsc header（查看源代码）
Template:dsc header/link（查看源代码）
Template:dsc inc（查看源代码）
Template:dsc member（查看源代码）
Template:dsc small（查看源代码）
Template:dsc tclass（查看源代码）
Template:dsc tfun（查看源代码）
Template:dsc tvar（查看源代码）
Template:example（查看源代码）
Template:ftm（查看源代码）
Template:ftm begin（查看源代码）
Template:ftm end（查看源代码）
Template:ftm link（查看源代码）
Template:get lang（查看源代码）
Template:get lang formal（查看源代码）
Template:langlinks（查看源代码）
Template:langlinks/one（查看源代码）
Template:lc（查看源代码）
Template:lines（查看源代码）
Template:ls（查看源代码）
Template:ltt/core（查看源代码）
Template:mark（查看源代码）
Template:mark c++11（查看源代码）
Template:mark c++17（查看源代码）
Template:mark c++20（查看源代码）
Template:mark c++23（查看源代码）
Template:mark c++26（查看源代码）
Template:mark class（查看源代码）
Template:mark concept（查看源代码）
Template:mark deprecated c++26（查看源代码）
Template:mark enum（查看源代码）
Template:mark expos（查看源代码）
Template:mark expos/core（查看源代码）
Template:mark fun（查看源代码）
Template:mark rev（查看源代码）
Template:mark since c++20（查看源代码）
Template:mark since c++23（查看源代码）
Template:mark tclass（查看源代码）
Template:mark tfun（查看源代码）
Template:mark tooltip（查看源代码）
Template:mark tvar（查看源代码）
Template:namespace detect（查看源代码）
Template:navbar（查看源代码）
Template:navbar editlink（查看源代码）
Template:nv（查看源代码）
Template:nv begin（查看源代码）
Template:nv col begin（查看源代码）
Template:nv col end（查看源代码）
Template:nv end（查看源代码）
Template:nv h1（查看源代码）
Template:nv h2（查看源代码）
Template:nv ln（查看源代码）
Template:rl（查看源代码）
Template:rlt（查看源代码）
Template:source（查看源代码）
Template:title（查看源代码）（受保护）
Template:todo（查看源代码）
Template:tooltip（查看源代码）
Template:trim（查看源代码）
Template:tt（查看源代码）
Template:wg21（查看源代码）

返回cpp/utility/format。

cppreference.com

搜索

命名空间

语言变体

查看

操作

查看“︁cpp/utility/format”︁的源代码

导航

工具