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_parse_context
std::basic_format_parse_context
定义于头文件 <format>
|
||
template<class CharT> class basic_format_parse_context; |
(1) | (C++20 起) |
using format_parse_context = basic_format_parse_context<char>; |
(2) | (C++20 起) |
using wformat_parse_context = basic_format_parse_context<wchar_t>; |
(3) | (C++20 起) |
提供到分析由正在分析的格式字符串范围,和自动下标参数计数组成的格式字符串分析状态的访问。
分析格式说明时,传递 basic_format_parse_context
实例给格式化器 (Formatter) 。
成员类型
类型 | 定义 |
char_type
|
CharT
|
iterator
|
std::basic_string_view<CharT>::const_iterator |
const_iterator
|
std::basic_string_view<CharT>::const_iterator |
成员函数
(构造函数) |
从格式字符串和参数计数构造 std::basic_format_parse_context (公开成员函数) |
operator= [被删除] |
std::basic_format_parse_context 不可复制 (公开成员函数) |
begin |
返回指向格式字符串范围起始的迭代器 (公开成员函数) |
end |
返回指向格式字符串范围末尾的迭代器 (公开成员函数) |
advance_to |
使起始迭代器前进到给定位置 (公开成员函数) |
next_arg_id |
进入自动索引模式,并返回下一个参数下标 (公开成员函数) |
check_arg_id |
进入手动索引模式,检查给定参数下标是否在范围中 (公开成员函数) |
std::basic_format_parse_context::basic_format_parse_context
constexpr explicit basic_format_parse_context(std::basic_string_view<CharT> fmt, std::size_t num_args = 0) noexcept; |
(1) | |
basic_format_parse_context(const basic_format_parse_context&) = delete; |
(2) | |
1) 构造
std::basic_format_parse_context
实例。初始化格式字符串范围为 [fmt.begin(), fmt.end())
,并初始化参数计数为 num_args
。2) 复制构造函数被删除。
std::basic_format_parse_context
不可复制。
std::basic_format_parse_context::begin
constexpr const_iterator begin() const noexcept; |
||
返回指向格式字符串范围起始的迭代器。
std::basic_format_parse_context::end
constexpr const_iterator end() const noexcept; |
||
返回指向格式字符串范围末尾的迭代器。
std::basic_format_parse_context::advance_to
constexpr void advance_to(const_iterator it); |
||
设置格式字符串范围的起始为 it
。调用 advance_to
后,对 begin()
的后继调用将返回 it
的副本。
若 end()
从 it
不可达则行为未定义。
std::basic_format_parse_context::next_arg_id
constexpr std::size_t next_arg_id(); |
||
进入自动参数索引模式,并返回从 0 开始的下个参数下标。
若 *this
已进入手动参数索引模式,则抛出 std::format_error 。
std::basic_format_parse_context::check_arg_id
constexpr void check_arg_id(std::size_t id); |
||
进入手动参数索引模式。
若 *this
以进入自动参数索引模式,则抛出 std::format_error 。
若 id
大于或等于构造函数中提供的参数数量,则该调用不是常量表达式。
示例
本节未完成 原因:暂无示例 |