Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::format : formatage typé dans une nouvelle chaîne

std::format crée un nouveau std::string à partir d’un motif vérifié et de ses arguments.

Version : C++23

Syntaxe

template<class... Args>
std::string std::format(std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(std::wformat_string<Args...> fmt, Args&&... args);

template<class... Args>
std::string std::format(const std::locale& loc,
    std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(const std::locale& loc,
    std::wformat_string<Args...> fmt, Args&&... args);

std::format(fmt, args...) de <format> renvoie un nouveau std::string dont les champs de remplacement contiennent les représentations des arguments ; la variante à caractères larges renvoie std::wstring, et d’autres surcharges acceptent std::locale. En C++23, un appel ordinaire utilise format_string<Args...>, dont le littéral est vérifié à la compilation selon le nombre et les types des arguments.

L’exemple formate 7 en 0007, 3.5 avec deux chiffres fractionnaires et des doubles accolades en texte littéral, puis affiche 0007 3.50 {ok}. {} sélectionne l’argument suivant ; la partie après : contrôle notamment alignement, largeur, précision et type de présentation. std::format renvoie une chaîne distincte ; std::format_to écrit via un itérateur de sortie.

Écrivez les accolades littérales {{ et }} ; ne mélangez pas la numérotation automatique {} et manuelle {0}. Un littéral invalide ou un spécificateur incompatible rend normalement l’appel mal formé à la compilation. Pour un motif connu seulement à l’exécution, utilisez std::vformat. std::format lui-même peut aussi lancer std::format_error pour une erreur dépendant des valeurs détectée à l’exécution, telle qu’une largeur ou précision dynamique invalide ; les exceptions des opérations de formatter se propagent et l’allocation peut lancer std::bad_alloc. Un type utilisateur exige une spécialisation valide de std::formatter; le formatage régional passe par la surcharge std::locale et les options adaptées.

Exemples

#include <format>
#include <iostream>

int main() {
    std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}

Résultat

0007 3.50 {ok}

std::format → 0007 3.50 {ok}

Sources