std::make_format_args, std::make_wformat_args

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de servicios

Apoyo del lenguaje Apoyo de tipos (tipos básicos, RTTI) Biblioteca de macros de prueba de característica (C++20) Servicios del programa Apoyo de corrutinas (C++20) Funciones variádicas is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Comparación de tres vías 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_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Servicios generales Objetos función Manipulación de bits (C++20) bitset hash (C++11) Operadores relacionales (en desuso en C++20) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Funciones de comparación de enteros 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) Intercambio y operaciones de tipos 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) Tipos vocabulario comunes 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)

 

Biblioteca de formato

Funciones de formato

format (C++20)

format_to (C++20)

format_to_n (C++20)

formatted_size (C++20)

vformat (C++20)

vformat_to (C++20)

Formateador

formatter (C++20)

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)

Argumentos de formato

basic_format_arg (C++20)

basic_format_argsformat_argswformat_argsformat_args_t (C++20)(C++20)(C++20)(C++20)

visit_format_arg (C++20)

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

Error de formato

format_error (C++20)

 

<tbody> </tbody>

Definido en el archivo de encabezado <format>
template<class Context = std::format_context, class... Args> /*format-arg-store*/<Context, Args...> make_format_args(const Args&... args);	(1)	(desde C++20)
template<class... Args> /*format-arg-store*/<std::wformat_context, Args...> make_wformat_args(const Args&... args);	(2)	(desde C++20)

See More

Devuelve un objeto que almacena un array de argumentos de formato y que puede convertirse implícitamente a std::basic_format_args.

El comportamiento no está definido si typename Context::template formatter_type<Ti> no cumple con los requisitos de Formatter para cualquier Ti en Args.

Parámetros

args...

-

Los valores a usar como argumentos de formato.

Valor de retorno

Un objeto que alberga los argumentos de formato.

Notas

Un argumento de formato tiene semántica de referencia para tipos definidos por el usuario y no extiende el tiempo de vida de args. Es la responsabilidad del programador asegurarse de que args viva más allá del valor de retorno. Generalmente, el resultado solo se usa como un argumento para una función de formato.

Ejemplo

Ejecuta este código

#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) {

    // Generar cadena de formato "{} "...
    std::array<char, sizeof...(Args) * 3 + 1> braces{};
    constexpr const char c[4] = "{} ";
    for (auto i{0u}; 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("El número", "de", "argumentos", "es", "arbitrario.");
    log("Cualquier tipo que cumpla los requisitos de `Formatter`", "puede imprimirse.");
    log("Por ejemplo:", 1, 2.0, '3', "*42*");

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

Salida:

0000 : El número de argumentos es arbitrario. 
0001 : Cualquier tipo que cumpla los requisitos de `Formatter` puede imprimirse. 
0002 : Por ejemplo: 1 2.0 3 *42* 
0003 : 01 │ 2.0 │ 3 │ 4

Véase también

basic_format_argsformat_argswformat_argsformat_args_t (C++20)(C++20)(C++20)(C++20)	Clase que proporciona acceso a todos los argumentos de formato. (plantilla de clase)
vformat (C++20)	Variante de no plantilla de std::format utilizando una representación de argumento de tipo borrado. (función)
vformat_to (C++20)	Variante de no plantilla de std::format_to utilizando una representación de argumento de tipo borrado. (plantilla de función)