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

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.

Sources