KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::format_error — uitzondering voor formatteringsfouten

std::format_error, gedeclareerd in <format>, meldt fouten van de formatteringsbibliotheek. Leer het verschil tussen een runtime-uitzondering en afwijzing tijdens het compileren van een ongeldige formatteertekenreeks, en hoe je deze uitzondering veilig opvangt.

Versie: C++23; repository compiler flag, production runtime not attested

Syntax

#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 is een uitzonderingsklasse die in <format> is gedeclareerd en publiekelijk is afgeleid van std::runtime_error. De klasse meldt fouten van de formatteringsbibliotheek. Vang haar op als const std::format_error& om het object niet te kopiëren en via what() toegang tot het diagnostische bericht te houden.

De twee expliciete constructors accepteren const std::string& of const char*. Voor een uitzondering die je zelf maakt, retourneert what() tekst die overeenkomt met de opgegeven, nulbeëindigde tekenreeks. Ga echter niet uit van een bepaalde formulering van diagnostische berichten voor uitzonderingen die door de bibliotheek worden gegenereerd; het voorbeeld drukt een eigen, vast bericht af.

In C++23 veroorzaakt een ongeldig literal dat aan std::format wordt doorgegeven, zoals std::format("{:d}", "hello"), een compilatiefout in plaats van een opvangbare uitzondering. Gebruik std::vformat met std::make_format_args voor een patroon dat pas tijdens runtime beschikbaar is. In het voorbeeld vereist {:d} een geheel getal, maar is het argument een tekenreeks, waardoor std::format_error wordt opgeworpen. Het argument value blijft gedurende de hele aanroep geldig.

Niet elke formatteringsuitzondering is een std::format_error: uitzonderingen van formatters en iterators worden doorgegeven, terwijl toewijzingsfouten afzonderlijk worden gemeld. Het aangehaalde werkdocument wordt bijgewerkt en toont ook wijzigingen van na C++23; de opgegeven syntax markeert de constructors niet als constexpr. Een C++23-compileroptie in de repository bewijst niet dat de bibliotheek in de productieomgeving wordt ondersteund.

Voorbeelden

#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;
}

Resultaat

format_error caught

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen