std::range-default-formatter<std::range_format::string>, std::range-default-formatter<std::range_format::debug_string>

来自cppreference.com
 
C++
 
文本处理库
 
格式化库
标准格式说明
格式化函数
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
格式字符串
(C++20)(C++20)(C++20)
(C++26)
格式化概念
(C++23)
格式化器
(C++20)
(C++23)
(C++23)
(C++23)
(C++23)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
(C++23)
(C++23)
格式化参数
(C++20)
(C++20)
(C++20)(C++20)(C++20)
(C++20) (C++26 弃用)
(C++20)(C++20)
格式错误
(C++20)
 
std::formatter<range>
range-default-formatter 特化
range-default-formatter<std::range_format::string>
range-default-formatter<std::range_format::debug_string>
 
在标头 <format> 定义
template< std::range_format K, ranges::input_range R, class CharT >

    requires (K == std::range_format::string || K == std::range_format::debug_string)

struct /*range-default-formatter*/<K, R, CharT>;
 (C++23 起)
(仅用于阐述*)

用于范围类型的类模板 /*range-default-formatter*/ 进行了特化，用于当 std::format_kind<R> 为 std::range_format::string 或 std::range_format::debug_string 时将范围作为字符串或经转义字符串进行格式化。

目录

[编辑] 数据成员

成员 定义
underlying_ (私有) std::formatter<std::basic_string<CharT>, CharT> 类型的底层格式化器
(仅用于阐述的成员对象*)

[编辑] 成员函数

(构造函数)
(隐式声明)
 构造 range-default-formatter
(公开成员函数)
parse
 按照 范围格式说明 的说明解析格式说明符
(公开成员函数)
format
 按照 范围格式说明 写入范围的格式化输出
(公开成员函数)

std::range-default-formatter<std::range_format::string>::parse
std::range-default-formatter<std::range_format::debug_string>::parse

template< class ParseContext >
constexpr auto parse( ParseContext& ctx ) -> ParseContext::iterator;

等价于：

auto i = underlying_.parse(ctx);
if constexpr (K == std::range_format::debug_string)
    underlying_.set_debug_format();
return i;

返回 范围格式说明 的尾后迭代器。

std::range-default-formatter<std::range_format::string>::format
std::range-default-formatter<std::range_format::debug_string>::format

template< class FormatContext >
auto format( /* 见下文 */& r, FormatContext& ctx ) const -> FormatContext::iterator;

如果 ranges::input_range<const R> 为 true，则 r 的类型为 const R&。否则其类型为 R&。

令 s 为一个 std::basic_string<CharT>，如同以 std::basic_string<CharT>(std::from_range, r) 构造 s 使得 ranges::equal(s, r) 为 true。

等价于 return underlying_.format(s, ctx);。

返回输出范围的尾后迭代器。

[编辑] 参阅

(C++20)
 定义针对给定类型的格式化规则
(类模板) [编辑]
(C++23)
 用于帮助实现 std::formatter 对范围类型的特化的类模板
(类模板) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/utility/format/ranges_formatter/range_default_formatter_string&oldid=94251”