C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 程序支持工具
- std::initializer_list
- 函数对象
- std::hash
- std::pair
- std::tuple
- std::optional
- std::any
- std::variant
- 格式化库 (C++20)
- std::formatted_size
- std::format
- std::format_to
- std::format_to_n
- std::vformat
- std::vformat_to
- std::formatter
- std::basic_format_parse_context
- std::basic_format_context
- std::basic_format_arg
- std::basic_format_args
- std::visit_format_arg
- std::make_format_args, std::make_wformat_args
- std::format_error
- std::apply
- 库特性测试宏 (C++20)
- std::integer_sequence
- std::exchange
- std::make_from_tuple
- std::launder
- std::to_chars
- std::from_chars
- std::as_const
- std::source_location
- 变参数函数
- std::bitset
- std::cmp_equal, cmp_not_equal, cmp_less, cmp_greater, cmp_less_equal, cmp_greater_equal
- std::in_range
- std::declval
- std::forward
- std::move
- std::move_if_noexcept
- std::chars_format
- std::piecewise_construct_t
- std::piecewise_construct
- std::in_place, std::in_place_type, std::in_place_index, std::in_place_t, std::in_place_type_t, std::in_place_index_t
- 注释
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
位置:首页 > C++ 参考手册 >工具库 >格式化库 (C++20) > std::basic_format_args
std::basic_format_args
定义于头文件 <format>
|
||
template<class Context> class basic_format_args; |
(1) | (C++20 起) |
using format_args = basic_format_args<std::format_context>; |
(2) | (C++20 起) |
using wformat_args = basic_format_args<std::wformat_context>; |
(3) | (C++20 起) |
template<class OutputIt, class CharT> using format_args_t = basic_format_args<std::basic_format_context<OutputIt, CharT>>; |
(4) | (C++20 起) |
提供到格式化参数的访问。
成员函数
(构造函数) |
构造 basic_format_args 对象 (公开成员函数) |
get |
返回位于给定下标的格式化参数 (公开成员函数) |
std::basic_format_args::basic_format_args
basic_format_args() noexcept; |
(1) | |
template<class... Args> basic_format_args(const /*format-arg-store*/<Context, Args...>& store) noexcept; |
(2) | |
1) 构造不保有任何格式化参数的
basic_format_args
对象。2) 从调用 std::make_format_args 或 std::make_wformat_args 的结果构造
basic_format_args
对象。
std::basic_format_args
拥有引用语义。程序员负责确保 *this
不会比 store
活得更久(从而不应比 std::make_format_args 或 std::make_wformat_args 的参数存活更久)。
std::basic_format_args::get
std::basic_format_arg<Context> get(std::size_t i) const noexcept; |
||
返回保有 args
中第 i
参数的 std::basic_format_arg ,其中 args
是传递给 std::make_format_args 或 std::make_wformat_args 的形参包。
若无足够的参数(即 *this
为默认构造或 i
不小于格式化参数数),则返回默认构造的 std::basic_format_arg (保有 std::monostate 对象)。
示例
本节未完成 原因:暂无示例 |