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 >
Defined in header <format>
template < ranges:: input_range R, class CharT >
struct /*range-default-formatter*/ < range_format :: sequence , R, CharT > ;
(since C++23)
( exposition only* )

The class template /*range-default-formatter*/ for range types is specialized for formatting range as a sequence of elements if std:: format_kind < R > is std :: range_format :: sequence .

Contents

Member types

Member Definition
maybe-const-r (private) fmt-maybe-const < R, CharT >
( exposition-only member type* )

Data members

Member Description
std:: range_formatter < std:: remove_cvref_t <
ranges:: range_reference_t < maybe-const-r >> , CharT > underlying_ (private) 		the underlying formatter
( exposition-only member object* )

Member functions

(constructor)
(implicitly declared)
constructs a /*range-default-formatter*/
(public member function)
set_separator
sets a specified separator for the range formatted result
(public member function)
set_brackets
sets a specified opening and closing brackets for the range formatted result
(public member function)
parse
parses the format specifier as specified by range-format-spec
(public member function)
format
writes the range formatted output as specified by range-format-spec
(public member function)

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

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

Equivalent to a call to 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 ;

Equivalent to a call to underlying_. set_brackets ( opening, closing ) .

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

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

Equivalent to return underlying_. parse ( ctx ) ; .

Returns an iterator past the end of the range-format-spec .

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

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

Equivalent to return underlying_. format ( elems, ctx ) ; .

Returns an iterator past the end of the output range.

See also

(C++20)
defines formatting rules for a given type
(class template)
(C++23)
class template that helps implementing std::formatter specializations for range types
(class template)