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}