home | help
std::range-...t-formatter(3)   C++ Standard Libary  std::range-...t-formatter(3)

NAME
     std::range-default-formatter - std::range-default-formatter

Synopsis
	Defined in header <format>
	template< ranges::input_range R, class CharT >			  (since
     C++23)
	struct range-default-formatter<range_format::sequence, R,	  (expo-
     sition only*)
	CharT>;

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

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

Member objects
     Member name Definition
		 the underlying formatter of type underlying_ std::range_format-
     ter<std::remove_cvref_t<ranges::range_reference_t<maybe-const-r>>,    (pri-
     vate)   CharT>
		 (exposition-only member object*)

Member functions
	constructor	      constructs a range-default-formatter
	(implicitly declared) (public member function)
	set_separator	      sets a specified separator for the range formatted
     result
			      (public member function)
			      sets  a specified opening and closing brackets for
     the range
	set_brackets	      formatted result
			      (public member function)
	parse		      parses the format specifier as specified by range-
     format-spec
			      (public member function)
			      writes the range formatted output as specified by
	format		      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 )  noex-
     cept;

	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
	formatter	defines formatting rules for a given type
	(C++20) 	(class template)
	range_formatter class template that helps implementing std::formatter
	(C++23) 	specializations for range types
			(class template)

http://cppreference.com 	   2024.06.10	    std::range-...t-formatter(3)

home | help