std::make_format_args, std::make_wformat_args

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека утилит

Языковая поддержка Поддержка типов (базовые типы, RTTI) Макросы тестирования функциональности библиотеки (C++20)     Управление динамической памятью Программные утилиты Поддержка сопрограмм (C++20) Вариативные функции is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Трёхстороннее сравнение (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)     is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

Общие утилиты Дата и время Функциональные объекты Библиотека форматирования (C++20) bitset hash (C++11) Операторы отношения (устарело в C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Целочисленные функции сравнения cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)     cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Операции обмена и типа swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Общие лексические типы pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Элементарные преобразования строк to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

Библиотека форматирования

Функции форматирования

format (C++20)

format_to (C++20)

format_to_n (C++20)

formatted_size (C++20)

vformat (C++20)

vformat_to (C++20)

Концепты форматирования

formattable (C++23)

Форматировщик

formatter (C++20)

range_formatter (C++23)

basic_format_parse_contextformat_parse_contextwformat_parse_context (C++20)(C++20)(C++20)

basic_format_contextformat_contextwformat_context (C++20)(C++20)(C++20)

range_format (C++23)

format_kind (C++23)

Аргументы форматирования

basic_format_arg (C++20)

basic_format_arg::handle (C++20)

basic_format_argsformat_argswformat_args (C++20)(C++20)(C++20)

basic_format_stringformat_stringwformat_string (C++20)(C++20)(C++20)

visit_format_arg (C++20) (устарело в C++26)

make_format_argsmake_wformat_args (C++20)(C++20)

Ошибка формата

format_error (C++20)

 

<tbody> </tbody>

Определено в заголовочном файле <format>
template< class Context = std::format_context, class... Args > /*format-arg-store*/<Context, Args...> make_format_args( Args&&... args );	(1)	(начиная с C++20)
template< class... Args > /*format-arg-store*/<std::wformat_context, Args...> make_wformat_args( Args&&... args );	(2)	(начиная с C++20)

Возвращает объект, который хранит массив аргументов форматирования и может быть неявно преобразован в std::basic_format_args.

Поведение не определено, если typename Context::template formatter_type<std::remove_cvref_t<Ti>> не соответствует требованиям BasicFormatter для любого Ti в Args.

Программа некорректна, если для любого типа Ti в Args, std::remove_reference_t<Ti> не соответствует __formattable_with<Context>.

2) Эквивалентно return std::make_format_args<std::wformat_context>(std::forward<Args>(args)...);.

Параметры

args...

—

значения, используемые в качестве аргументов форматирования

Возвращает

Объект, содержащий аргументы форматирования.

Для каждого аргумента t типа T, пусть TD будет std::remove_const_t<std::remove_reference_t<T>>. Соответствующий std::basic_format_arg в результате определяется следующим образом:

• если TD это bool или Context::char_type, то std::basic_format_arg хранит t;
• иначе, если TD это char и Context::char_type равен wchar_t, то std::basic_format_arg хранит static_cast<wchar_t>(t);
• иначе, если TD является целочисленным типом со знаком, размер которого не превышает int, то std::basic_format_arg хранит static_cast<int>(t);
• иначе, если TD представляет собой целочисленный тип без знака, размер которого не превышает unsigned int, то std::basic_format_arg хранит static_cast<unsigned int>(t);
• иначе, если TD является целочисленным типом со знаком, размер которого не превышает long long, то std::basic_format_arg хранит static_cast<long long>(t);
• иначе, если TD представляет собой целочисленный тип без знака, размер которого не превышает unsigned long long, то std::basic_format_arg хранит static_cast<unsigned long long>(t);
• иначе, если TD это float, double или long double, то std::basic_format_arg хранит t;
• иначе, если TD это специализация std::basic_string_view или std::basic_string, а TD::char_type это Context::char_type, то std::basic_format_arg хранит std::basic_string_view<Context::char_type>(t.data(), t.size());
• иначе, если std::decay_t<TD> это Context::char_type* или const Context::char_type*, то std::basic_format_arg хранит static_cast<const Context::char_type*>(t);
• иначе, если std::is_void_v<std::remove_pointer_t<TD>> равно true или std::is_null_pointer_v<TD> равно true, то std::basic_format_arg хранит static_cast<const void*>(t);
• иначе std::basic_format_arg хранит std::basic_format_arg<Context>::handle в t вместе с дополнительными данными, необходимыми для handle::format().

Примечание

Аргумент форматирования имеет ссылочную семантику для пользовательских типов и не продлевает время жизни args. Программист несёт ответственность за то, чтобы args пережил возвращаемое значение. Обычно результат используется только как аргумент функции форматирования.

Пример

Запустить этот код

#include <array>
#include <format>
#include <iostream>
#include <string_view>

void raw_write_to_log(std::string_view users_fmt, std::format_args&& args)
{
    static int n{};
    std::clog << std::format("{:04} : ", n++) << std::vformat(users_fmt, args) << '\n';
}

template <typename... Args>
constexpr void log(Args&&... args)
{
    // Создаёт строку форматирования "{} "...
    std::array<char, sizeof...(Args) * 3 + 1> braces{};
    constexpr const char c[4] = "{} ";
    for (auto i{0uz}; i != braces.size() - 1; ++i)
        braces[i] = c[i % 3];
    braces.back() = '\0';

    raw_write_to_log(std::string_view{braces.data()}, std::make_format_args(args...));
}

int main()
{
    log("Количество", "аргументов", "произвольно.");
    log("Любой тип, соответствующий требованиям BasicFormatter,", "можно распечатать.");
    log("Например:", 1, 2.0, '3', "*42*");

    raw_write_to_log("{:02} │ {} │ {} │ {}", std::make_format_args(1, 2.0, '3', "4"));
}

Вывод:

0000 : Количество аргументов произвольно.
0001 : Любой тип, соответствующий требованиям BasicFormatter, можно распечатать.
0002 : Например: 1 2.0 3 *42*
0003 : 01 │ 2.0 │ 3 │ 4

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
WG не указан	C++20	объекты, которые не являются ни константными, ни копируемыми (например, объекты, подобные генераторам), не форматируются	форматирование этих объектов разрешено
LWG 3631	c++20	cv-квалифицированные аргументы неправильно обрабатывались после P2418R2	обработка исправлена

Смотрите также

basic_format_argsformat_argswformat_args (C++20)(C++20)(C++20)	класс, который обеспечивает доступ ко всем аргументам форматирования (шаблон класса)
vformat (C++20)	нешаблонный вариант std::format с использованием представления аргументов с удалением типа (функция)
vformat_to (C++20)	нешаблонный вариант std::format_to с использованием представления аргументов с удалением типа (шаблон функции)