Namespaces
Variants

std:: range-default-formatter <std::range_format::sequence>

From cppreference.net
C++
Text processing library
Formatting library
Standard format specification
Formatting functions
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Format strings
(C++20) (C++20) (C++20)
(C++26)
Formatting concepts
(C++23)
Formatter
(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)
Formatting arguments
(C++20)
(C++20)
(C++20) (C++20) (C++20)
(C++20) (deprecated in C++26)
(C++20) (C++20)
Format error
(C++20)
std::formatter< range >
定义于头文件 <format>
template < ranges:: input_range R, class CharT >
struct /*range-default-formatter*/ < range_format :: sequence , R, CharT > ;
(C++23 起)
( 仅用于阐释* )

当 std:: format_kind < R > 为 std :: range_format :: sequence 时，针对范围类型的类模板 /*range-default-formatter*/ 会特化为将范围格式化为元素序列的形式。

目录

成员类型

成员 定义
maybe-const-r (私有) fmt-maybe-const < R, CharT >
( 仅用于说明的成员类型* )

数据成员

成员 描述
std:: range_formatter < std:: remove_cvref_t <
ranges:: range_reference_t < maybe-const-r >> , CharT > underlying_ (私有) 		底层格式化器
( 仅用于说明的成员对象* )

成员函数

(构造函数)
(隐式声明)
构造 /*range-default-formatter*/
(公开成员函数)
set_separator
为范围格式化结果设置指定的分隔符
(公开成员函数)
set_brackets
为范围格式化结果设置指定的起始和结束括号
(公开成员函数)
parse
解析由 range-format-spec 指定的格式说明符
(公开成员函数)
format
按照 range-format-spec 的规范写入范围格式化输出
(公开成员函数)

std:: range-default-formatter <std::range_format::sequence>:: set_separator

constexpr void set_separator ( std:: basic_string_view < CharT > sep ) noexcept ;

等效于调用 underlying_. set_separator ( sep ) 。

std:: range-default-formatter <std::range_format::sequence>:: set_brackets

constexpr void set_brackets ( std:: basic_string_view < CharT > opening,
std:: basic_string_view < CharT > closing ) noexcept ;

等效于调用 underlying_. set_brackets ( opening, closing ) 。

std:: range-default-formatter <std::range_format::sequence>:: parse

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

等价于 return underlying_. parse ( ctx ) ; 。

返回指向 范围格式规范 末尾之后位置的迭代器。

std:: range-default-formatter <std::range_format::sequence>:: format

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

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

返回指向输出范围末尾的迭代器。

参见

(C++20)
为给定类型定义格式化规则
(类模板)
(C++23)
用于帮助实现范围类型的 std::formatter 特化的类模板
(类模板)