std::range_formatter

template< class T, class CharT = char >
  requires std::same_as<std::remove_cvref_t<T>, T> && std::formattable<T, CharT>
class range_formatter;

Шаблон класса-помощник для реализации специализаций std::formatter для типов диапазонов.

Спецификация формата диапазона

Синтаксис range-format-spec:

range-fill-and-align интерпретируется так же, как и fill-and-align, за исключением того, что fill в range-fill-and-align — это любой символ, кроме {, }, или :.

ширина описана в стандартной спецификации ширины формата.

Опция n приводит к форматированию диапазона без открывающей и закрывающей скобок.

format-spec в range-underlying-spec (его синтаксис эквивалентен : format-spec), если указано, интерпретируется форматировщиком элемента диапазона std::formatter<T, CharT>.

тип-диапазона изменяет способ форматирования диапазона, при этом определенные опции допустимы только с определёнными типами аргументов.

Доступные типы представления диапазонов:

• m: Указывает, что открывающая скобка должна быть "{", закрывающая скобка должна быть "}", разделитель должен быть ", ", а каждый элемент диапазона должен форматироваться так, как если бы m был указан для его tuple-type (в tuple-format-spec).
• Если m выбрано как тип-диапазона, программа некорректна, если T является специализацией:
• std::pair, или
• std::tuple таким образом, что std::tuple_size_v<T> == 2 является true.
• s: Указывает, что диапазон должен форматироваться как строка.
• ?s: Указывает, что диапазон должен форматироваться как экранированная строка.
• Если s или ?s выбрано как тип-диапазона, обе опции n и range-underlying-spec не должны быть включены в спецификатор формата, и
• программа некорректна, если T является CharT.

Члены-объекты

Члены-функции

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

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

constexpr std::formatter<T, CharT>& underlying();

constexpr const std::formatter<T, CharT>& underlying() const;

std::range_formatter::parse

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

Анализирует спецификаторы формата как range-format-spec и сохраняет проанализированные спецификаторы в текущем объекте.

Вызывает underlying_.parse(ctx) для анализа format-spec в range-format-spec или, если последняя не присутствует, пустого format-spec.

Если тип-диапазона или опция n присутствуют, значения opening-bracket, closing-bracket, и separator изменяются по мере необходимости.

Вызывает underlying_.set_debug_format() если:

• тип-диапазона не является s или ?s,
• underlying_.set_debug_format() является допустимым выражением, и
• нет range-underlying-spec.

Возвращает итератор, следующий за концом range-format-spec.

std::range_formatter::format

template< ranges::input_range R, class FormatContext >
  requires std::formattable<ranges::range_reference_t<R>, CharT> &&
           std::same_as<std::remove_cvref_t<ranges::range_reference_t<R>>, T>
auto format( R&& r, FormatContext& ctx ) const -> typename FormatContext::iterator;

Если тип-диапазона был либо s или ?s, соответственно записывает отформатированный std::basic_string<CharT>(std::from_range, r) в ctx.out() как строку или экранированную строку.

В противном случае записывает следующее в ctx.out() в соответствии со range-format-spec, в порядке:

• opening-bracket_,
• для каждого форматируемого элемента e диапазона r:
• результат записи представления e underlying_, и
• separator_, если e не является последним элементом r,
• closing-bracket_.

Возвращает итератор, следующий за концом выходного диапазона.

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также