CKTIS / C++
std::format_error — exception d’erreur de formatage
std::format_error, déclaré dans <format>, signale les erreurs de la bibliothèque de formatage. Découvrez la différence entre une exception à l’exécution et le rejet à la compilation d’une chaîne de format invalide, ainsi que la manière d’intercepter cette exception en toute sécurité.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <format>
// C++23 constructor signatures:
// std::format_error publicly derives from std::runtime_error.
explicit format_error(const std::string& what_arg);
explicit format_error(const char* what_arg);
// Catch by const reference:
catch (const std::format_error& e) { /* handle formatting error */ }std::format_error est une classe d’exception déclarée dans <format> qui dérive publiquement de std::runtime_error. Elle signale les erreurs de la bibliothèque de formatage. Interceptez-la par const std::format_error& pour éviter de copier l’objet et conserver l’accès à son message de diagnostic via what().
Ses deux constructeurs explicites acceptent const std::string& ou const char*. Pour une exception que vous construisez vous-même, what() renvoie un texte correspondant à la chaîne terminée par un caractère nul fournie. Toutefois, ne supposez pas que les exceptions générées par la bibliothèque utilisent un message de diagnostic particulier ; l’exemple affiche son propre message fixe.
En C++23, un littéral invalide transmis à std::format, par exemple std::format("{:d}", "hello"), provoque une erreur de compilation plutôt qu’une exception interceptable. Utilisez std::vformat avec std::make_format_args pour un modèle disponible à l’exécution. Dans l’exemple, {:d} exige un entier, mais l’argument est une chaîne de caractères : une exception std::format_error est donc levée. L’argument value reste valide pendant tout l’appel.
Toutes les exceptions liées au formatage ne sont pas des std::format_error : les exceptions provenant des formateurs et des itérateurs sont propagées, tandis que les erreurs d’allocation sont signalées séparément. Le projet de norme cité évolue et présente également des changements postérieurs à C++23 ; la syntaxe indiquée ne marque pas les constructeurs constexpr. Un indicateur de compilation C++23 dans le dépôt ne garantit pas la prise en charge de la bibliothèque dans l’environnement de production.
Exemples
#include <format>
#include <iostream>
#include <string>
int main() {
std::string pattern = "{:d}";
std::string value = "hello";
try {
std::cout << std::vformat(pattern, std::make_format_args(value)) << '\n';
} catch (const std::format_error&) {
std::cout << "format_error caught\n";
return 0;
}
return 1;
}
Résultat
format_error caught
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.