std:: format

Formate args selon la chaîne de format fmt , et retourne le résultat sous forme de chaîne. S'il est présent, loc est utilisé pour le formatage spécifique aux paramètres régionaux.

La chaîne de format fmt est vérifiée à la compilation sauf si elle est initialisée à partir du résultat de std::runtime_format (depuis C++26) . Si, à la compilation, la chaîne de format est jugée invalide pour les types des arguments à formater, une erreur de compilation sera générée.

Les exigences suivantes s'appliquent à chaque type T dans Args , où CharT est char pour les surcharges (1,3) , wchar_t pour les surcharges (2,4) :

• std:: formatter < T, CharT > doit satisfaire BasicFormatter
• std:: formatter < T, CharT > :: parse ( ) doit être constexpr à des fins de vérification de chaîne de format à la compilation.

Paramètres

Valeur de retour

Un objet chaîne contenant le résultat formaté.

Exceptions

Lève std::bad_alloc en cas d'échec d'allocation. Propage également toute exception levée par un formateur.

Notes

Il n'est pas une erreur de fournir plus d'arguments que ce que la chaîne de format requiert :

std::format("{} {}!", "Hello", "world", "something"); // OK, produit "Hello world!"

C'est une erreur si la chaîne de format n'est pas une expression constante sauf si elle est initialisée à partir du résultat de std::runtime_format (depuis C++26) . std::vformat n'a pas cette exigence.

std::string f1(std::string_view runtime_format_string)
{
    // return std::format(runtime_format_string, "x", 42); // erreur
    char v1[] = "x";
    int v2 = 42;
    return std::vformat(runtime_format_string, std::make_format_args(v1, v2)); // OK
}
std::string f2(std::string_view runtime_format_string)
{
    return std::format(std::runtime_format(runtime_format_string), "x", 42); // OK (C++26)
}

Exemple

#include <format>
#include <iostream>
#include <set>
#include <string>
#include <string_view>
template<typename... Args>
std::string dyna_print(std::string_view rt_fmt_str, Args&&... args)
{
    return std::vformat(rt_fmt_str, std::make_format_args(args...));
}
int main()
{
#ifdef __cpp_lib_format_ranges
        const std::set<std::string_view> continents 
        {
            "Africa",   "America",      "Antarctica",   
            "Asia",     "Australia",    "Europe"
        };
        std::cout << std::format("Hello {}!\n", continents);
#else
        std::cout << std::format("Hello {}!\n", "continents");
#endif
    std::string fmt;
    for (int i{}; i != 3; ++i)
    {
        fmt += "{} "; // construit la chaîne de formatage
        std::cout << fmt << " : ";
        std::cout << dyna_print(fmt, "alpha", 'Z', 3.14, "unused");
        std::cout << '\n';
    }
}

Hello {"Africa", "America", "Antarctica", "Asia", "Australia", "Europe"}!
{}  : alpha
{} {}  : alpha Z
{} {} {}  : alpha Z 3.14

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi