WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::format_error — Ausnahme bei Formatierungsfehlern

std::format_error aus <format> meldet Fehler der Formatierungsbibliothek. Erfahre, worin sich eine Laufzeitausnahme von der Ablehnung eines ungültigen Formatstrings zur Kompilierzeit unterscheidet und wie du diese Ausnahme sicher abfängst.

Version: 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 ist eine in <format> deklarierte Ausnahmeklasse, die öffentlich von std::runtime_error abgeleitet ist. Sie meldet Fehler der Formatierungsbibliothek. Fange sie als const std::format_error& ab, um das Objekt nicht zu kopieren und über what() weiterhin auf die Diagnosemeldung zugreifen zu können.

Ihre beiden expliziten Konstruktoren akzeptieren const std::string& oder const char*. Bei einer selbst erstellten Ausnahme gibt what() Text zurück, der der übergebenen nullterminierten Zeichenfolge entspricht. Gehe jedoch nicht von einem bestimmten Wortlaut der Diagnosemeldungen aus, die von der Bibliothek erzeugt werden; das Beispiel gibt eine eigene feste Meldung aus.

In C++23 führt ein ungültiges Literal, das an std::format übergeben wird, etwa std::format("{:d}", "hello"), zu einem Kompilierungsfehler und nicht zu einer abfangbaren Ausnahme. Verwende std::vformat mit std::make_format_args für ein Formatmuster, das erst zur Laufzeit vorliegt. Im Beispiel erfordert {:d} eine Ganzzahl, das Argument ist jedoch eine Zeichenfolge, sodass std::format_error ausgelöst wird. Das Argument value bleibt während des gesamten Aufrufs gültig.

Nicht jede Formatierungsausnahme ist eine std::format_error: Ausnahmen von Formatierern und Iteratoren werden weitergegeben, während Speicherreservierungsfehler separat gemeldet werden. Der zitierte Arbeitsentwurf wird weiterentwickelt und zeigt auch Änderungen nach C++23; die angegebene Syntax kennzeichnet die Konstruktoren nicht als constexpr. Ein C++23-Compiler-Flag im Repository belegt nicht, dass die Bibliothek in der Produktionsumgebung unterstützt wird.

Beispiele

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

Ergebnis

format_error caught

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen