std::formatter<std::filesystem::path>

template< class CharT >
struct formatter<std::filesystem::path, CharT>;

Специализация шаблона std::formatter для класса std::filesystem::path позволяет пользователям преобразовывать путь к файлу в его текстовое представление с помощью функций форматирования. Эта специализация поддерживает отладочный формат.

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

Синтаксис спецификаций формата path-format-spec:

fill-and-align и width имеют то же значение, что и в стандартной спецификации формата.

Опция ? используется для форматирования пути к файлу в виде строки с экранированием.

Опция g используется, чтобы указать, что путь к файлу представлен в формате generic.

Функции-члены

constexpr void set_debug_format();

constexpr auto parse( std::basic_format_parse_context<CharT>& ctx ) 
    -> std::basic_format_parse_context<CharT>::iterator;

std::formatter<std::filesystem::path>::format

template< class FormatContext >
auto format( const std::filesystem::path& p, FormatContext& ctx ) const 
    -> FormatContext::iterator;

Пусть s будет p.generic<std::filesystem::path::value_type>(), если используется опция g, и p.native() в противном случае. Записывает s в ctx.out() в соответствии с path-format-spec.

При преобразовании кодировки пути к файлу:

• Путь к файлу преобразуется из собственной кодировки широких символьных строк в UTF-8, а максимальные подчасти некорректных последовательностей заменяются на U+FFFD REPLACEMENT CHARACTER, если
  • std::is_same_v<CharT, char> равно true,
  • std::is_same_v<typename path::value_type, wchar_t> равно true, и
  • кодировка обычных литералов — UTF-8.
• В противном случае преобразование кодировки не выполняется, если std::is_same_v<typename path::value_type, CharT> равно true.
• В противном случае преобразование кодировки определяется реализацией.

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

Примечания

Пример

См. также